io.github.andrewszk/clawvault-mcp-server
AI agent payment security - spending limits, whitelists, and human approval.
Ask AI about io.github.andrewszk/clawvault-mcp-server
Powered by Claude · Grounded in docs
I know everything about io.github.andrewszk/clawvault-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
clawvault-mcp-server
MCP (Model Context Protocol) server for ClawVault - AI agent payment security layer.
Installation
npm install -g clawvault-mcp-server
Or use directly with npx (no install needed):
npx clawvault-mcp-server
Usage with Claude Desktop
Add to your Claude Desktop config:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"clawvault": {
"command": "npx",
"args": ["clawvault-mcp-server"],
"env": {
"CLAWVAULT_API_KEY": "cv_live_your_api_key_here"
}
}
}
}
Restart Claude Desktop after saving.
Getting Your API Key
- Go to clawvault.cc and sign up
- Navigate to the Agents page
- Create a new agent or use an existing one
- Copy the API key (format:
cv_live_...)
Available Tools
Once connected, Claude has access to these tools:
request_payment
Request a payment through ClawVault. The payment will be evaluated against your security rules.
Amount: "10.00"
Token: "USDC"
Recipient: "0x..."
Chain: "base"
Reason: "API credits" (optional)
check_limits
Check if a payment would be allowed before making it. Returns whether it would auto-approve or need manual approval.
get_payment_status
Check the status of a pending payment by ID.
list_transactions
List recent payment transactions with pagination.
get_vault
Get vault status including wallet address, balances, and current spending limits.
freeze_agent
Emergency freeze an agent to block all its payment requests.
How It Works
- You ask Claude to pay for something
- Claude uses
request_paymenttool - ClawVault checks your rules:
- Within rules → auto-approved, payment executes
- Outside rules → pending, you get a Telegram/dashboard notification
- You approve or deny from Telegram or the web dashboard
- Claude gets the result
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
CLAWVAULT_API_KEY | Yes | - | Your ClawVault API key |
CLAWVAULT_API_URL | No | https://api.clawvault.cc | API base URL |
For Other AI Agents
Not using Claude Desktop? Any AI agent can use ClawVault by reading the skill documentation:
https://api.clawvault.cc/skill
This returns plain text that teaches the agent how to use the ClawVault API.
Development
# Clone the repo
git clone https://github.com/clawvault/mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run locally
CLAWVAULT_API_KEY=cv_live_xxx npm start
Links
- Website: clawvault.cc
- Docs: clawvault.cc/docs
- API: api.clawvault.cc
- Skill docs: api.clawvault.cc/skill
License
MIT
