MCP Protocol

ClawFi implements the Model Context Protocol (MCP) to enable AI agents to interact with banking services.

Overview

The MCP protocol allows AI assistants to:

• Query account balances and transaction history

• Initiate transfers with proper authorization

• Create and manage vaults

• Issue cards and control spending limits

Protocol Specification

Server Information

{
  "name": "clawFi",
  "version": "1.0.0",
  "protocol_version": "2026-02-05"
}

Available Tools

get_balance

Retrieve current balance for a vault.

{
  "name": "get_balance",
  "description": "Get the current balance of a vault",
  "inputSchema": {
    "type": "object",
    "properties": {
      "vault_id": {
        "type": "string",
        "description": "The ID of the vault"
      }
    },
    "required": ["vault_id"]
  }
}

create_transfer

Initiate a transfer between vaults or to external accounts.

{
  "name": "create_transfer",
  "description": "Create a transfer between accounts",
  "inputSchema": {
    "type": "object",
    "properties": {
      "from_vault_id": {"type": "string"},
      "to_vault_id": {"type": "string"},
      "amount": {"type": "number"},
      "currency": {"type": "string"},
      "description": {"type": "string"}
    },
    "required": ["from_vault_id", "to_vault_id", "amount", "currency"]
  }
}

Authorization Flow

All MCP requests go through the authorization engine:

1. AI agent calls MCP tool

2. Authorization engine evaluates request against policies

3. If approved, transaction executes

4. Result returned to agent

Security Considerations

• Each MCP session has scoped permissions

• High-value transactions require human approval

• All operations are logged and auditable

• Rate limiting prevents abuse

Example Integration

import { MCPClient } from '@modelcontextprotocol/sdk';

const mcp = new MCPClient({
  serverUrl: 'https://mcp.useclawfi.com',
  apiKey: process.env.CLAWFI_API_KEY
});

// Check balance
const balance = await mcp.callTool('get_balance', {
  vault_id: 'vault_123'
});

console.log('Current balance:', balance);

Resources

MCP also provides read-only resources:

• vault://vault_id - Vault details

• transaction://transaction_id - Transaction details

• card://card_id - Card information