English Français العربية

io.github.andrewszk/clawvault-mcp-server

Official registry Finance and payments

AI agent payment security - spending limits, whitelists, and human approval.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package clawvault-mcp-server
Claude Code 
claude mcp add clawvault-mcp-server -e 'CLAWVAULT_API_KEY=<your clawvault_api_key>' -- npx -y clawvault-mcp-server@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "clawvault-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "clawvault-mcp-server@0.1.1"
            ],
            "env": {
                "CLAWVAULT_API_KEY": "<your clawvault_api_key>"
            }
        }
    }
}

Environment variables

  • CLAWVAULT_API_KEY required secret Your ClawVault API key from the dashboard

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. clawvault-mcp-server
  2. Installation
  3. Usage with Claude Desktop
  4. Getting Your API Key
  5. Available Tools
  6. How It Works
  7. Environment Variables
  8. For Other AI Agents
  9. Development
  10. Links
  11. License

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

  1. Go to 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

VariableRequiredDefaultDescription
CLAWVAULT_API_KEYYes-Your ClawVault API key
CLAWVAULT_API_URLNohttps://api.clawvault.ccAPI 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

License

MIT

Frequently asked questions

What is io.github.andrewszk/clawvault-mcp-server?

AI agent payment security - spending limits, whitelists, and human approval.

How do I install io.github.andrewszk/clawvault-mcp-server?

It runs on your machine. In Claude Code: claude mcp add clawvault-mcp-server -e 'CLAWVAULT_API_KEY=<your clawvault_api_key>' -- npx -y clawvault-mcp-server@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.andrewszk/clawvault-mcp-server need an API key?

Yes. It expects CLAWVAULT_API_KEY, which you set in its configuration.

Is io.github.andrewszk/clawvault-mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.andrewszk/clawvault-mcp-server?

It is published by andrewszk. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.