MCP tool reference
Every tool exposed by the Soren Pay MCP server. Schemas mirror the JSON
Schema the server advertises via tools/list.
get_treasury
read:treasury
Workspace treasury snapshot: fiat balance, stablecoin balance, total, MTD spend.
Input: {}
Output: text summary + JSON payload with fiatUsdCents, stablecoinUsdCents,
totalUsdCents, monthSpendUsdCents.
get_recent_activity
read:treasury
Recent ledger entries — every credit + debit.
Input:
{
"limit": 25 // 1-200, default 25
}list_cards
read:cards
List virtual + physical cards, optionally filter by state.
Input:
{
"state": "active", // active | frozen | shipping | terminated (optional)
"limit": 25
}list_agents
read:agents
Agent identities with Ed25519 fingerprints, protocols, status.
Input: {}
list_checkout_sessions
read:checkout
Merchant checkout sessions, optionally filter by status.
Input:
{
"status": "completed", // pending | awaiting_payment | confirming | completed | expired | underpaid | failed
"limit": 25
}Coming in v0.2 (write tools)
These need the agent-side confirmation flow to land in major MCP clients first.
| Tool | Scope | What |
|---|---|---|
| mint_card | write:cards | Issue a scoped Visa card |
| submit_intent | write:agents | Sign + submit a payment intent |
| create_checkout_session | write:checkout | Open a merchant checkout |
| originate_intl_payment | write:payments | Cross-border payment |