English Français العربية

io.github.andrewszk/clawvault-mcp-server

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • CLAWVAULT_API_KEY إلزامي سري Your ClawVault API key from the dashboard

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.andrewszk/clawvault-mcp-server؟

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

كيف أثبّت io.github.andrewszk/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.andrewszk/clawvault-mcp-server إلى مفتاح API؟

نعم. يتطلب CLAWVAULT_API_KEY، وتضبطها في إعداداته.

هل io.github.andrewszk/clawvault-mcp-server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.andrewszk/clawvault-mcp-server؟

ينشره andrewszk. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.