io.github.andrewszk/clawvault-mcp-server
AI agent payment security - spending limits, whitelists, and human approval.
Open source Open in the app JSON README (API)
About
AI agent payment security - spending limits, whitelists, and human approval.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- andrewszk
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-03-06T07:15:59Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:02:25
- Updated
- 2026-08-29 03:02:25
- Origin id
io.github.andrewszk/clawvault-mcp-server
README
# clawvault-mcp-server
MCP (Model Context Protocol) server for ClawVault - AI agent payment security layer.
## Installation
```bash
npm install -g clawvault-mcp-server
```
Or use directly with npx (no install needed):
```bash
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`
```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
1. Go to [clawvault.cc](https://clawvault.cc) and sign up
2. Navigate to the Agents page
3. Create a new agent or use an existing one
4. 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
1. You ask Claude to pay for something
2. Claude uses `request_payment` tool
3. ClawVault checks your rules:
- **Within rules** → auto-approved, payment executes
- **Outside rules** → pending, you get a Telegram/dashboard notification
4. You approve or deny from Telegram or the web dashboard
5. 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
```bash
# 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](https://clawvault.cc)
- Docs: [clawvault.cc/docs](https://clawvault.cc/docs)
- API: [api.clawvault.cc](https://api.clawvault.cc)
- Skill docs: [api.clawvault.cc/skill](https://api.clawvault.cc/skill)
## License
MIT