Wire Soren Pay into Claude Desktop in 60 seconds

Add 8 lines of JSON to your Claude Desktop config. Claude immediately has tools to inspect your Soren Pay workspace — treasury balance, cards, agents, checkout sessions, activity.

60-second setup

1. Get your apk_ key

sorenpay.com → Sign in → Developers → API keys → create a key with read:* scopes.

2. Edit Claude Desktop config

macOS:

open "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows:

notepad "%APPDATA%\Claude\claude_desktop_config.json"

3. Paste this

claude_desktop_config.jsonjson

{
"mcpServers": {
  "soren-pay": {
    "command": "npx",
    "args": [
      "-y", "@sorenpay/mcp-bridge",
      "--api-key", "apk_PASTE_YOURS_HERE",
      "--base-url", "https://sorenpay.com"
    ]
  }
}
}

4. Restart Claude Desktop

That's it. Claude now has the Soren Pay tools.

What Claude can do

Ask Claude any of these:

"What's my current treasury balance?"

Claude calls get_treasury → shows fiat + stablecoin + total + MTD spend.

"Show me my recent ledger activity."

Claude calls get_recent_activity with limit: 25 → tabular view.

"How many active cards do I have? Anything frozen?"

Claude calls list_cards, filters, summarizes.

"Show me every agent I've registered and what protocols they support."

Claude calls list_agents → full identity table.

"Are there any pending checkout sessions?"

Claude calls list_checkout_sessions with status: "awaiting_payment".

Security model

The apk_ key gives Claude exactly what the key's scopes allow. Use a read:*-only key so Claude can observe but not move money.
Every call Claude makes is logged in your Activity feed.
Rate-limited to 100 calls/min per key (default).
Write tools (mint_card, submit_intent, etc.) ship in v0.2 with an explicit user-confirm step in Claude's UI.

Cursor + Windsurf

Same idea, different config. Modern Cursor + Windsurf support HTTP MCP servers natively:

Cursor settings.jsonjson

{
"mcp.servers": {
  "soren-pay": {
    "url": "https://sorenpay.com/api/mcp",
    "headers": {
      "Authorization": "Bearer apk_PASTE_YOURS_HERE"
    }
  }
}
}

← All docs Edit on GitHub →