@stablefi/mcp-server

MCP (Model Context Protocol) server for StableFi. Lets AI assistants like Claude, Cursor, and Windsurf interact with AgentPassport and AgentPay — register agents, check trust scores, create wallets, send payments, and more.

Install

npx @stablefi/mcp-server

Or install globally:

npm install -g @stablefi/mcp-server
stablefi-mcp

Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "stablefi": {
      "command": "npx",
      "args": ["-y", "@stablefi/mcp-server"],
      "env": {
        "STABLEFI_API_URL": "https://stablefi.ai"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "stablefi": {
      "command": "npx",
      "args": ["-y", "@stablefi/mcp-server"],
      "env": {
        "STABLEFI_API_URL": "https://stablefi.ai"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "stablefi": {
      "command": "npx",
      "args": ["-y", "@stablefi/mcp-server"],
      "env": {
        "STABLEFI_API_URL": "https://stablefi.ai"
      }
    }
  }
}

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | STABLEFI_API_URL | https://stablefi.ai | StableFi API base URL |

Tools

AgentPassport (Identity & Trust)

stablefi_register_agent

Register a new AI agent on StableFi.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | name | string | Yes | Display name of the agent | | ownerEmail | string | Yes | Owner's email address | | capabilities | string[] | No | Agent capabilities, e.g. ["research", "coding"] |

Returns: agentId, trustScore, agentSecret

stablefi_check_trust_score

Look up any agent's TrustScore (0-1000).

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | agentId | string | Yes | StableFi agent ID |

Returns: trustScore, tier, grade, factors breakdown

stablefi_verify_agent

Verify an agent's identity for a specific transaction.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | agentId | string | Yes | Agent ID to verify | | merchantId | string | Yes | Merchant or verifier ID | | amountCents | number | Yes | Transaction amount in cents |

Returns: verified, trustScore, riskLevel

stablefi_search_registry

Search the public agent registry.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | No | Search query | | category | string | No | Filter by category |

Returns: List of agents with IDs and scores

AgentPay (Wallets & Payments)

stablefi_create_wallet

Create a USDC wallet on Base for an agent.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | agentId | string | Yes | Agent ID to create wallet for |

Returns: walletId, address, network

stablefi_check_balance

Check wallet balance.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | agentId | string | No | Agent ID (provide this or walletAddress) | | walletAddress | string | No | Wallet address |

Returns: balanceUsdc, balanceEth

stablefi_request_payment

Request payment from another agent or human.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | fromAgentId | string | Yes | Your agent ID (payee) | | toAgentId | string | No | Agent to request from | | toEmail | string | No | Email to request from | | amount | string | Yes | Amount in USDC | | currency | string | No | Currency (default: USDC) | | description | string | Yes | What the payment is for |

Returns: paymentId, paymentUrl, status

stablefi_send_payment

Send USDC to another agent or address. Transactions over $500 require human approval.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | agentId | string | Yes | Your agent ID (sender) | | agentSecret | string | Yes | Your agent secret | | toAddress | string | Yes | Recipient address or agent ID | | amount | string | Yes | Amount in USDC | | description | string | No | Payment description |

Returns: txHash, status

stablefi_create_payment_link

Generate a payment link anyone can use to pay you.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | merchantId | string | Yes | Your agent or merchant ID | | amount | string | Yes | Amount in USDC | | description | string | Yes | What the payment is for | | orderId | string | No | Optional order/invoice ID |

Returns: linkId, paymentUrl

Example Conversations

Register an agent

You: Register my agent called DataBot with email [email protected] and capabilities research and analysis

Claude: I'll register your agent on StableFi.

calls stablefi_register_agent

Your agent has been registered:

• Agent ID: agt_7f3a8b2e1234abcd
• Trust Score: 50 (Unverified tier)
• Agent Secret: sfs_a1b2c3... (save this — it won't be shown again)

Check trust and create a wallet

You: What's the trust score for agt_7f3a8b2e? And create a wallet for it.

Claude: Let me check the trust score and create a wallet.

calls stablefi_check_trust_score and stablefi_create_wallet

Trust Score: 175/1000 (Bronze tier, grade C)

• Identity: 125/250 (Basic verified)
• Transactions: 0/250 (No history yet)

Wallet Created:

• Address: 0x1a2b3c...
• Network: Base Mainnet
• Balance: 0.000000 USDC

Send a payment

You: Send $50 USDC to agent agt_yyy for API access

Claude: I'll send the payment now.

calls stablefi_send_payment

Payment sent:

• Amount: 50.00 USDC
• To: agt_yyy
• Tx Hash: 0xabc123...
• Status: confirmed

Request payment

You: Request $100 from agent agt_zzz for the research report

Claude: I'll create a payment request.

calls stablefi_request_payment

Payment requested:

• Amount: 100.00 USDC
• Payment Link: https://stablefi.ai/pay/req_abc123
• Status: pending
• Expires: in 24 hours

Generate a payment link

You: Generate a payment link for $29.99 for Premium API Access

Claude: Creating your payment link.

calls stablefi_create_payment_link

Payment link created:

• URL: https://stablefi.ai/pay/lnk_xyz789
• Amount: 29.99 USDC
• Share this link with anyone to collect payment.

License

MIT