{
  "markdown": "# clawvault-mcp-server\n\nMCP (Model Context Protocol) server for ClawVault - AI agent payment security layer.\n\n## Installation\n\n```bash\nnpm install -g clawvault-mcp-server\n```\n\nOr use directly with npx (no install needed):\n\n```bash\nnpx clawvault-mcp-server\n```\n\n## Usage with Claude Desktop\n\nAdd to your Claude Desktop config:\n\n**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"clawvault\": {\n      \"command\": \"npx\",\n      \"args\": [\"clawvault-mcp-server\"],\n      \"env\": {\n        \"CLAWVAULT_API_KEY\": \"cv_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n## Getting Your API Key\n\n1. Go to [clawvault.cc](https://clawvault.cc) and sign up\n2. Navigate to the Agents page\n3. Create a new agent or use an existing one\n4. Copy the API key (format: `cv_live_...`)\n\n## Available Tools\n\nOnce connected, Claude has access to these tools:\n\n### request_payment\nRequest a payment through ClawVault. The payment will be evaluated against your security rules.\n\n```\nAmount: \"10.00\"\nToken: \"USDC\"\nRecipient: \"0x...\"\nChain: \"base\"\nReason: \"API credits\" (optional)\n```\n\n### check_limits\nCheck if a payment would be allowed before making it. Returns whether it would auto-approve or need manual approval.\n\n### get_payment_status\nCheck the status of a pending payment by ID.\n\n### list_transactions\nList recent payment transactions with pagination.\n\n### get_vault\nGet vault status including wallet address, balances, and current spending limits.\n\n### freeze_agent\nEmergency freeze an agent to block all its payment requests.\n\n## How It Works\n\n1. You ask Claude to pay for something\n2. Claude uses `request_payment` tool\n3. ClawVault checks your rules:\n   - **Within rules** → auto-approved, payment executes\n   - **Outside rules** → pending, you get a Telegram/dashboard notification\n4. You approve or deny from Telegram or the web dashboard\n5. Claude gets the result\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `CLAWVAULT_API_KEY` | Yes | - | Your ClawVault API key |\n| `CLAWVAULT_API_URL` | No | `https://api.clawvault.cc` | API base URL |\n\n## For Other AI Agents\n\nNot using Claude Desktop? Any AI agent can use ClawVault by reading the skill documentation:\n\n```\nhttps://api.clawvault.cc/skill\n```\n\nThis returns plain text that teaches the agent how to use the ClawVault API.\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/clawvault/mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally\nCLAWVAULT_API_KEY=cv_live_xxx npm start\n```\n\n## Links\n\n- Website: [clawvault.cc](https://clawvault.cc)\n- Docs: [clawvault.cc/docs](https://clawvault.cc/docs)\n- API: [api.clawvault.cc](https://api.clawvault.cc)\n- Skill docs: [api.clawvault.cc/skill](https://api.clawvault.cc/skill)\n\n## License\n\nMIT\n",
  "bytes": 2955,
  "sha": "bf9675b6a591a41a94f086076b24a3f17dac2cc224c62b3193618cd46635a73a",
  "repo_slug": "andrewszk/clawvault-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_andrewszk_clawvault_mcp_server_a3474864/readme"
}