@furlpay/mcp-server

@furlpay/mcp-server

Model Context Protocol server exposing Furlpay tools to AI assistants — let Claude, Cursor, and any MCP client check balances, quote swaps, place orders, and run compliance checks against your Furlpay account.

Self-contained: stdio transport, JSON-RPC 2.0, zero dependencies, no SDK required.

Setup

Claude Desktop / Claude Code

Add to claude_desktop_config.json (or .mcp.json in a Claude Code project):

{
  "mcpServers": {
    "furlpay": {
      "command": "npx",
      "args": ["-y", "@furlpay/mcp-server"],
      "env": {
        "FURLPAY_API_KEY": "sk_sandbox_...",
        "FURLPAY_BASE_URL": "https://api.furlpay.app"
      }
    }
  }
}

Cursor

Settings → MCP → Add server, command: npx -y @furlpay/mcp-server.

Tools

Tool	What it does
get_wallet_balances	Safe smart-account stablecoin balances and active modules
quote_swap	Cheapest cross-chain stablecoin swap route (Li.Fi / 1inch)
place_investment_order	Fractional stock/ETF order (Alpaca) — symbol, side, notional
screen_wallet_risk	AML-screen a wallet address (Chainalysis / TRM), returns a risk verdict
verify_identity	KYC identity check (Persona / Sumsub)

Try it

Ask your assistant:

"What's my Furlpay wallet balance?"

"Quote swapping 100 USDT on Base to USDC."

"Screen wallet 9x… for AML risk before I pay it."

Safety

• Use a sandbox key (sk_sandbox_...) while experimenting — the agent inherits every permission the key has.
• For real funds, pair with bounded allowances (Account Kit escrow) and spend caps — never hand an agent an unlimited key.
• FURLPAY_BASE_URL defaults to http://localhost:3000 for local development; point it at production explicitly.

Related

furlpay-examples/ai-agent-mcp — full agent setup walkthrough · furlpay-x402 — per-request agent payments over HTTP 402.

Security

Report vulnerabilities to [e-mail] — please don't open public issues.

License

MIT