# clawvault-mcp-server

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/andrewszk/clawvault-mcp-server  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/clawvault-mcp-server

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "clawvault-mcp-server": {
    "command": "npx",
    "args": ["-y","clawvault-mcp-server"]
  }
}
```

## Documentation & 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