SorenPay
Join the early-bird list

Wire SorenPay into Claude Desktop in 60 seconds

Add 8 lines of JSON to your Claude Desktop config. Claude immediately has tools to inspect your SorenPay 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", "--base-url", "https://sorenpay.com"],
    "env": { "SOREN_API_KEY": "apk_PASTE_YOURS_HERE" }
  }
}
}

The bridge (@sorenpay/mcp-bridge) isn't published to npm yet, so npx can't download it today. Until it is, ask support@sorenpay.com for a copy and run it with "command": "node" and "args": ["/path/to/mcp-bridge/bin/cli.js", "--base-url", "https://sorenpay.com"], keeping the same env.

4. Restart Claude Desktop

That's it. Claude now has the SorenPay 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
{
"mcpServers": {
  "soren-pay": {
    "url": "https://sorenpay.com/api/mcp",
    "headers": {
      "Authorization": "Bearer apk_PASTE_YOURS_HERE"
    }
  }
}
}

Related

← All docs