clawvault-mcp-server

clawvault-mcp-server

MCP (Model Context Protocol) server for ClawVault - AI agent payment security layer with GOAT SDK integration.

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_...)

Important: Two Solana Wallets

ClawVault uses two separate Solana wallets:

• Main Vault (Crossmint smart wallet) — For crypto payments and token swaps
• Payment Wallet (standalone Solana keypair) — For prediction market trades only

Swaps use the main vault. Predictions use the payment wallet. They must be funded separately. Set up the payment wallet at the /predictions page in your dashboard.

Available Tools (36)

Payments

Tool	Description
request_payment	Request a payment through ClawVault with rules evaluation
check_limits	Check if a payment would be allowed before making it
get_payment_status	Check the status of a pending payment by ID
list_transactions	List recent payment transactions with pagination

Vault

Tool	Description
get_vault	Get vault status — wallet address, balances, spending limits

Agent Management

Tool	Description
freeze_agent	Emergency freeze an agent to block all payment requests

Swaps (via dFlow)

Tool	Description
swap_tokens	Execute token swaps on Solana via dFlow
get_swap_quote	Get a price quote for a swap without executing

Prediction Markets (via dFlow/Kalshi)

Tool	Description
list_prediction_markets	List available Kalshi prediction markets
get_market	Get details for a specific prediction market
buy_prediction	Buy a YES or NO outcome on a prediction market
sell_prediction	Sell (close/reduce) a prediction position
redeem_prediction	Redeem winning tokens on a settled market
get_prediction_positions	View current prediction market positions
get_prediction_wallet	Get payment wallet address and KYC status

Card Operations

Tool	Description
card_purchase	Make a purchase using the agent's card
card_balance	Check agent card balance
card_check	Check if a purchase would be allowed

Rules

Tool	Description
get_rules	Get current security rules and usage stats

Commerce (Agentic Commerce via Crossmint)

Tool	Description
commerce_search	Search for products on Amazon, Shopify, and 300+ stores
commerce_order	Place an order with shipping details and payment
commerce_order_status	Check the status of a commerce order
commerce_list_orders	List past commerce orders with pagination
commerce_tracking	Get delivery tracking info for an order
commerce_refund	Request a refund for an order

Credit (ACE - Agent Credit Engine)

Tool	Description
enable_credit	Register with ACE and enable credit line
disable_credit	Disable credit (keeps registration)
get_credit_status	Check current credit status and active loans
request_credit	Request a USDC credit loan
get_credit_history	List credit transaction history

x402 (API Payments)

Tool	Description
x402_fetch	Fetch a URL that requires x402 payment, auto-paying with USDC

Payment Wallet

Tool	Description
get_payment_wallet_balance	Check payment wallet USDC balance
fund_payment_wallet	Fund payment wallet from main vault
withdraw_payment_wallet	Withdraw from payment wallet to destination

GOAT SDK Integration

Tool	Description
goat_list_actions	List all available GOAT SDK actions (dFlow swaps, SPL transfers, Orca liquidity, ERC-20 token ops)
goat_get_action_rules	Get rules configuration for a GOAT action category
goat_execute_action	Execute a GOAT action with rules engine validation

The GOAT SDK integration gives agents access to 250+ onchain actions across 40+ chains, all gated by ClawVault's rules engine. Live plugins: dFlow (swaps/predictions), SPL Token (transfers), Orca (liquidity), ERC-20 (token ops).

How It Works

• You ask Claude to pay for something
• Claude uses request_payment tool
• 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
• GOAT Integration: clawvault.cc/integrations/goat

License

MIT