mcpField
C
clawvault-mcp-server

clawvault-mcp-server

Local
github.com/andrewszkFinance0Updated 34w ago
Repository

About clawvault-mcp-server

clawvault-mcp-server connects AI agents to ClawVault payment controls. It provides payment requests, spending-rule checks, transaction lookups, and an emergency freeze tool, with human review for requests outside the configured rules.

Key features

  1. 01Request payments
  2. 02Check spending rules
  3. 03Inspect payment status
  4. 04List transactions
  5. 05View vault limits and balances
  6. 06Freeze an agent

Use cases

  1. 01Request an agent payment
  2. 02Check whether a payment needs approval
  3. 03Review a pending payment
  4. 04Block an agent's payment requests

MCP support

The MCP server exposes ClawVault payment and vault operations as tools, using a ClawVault API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "andrewszk-clawvault": {
      "command": "npx",
      "args": [
        "-y",
        "clawvault-mcp-server"
      ],
      "env": {
        "CLAWVAULT_API_KEY": "<CLAWVAULT_API_KEY>"
      }
    }
  }
}
Run commandnpx -y clawvault-mcp-server
Environment variables to set
CLAWVAULT_API_KEYSecretYour ClawVault API key from the dashboard

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmclawvault-mcp-server0.1.1

Tools

6

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
chainstringYesBlockchain network (e.g. 'base', 'ethereum')
tokenstringYesToken symbol (e.g. 'USDC', 'USDT')
amountstringYesPayment amount (e.g. '10.00')
reasonstringNoReason for the payment
recipientstringYesRecipient wallet address

Details

From the project README

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

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.