Hosted MCP server · #12 most used on Smithery
sap-mcp
oobe-protocol/sap-mcp
Use the SAP MCP Wizard or install the library from the npm registry to automatically create and configure a Solana/SAP wallet via https://mcp.sap.oobeprotocol.ai
- Uses
- 34k
- Tools
- 275
- Runs
- Hosted
- Prompts
- 10
- Listed
- 4mo ago
Get started
Add it to your agent
npx -y @smithery/cli@latest install oobe-protocol/sap-mcp --client claudeSwap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.
claude mcp add --transport http sap https://server.smithery.ai/oobe-protocol/sap-mcp/mcpA hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.
[mcp_servers.sap]
url = "https://server.smithery.ai/oobe-protocol/sap-mcp/mcp"Add to ~/.codex/config.toml.
{
"mcpServers": {
"sap": {
"url": "https://server.smithery.ai/oobe-protocol/sap-mcp/mcp"
}
}
}Add to ~/.cursor/mcp.json.
{
"servers": {
"sap": {
"type": "http",
"url": "https://server.smithery.ai/oobe-protocol/sap-mcp/mcp"
}
}
}Add to .vscode/mcp.json.
gemini mcp add --transport http sap https://server.smithery.ai/oobe-protocol/sap-mcp/mcpSaved to .gemini/settings.json.
What it can do
80 of 275 tools
sap_protocol_invariantsFree read-only protocol invariant card for agents. Returns the current SAP program id, protocol treasury, source-level expected 0.1 SOL r…
Free read-only protocol invariant card for agents. Returns the current SAP program id, protocol treasury, source-level expected 0.1 SOL registration fee invariant, hosted write routing rules, local sap_payments routes, identity pipeline, and forbidden actions. Use this before SAP registry writes and whenever fee/treasury behavior is unclear. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and
sap_agent_identity_plan12 paramsFree read-only planner for SAP agent registration, profile/image updates, Metaplex/MPL Core identity linking, SNS linking, x402 pricing m…
Free read-only planner for SAP agent registration, profile/image updates, Metaplex/MPL Core identity linking, SNS linking, x402 pricing metadata, and post-write verification. Use this before sap_payments_register_agent or sap_payments_update_agent so agents know the exact local-signer route, metadata contract, forbidden actions, and protocol fee verification checklist. It does not touch chain and never signs. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return o
| Parameter | Type | Description |
|---|---|---|
name | string | Required public display name for the SAP agent. Keep it stable enough for explorers and humans. |
agentId | string | Optional stable lowercase agent id, for example solking. This is separate from the on-chain agent PDA. |
pricing | array | Optional pricing tiers advertised by the agent. Use tokenType usdc + settlementMode x402 for pay.sh/x402 agent commerce. |
agentUri | string | Optional public HTTPS/IPFS/Arweave/Kommodo URI for the agent profile metadata or profile page. Never use local desktop file paths. |
imageUrl | string | Optional public image URL. This must be HTTPS, IPFS, Arweave, or another public URI; desktop file paths are not valid. |
protocols | array | Required protocol tags the agent supports, for example sap, mcp, jupiter, pyth, metaplex, sns, x402, payments. |
snsDomain | string | Optional .sol domain to link after ownership or registration is verified. |
description | string | Required public description of what the agent does, which protocols it can use, and its safety/trust boundaries. |
metadataUri | string | Alias for agentUri. Prefer a public JSON metadata document containing name, description, image, external_url, attributes, sap, metaplex, sns, and x402 fields. |
ownerWallet | string | Optional expected SAP owner wallet. Use this for verification planning only; signing still comes from the active local SAP profile. |
capabilities | array | Required capability list. Prefer object form for production; strings are accepted as shorthand. |
x402Endpoint | string | Optional public x402 discovery/payment endpoint, usually https://host/.well-known/x402 for external agent services. |
sap_register_agent9 paramsDeprecated raw SDK wrapper. Production registration must use sap_payments_register_agent so the local signer path confirms the account, v…
Deprecated raw SDK wrapper. Production registration must use sap_payments_register_agent so the local signer path confirms the account, verifies the 0.1 SOL protocol treasury fee invariant, and returns protocolComplete. Hosted accountless SAP MCP rejects this direct write before x402 payment. SAP MCP context: Do not use this raw SDK wrapper for production registration. The canonical registration path is sap_payments_register_agent, because it confirms the account, audits the protocol treasury fe
| Parameter | Type | Description |
|---|---|---|
name | string | Required public display name for the SAP agent. Keep it stable enough for explorers and humans. |
agentId | string | Optional stable lowercase agent id, for example solking. This is separate from the on-chain agent PDA. |
pricing | array | Optional pricing tiers advertised by the agent. Use tokenType usdc + settlementMode x402 for pay.sh/x402 agent commerce. |
agentUri | string | Optional public HTTPS/IPFS/Arweave/Kommodo URI for the agent profile metadata or profile page. Never use local desktop file paths. |
protocols | array | Required protocol tags the agent supports, for example sap, mcp, jupiter, pyth, metaplex, sns, x402, payments. |
description | string | Required public description of what the agent does, which protocols it can use, and its safety/trust boundaries. |
metadataUri | string | Alias for agentUri. Prefer a public JSON metadata document containing name, description, image, external_url, attributes, sap, metaplex, sns, and x402 fields. |
capabilities | array | Required capability list. Prefer object form for production; strings are accepted as shorthand. |
x402Endpoint | string | Optional public x402 discovery/payment endpoint, usually https://host/.well-known/x402 for external agent services. |
sap_update_agent9 paramsLocal-signer-only: update the connected wallet SAP agent using SDK AgentModule.update. Hosted accountless SAP MCP rejects this direct wri…
Local-signer-only: update the connected wallet SAP agent using SDK AgentModule.update. Hosted accountless SAP MCP rejects this direct write before x402 payment; hosted users should call sap_payments_update_agent from the local sap_payments bridge. SAP MCP context: Use this after sap_register_agent to refresh name, description, capabilities, pricing, supported protocols, x402 endpoint, or metadataUri. For NFT-backed identity changes, update the Metaplex asset first when needed, then point the SAP
| Parameter | Type | Description |
|---|---|---|
name | string | Optional replacement display name. Omit to keep the current name. |
agentId | string | Optional replacement stable agent id. Omit to keep current agentId. |
pricing | array | Optional full replacement pricing tier list. Omit to keep current pricing. |
agentUri | string | Optional replacement public URI for agent metadata/profile. Use this to update pictures after uploading metadata to IPFS, Arweave, Kommodo, or HTTPS. |
protocols | array | Optional full replacement protocol list. Omit to keep current protocols. |
description | string | Optional replacement description. Omit to keep the current description. |
metadataUri | string | Alias for agentUri. Use a public metadata JSON URI; never use a desktop file path. |
capabilities | array | Optional full replacement capability list. Omit to keep current capabilities; do not send only the new item unless replacing the whole list is intended. |
x402Endpoint | string | Optional replacement x402 discovery/payment endpoint. Omit to keep current endpoint. |
sap_deactivate_agentDeactivate the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain…
Deactivate the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
sap_reactivate_agentReactivate the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain…
Reactivate the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
sap_close_agentClose the connected wallet SAP agent and reclaim rent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools ret…
Close the connected wallet SAP agent and reclaim rent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
sap_report_calls1 paramReport served call count for the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read too…
Report served call count for the connected wallet SAP agent. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
| Parameter | Type | Description |
|---|---|---|
callsServed | number | Number of calls served to report for the agent |
sap_update_reputation_metrics2 paramsUpdate self-reported latency and uptime metrics for the connected wallet SAP agent. SAP MCP context: Reputation and trust flow. Use after…
Update self-reported latency and uptime metrics for the connected wallet SAP agent. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
avgLatencyMs | number | Average response latency in milliseconds to report |
uptimePercent | number | Uptime percentage (0–100) to report for the agent |
sap_get_agent1 paramFetch agent identity by owner wallet. If omitted, fetches the connected wallet agent. SAP MCP context: Read-only SAP SDK wrapper against …
Fetch agent identity by owner wallet. If omitted, fetches the connected wallet agent. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
wallet | string | Solana public key of the agent owner wallet (base58). If omitted, uses the connected wallet. |
sap_get_agent_stats1 paramFetch agent stats by agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these r…
Fetch agent stats by agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) to fetch stats for |
sap_get_global_stateFetch the on-chain global registry through SDK AgentModule.fetchGlobalRegistry. SAP MCP context: Read-only SAP SDK wrapper against the co…
Fetch the on-chain global registry through SDK AgentModule.fetchGlobalRegistry. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
sap_get_network_overviewFetch real network counters from SDK DiscoveryRegistry.getNetworkOverview. SAP MCP context: Read-only SAP SDK wrapper against the configu…
Fetch real network counters from SDK DiscoveryRegistry.getNetworkOverview. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
sap_get_agent_profile1 paramFetch a hydrated SAP agent profile by owner wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP …
Fetch a hydrated SAP agent profile by owner wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
wallet | string | Solana public key of the agent owner wallet (base58) |
sap_is_agent_active1 paramCheck if a wallet owns an active SAP agent. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program.…
Check if a wallet owns an active SAP agent. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
wallet | string | Solana public key of the wallet to check for an active SAP agent (base58) |
sap_discover_agents12 paramsPaid hosted discovery for SAP agents. Search and filter the current on-chain AgentAccount directory by query, wallet, protocol, capabilit…
Paid hosted discovery for SAP agents. Search and filter the current on-chain AgentAccount directory by query, wallet, protocol, capability, x402 endpoint presence, and cursor pagination. Use this for targeted agent discovery before calling per-agent fetch tools. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
view | string | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
limit | number | Maximum rows to return. Defaults to 50; hard-capped at 500. |
query | string | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
cursor | string | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
offset | number | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
wallet | string | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
hydrate | boolean | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
agentPda | string | Optional exact SAP agent PDA filter. |
protocol | string | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
capability | string | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
capabilities | array | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
capabilityMode | string | How to match the capability/capabilities filters. Defaults to "any". |
sap_list_agents12 paramsCompatibility alias for sap_discover_agents. Supports query, wallet, protocol, capability, x402 endpoint filtering, and cursor pagination…
Compatibility alias for sap_discover_agents. Supports query, wallet, protocol, capability, x402 endpoint filtering, and cursor pagination. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
view | string | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
limit | number | Maximum rows to return. Defaults to 50; hard-capped at 500. |
query | string | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
cursor | string | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
offset | number | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
wallet | string | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
hydrate | boolean | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
agentPda | string | Optional exact SAP agent PDA filter. |
protocol | string | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
capability | string | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
capabilities | array | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
capabilityMode | string | How to match the capability/capabilities filters. Defaults to "any". |
sap_list_all_agents12 paramsPaid hosted global SAP agent directory read. Enumerates current on-chain AgentAccount PDAs and supports query, wallet, protocol, capabili…
Paid hosted global SAP agent directory read. Enumerates current on-chain AgentAccount PDAs and supports query, wallet, protocol, capability, x402 endpoint filtering, compact/full views, and cursor pagination. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
view | string | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
limit | number | Maximum rows to return. Defaults to 100; hard-capped at 500. |
query | string | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
cursor | string | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
offset | number | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
wallet | string | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
hydrate | boolean | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
agentPda | string | Optional exact SAP agent PDA filter. |
protocol | string | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
capability | string | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
capabilities | array | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
capabilityMode | string | How to match the capability/capabilities filters. Defaults to "any". |
sap_find_tools_by_category3 paramsFind on-chain tool descriptors by SDK tool category name or numeric category. SAP MCP context: Read-only SAP SDK wrapper against the conf…
Find on-chain tool descriptors by SDK tool category name or numeric category. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
limit | number | Maximum number of tools to return (default: 50) |
hydrate | boolean | Whether to include full hydrated tool descriptors in results (default: true) |
category | string | number | Tool category name (e.g. "defi", "infrastructure") or numeric category ID |
sap_get_tool_category_summaryFetch SDK discovery summary across SAP tool categories. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and …
Fetch SDK discovery summary across SAP tool categories. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
sap_fetch_capability_index1 paramFetch a SAP capability index by capability ID. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP progr…
Fetch a SAP capability index by capability ID. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
capabilityId | string | Capability ID to fetch the index for (e.g. "jupiter:swap") |
sap_fetch_protocol_index1 paramFetch a SAP protocol index by protocol ID. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. …
Fetch a SAP protocol index by protocol ID. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
protocolId | string | Protocol ID to fetch the index for (e.g. "jupiter", "drift") |
sap_fetch_tool_category_index1 paramFetch a SAP tool category index by numeric category. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP…
Fetch a SAP tool category index by numeric category. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
category | number | Numeric tool category ID to fetch the index for |
sap_fetch_tool2 paramsFetch a tool descriptor by agent PDA and tool name. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP …
Fetch a tool descriptor by agent PDA and tool name. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) that owns the tool descriptor |
toolName | string | Name of the tool descriptor to fetch |
sap_fetch_feedback2 paramsFetch a feedback PDA by agent PDA and optional reviewer wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana …
Fetch a feedback PDA by agent PDA and optional reviewer wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) to fetch feedback for |
reviewer | string | Optional reviewer wallet (base58) to filter feedback by |
sap_fetch_attestation2 paramsFetch an attestation PDA by agent PDA and optional attester wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Sol…
Fetch an attestation PDA by agent PDA and optional attester wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) to fetch attestation for |
attester | string | Optional attester wallet (base58) to filter attestation by |
sap_fetch_escrow3 paramsFetch a V1 escrow by escrow PDA, or by agent PDA and optional depositor. SAP MCP context: Read-only SAP SDK wrapper against the configure…
Fetch a V1 escrow by escrow PDA, or by agent PDA and optional depositor. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) — used when escrowPda is omitted |
depositor | string | Optional depositor wallet (base58) to filter by |
escrowPda | string | Escrow PDA (base58) to fetch directly |
sap_fetch_escrow_v24 paramsFetch a V2 escrow by escrow PDA, or by agent PDA, depositor, and nonce. SAP MCP context: Read-only SAP SDK wrapper against the configured…
Fetch a V2 escrow by escrow PDA, or by agent PDA, depositor, and nonce. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
nonce | number | Escrow nonce (default: 0) — used with agentPda and depositor |
agentPda | string | Agent PDA (base58) — used when escrowPda is omitted |
depositor | string | Optional depositor wallet (base58) to filter by |
escrowPda | string | Escrow V2 PDA (base58) to fetch directly |
sap_fetch_pending_settlement1 paramFetch a V2 pending settlement PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use thes…
Fetch a V2 pending settlement PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
pendingPda | string | Pending settlement PDA (base58) to fetch |
sap_fetch_dispute1 paramFetch a V2 dispute PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to …
Fetch a V2 dispute PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
disputePda | string | Dispute PDA (base58) to fetch |
sap_fetch_vault1 paramFetch a memory vault by agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use thes…
Fetch a memory vault by agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) to fetch the memory vault for |
sap_fetch_session1 paramFetch a session ledger by session PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use …
Fetch a session ledger by session PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
sessionPda | string | Session PDA (base58) to fetch the ledger for |
sap_fetch_epoch_page2 paramsFetch an epoch page by session PDA and epoch index. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP …
Fetch an epoch page by session PDA and epoch index. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
epochIndex | number | Zero-based epoch index to fetch |
sessionPda | string | Session PDA (base58) to fetch epoch page for |
sap_fetch_stake2 paramsFetch agent stake by stake PDA or agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program…
Fetch agent stake by stake PDA or agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
agentPda | string | Agent PDA (base58) — used when stakePda is omitted |
stakePda | string | Stake PDA (base58) to fetch directly |
sap_fetch_subscription4 paramsFetch a subscription by PDA or by agent PDA/subscriber/subId. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RP…
Fetch a subscription by PDA or by agent PDA/subscriber/subId. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
| Parameter | Type | Description |
|---|---|---|
subId | number | Subscription ID (default: 0) — used with agentPda and subscriber |
agentPda | string | Agent PDA (base58) — used when subscriptionPda is omitted |
subscriber | string | Optional subscriber wallet (base58) to filter by |
subscriptionPda | string | Subscription PDA (base58) to fetch directly |
sap_x402_estimate_cost5 paramsEstimate cost for a number of calls using SDK X402Registry.estimateCost. Reads escrow/pricing when available and supports optional volume…
Estimate cost for a number of calls using SDK X402Registry.estimateCost. Reads escrow/pricing when available and supports optional volume curve overrides. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
calls | number | Number of calls to estimate |
agentWallet | string | Agent wallet public key (base58) |
volumeCurve | array | Optional array of { afterCalls, pricePerCall } pricing breakpoints |
pricePerCall | string | Optional base price per call override in token base units |
totalCallsBefore | number | Optional cumulative settled calls before this estimate |
sap_x402_calculate_cost4 paramsPure local cost calculation using SDK X402Registry.calculateCost; does not read chain state. SAP MCP context: Payment and settlement flow…
Pure local cost calculation using SDK X402Registry.calculateCost; does not read chain state. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
calls | number | Number of calls to calculate |
basePrice | string | Base price per call in token base units |
volumeCurve | array | Array of { afterCalls, pricePerCall } pricing breakpoints |
totalCallsBefore | number | Cumulative settled calls before this calculation (default: 0) |
sap_x402_prepare_payment10 paramsPrepare an x402 payment context using SDK X402Registry.preparePayment. New production escrow funding should use Escrow V2 fields and nonc…
Prepare an x402 payment context using SDK X402Registry.preparePayment. New production escrow funding should use Escrow V2 fields and nonce-aware flows. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
deposit | string | Initial deposit as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
maxCalls | string | Optional maximum number of calls covered |
expiresAt | string | Optional expiry timestamp in unix seconds |
tokenMint | string | Optional SPL token mint; omit/null for SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC. |
agentWallet | string | Agent wallet public key (base58) |
volumeCurve | array | Optional array of { afterCalls, pricePerCall } pricing breakpoints |
pricePerCall | string | Price per call as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
tokenDecimals | number | Optional token decimals. Defaults to 6 for USDC/SPL flows when supplied by the SDK and 9 for native SOL. |
networkIdentifier | string | Optional x402 network identifier written into headers |
sap_x402_build_payment_headers10 paramsBuild SAP x402 HTTP headers from a public PaymentContext returned by sap_x402_prepare_payment. SAP MCP context: Payment and settlement fl…
Build SAP x402 HTTP headers from a public PaymentContext returned by sap_x402_prepare_payment. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce as a decimal string. Defaults to 0. |
network | string | Optional override for X-Payment-Network |
agentPda | string | Agent PDA (base58) |
maxCalls | string | Max calls as a decimal string |
escrowPda | string | Escrow PDA (base58) |
agentWallet | string | Agent wallet public key (base58) |
txSignature | string | Escrow creation transaction signature |
pricePerCall | string | Price per call in token base units |
depositorWallet | string | Depositor wallet public key (base58) |
networkIdentifier | string | x402 network identifier stored in the payment context |
sap_x402_build_headers_from_escrow3 paramsBuild SAP x402 HTTP headers by fetching escrow data for an agent wallet with SDK X402Registry.buildPaymentHeadersFromEscrow. SAP MCP cont…
Build SAP x402 HTTP headers by fetching escrow data for an agent wallet with SDK X402Registry.buildPaymentHeadersFromEscrow. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
network | string | Optional network identifier for X-Payment-Network |
agentWallet | string | Agent wallet public key (base58) |
sap_x402_has_escrow3 paramsCheck whether an x402 escrow exists for an agent/depositor pair. SAP MCP context: Payment and settlement flow. Estimate or fetch state be…
Check whether an x402 escrow exists for an agent/depositor pair. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
depositor | string | Optional depositor wallet (base58); defaults to caller in SDK |
agentWallet | string | Agent wallet public key (base58) |
sap_x402_fetch_escrow3 paramsFetch raw x402 escrow account data using SDK X402Registry.fetchEscrow. Resolves V2 first, then V1 fallback. SAP MCP context: Payment and …
Fetch raw x402 escrow account data using SDK X402Registry.fetchEscrow. Resolves V2 first, then V1 fallback. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
depositor | string | Optional depositor wallet (base58); defaults to caller in SDK |
agentWallet | string | Agent wallet public key (base58) |
sap_x402_get_balance3 paramsFetch x402 escrow balance using SDK X402Registry.getBalance. SAP MCP context: Payment and settlement flow. Estimate or fetch state before…
Fetch x402 escrow balance using SDK X402Registry.getBalance. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
depositor | string | Optional depositor wallet (base58) to filter balance by |
agentWallet | string | Agent wallet public key (base58) |
sap_x402_settle9 paramsSettle served x402 calls through SDK X402Registry.settle. Must be called by the agent owner wallet. SAP MCP context: Payment and settleme…
Settle served x402 calls through SDK X402Registry.settle. Must be called by the agent owner wallet. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
commitment | string | Optional processed|confirmed|finalized commitment |
maxRetries | number | Optional RPC retry limit |
serviceData | string | Service data to hash into the settlement proof |
computeUnits | number | Optional compute-unit limit |
callsToSettle | number | Number of calls to settle |
skipPreflight | boolean | Optional skip preflight flag |
depositorWallet | string | Depositor wallet public key (base58) |
priorityFeeMicroLamports | number | Optional priority fee in microlamports per compute unit |
sap_x402_settle_batch8 paramsBatch-settle served x402 calls through SDK X402Registry.settleBatch. Must be called by the agent owner wallet. SAP MCP context: Payment a…
Batch-settle served x402 calls through SDK X402Registry.settleBatch. Must be called by the agent owner wallet. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
entries | array | Array of { calls, serviceData } settlement entries |
commitment | string | Optional processed|confirmed|finalized commitment |
maxRetries | number | Optional RPC retry limit |
computeUnits | number | Optional compute-unit limit |
skipPreflight | boolean | Optional skip preflight flag |
depositorWallet | string | Depositor wallet public key (base58) |
priorityFeeMicroLamports | number | Optional priority fee in microlamports per compute unit |
sap_escrow_build_create_transaction12 paramsHosted-safe unsigned builder for create_escrow_v2. Use this from hosted SAP MCP, preview the result, then call local sap_payments_finaliz…
Hosted-safe unsigned builder for create_escrow_v2. Use this from hosted SAP MCP, preview the result, then call local sap_payments_finalize_transaction with submit:true. The depositorWallet signs locally; keypair bytes never leave the user machine. Defaults to DisputeWindow settlementSecurity=2 and rejects SelfReport/0. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transac
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
arbiter | string | Optional arbiter public key kept for IDL compatibility and dispute workflows. |
coSigner | string | Required co-signer wallet public key when settlementSecurity=1 (CoSigned). |
maxCalls | string | Maximum number of calls covered by the escrow as a decimal string. Use 0 for unlimited when supported by policy. |
expiresAt | string | Optional expiry timestamp in unix seconds as a decimal string. Defaults to 0 (no expiry). |
tokenMint | string | Optional SPL payment token mint. Omit/null for native SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC x402 escrows. |
agentWallet | string | Agent owner wallet public key (base58). The V2 escrow PDA is derived from this wallet plus nonce. |
pricePerCall | string | Price per served call as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
tokenDecimals | number | Payment token decimals. Defaults to 6 when tokenMint is set, otherwise 9 for native SOL. |
initialDeposit | string | Initial escrow deposit as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
depositorWallet | string | Depositor wallet public key (base58). This wallet signs locally and funds the escrow; hosted SAP MCP never receives its private key. |
disputeWindowSlots | string | Required positive dispute window in slots for settlementSecurity=2. Defaults to 2160 (~15 minutes). |
sap_escrow_build_deposit_transaction4 paramsHosted-safe unsigned builder for deposit_escrow_v2. Use this when a hosted workflow needs to add funds to an existing V2 escrow, then fin…
Hosted-safe unsigned builder for deposit_escrow_v2. Use this when a hosted workflow needs to add funds to an existing V2 escrow, then finalize locally with sap_payments_finalize_transaction. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transaction with submit:true and confirm:true. Never create temporary signing scripts or read keypair JSON.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
amount | string | Deposit amount as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
agentWallet | string | Agent owner wallet public key (base58). The escrow PDA is derived from agentWallet, depositorWallet, and nonce. |
depositorWallet | string | Depositor wallet public key (base58). This wallet signs locally and provides the additional escrow funds. |
sap_escrow_build_settle_transaction6 paramsHosted-safe unsigned builder for settle_calls_v2. The agent owner wallet signs locally. DisputeWindow escrows create a pending settlement…
Hosted-safe unsigned builder for settle_calls_v2. The agent owner wallet signs locally. DisputeWindow escrows create a pending settlement PDA; CoSigned escrows require the coSigner account when configured. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transaction with submit:true and confirm:true. Never create temporary signing scripts or read keypair JSON.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
coSigner | string | Optional co-signer public key for CoSigned escrows when the escrow account requires it. |
agentWallet | string | Agent owner wallet public key (base58). This wallet signs locally because settlement releases funds to the serving agent. |
serviceHash | 32-byte service/audit hash. Use a stable hash of the fulfilled paid work. | |
callsToSettle | string | Number of served calls to settle as a decimal string. |
depositorWallet | string | Depositor wallet public key (base58) for the escrow being settled. |
sap_escrow_build_finalize_transaction5 paramsHosted-safe unsigned builder for finalize_settlement. Use after the dispute window has elapsed and a pending settlement exists; any payer…
Hosted-safe unsigned builder for finalize_settlement. Use after the dispute window has elapsed and a pending settlement exists; any payerWallet can locally sign to crank finalization. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transaction with submit:true and confirm:true. Never create temporary signing scripts or read keypair JSON.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
agentWallet | string | Agent owner wallet public key (base58). |
payerWallet | string | Wallet public key (base58) that signs and pays transaction fees to finalize the pending settlement. |
depositorWallet | string | Depositor wallet public key (base58). |
settlementIndex | string | Pending settlement index as a decimal string. |
sap_escrow_build_withdraw_transaction4 paramsHosted-safe unsigned builder for withdraw_escrow_v2. The depositor signs locally and can only withdraw unlocked balance after pending amo…
Hosted-safe unsigned builder for withdraw_escrow_v2. The depositor signs locally and can only withdraw unlocked balance after pending amounts are excluded. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transaction with submit:true and confirm:true. Never create temporary signing scripts or read keypair JSON.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
amount | string | Withdrawal amount as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
agentWallet | string | Agent owner wallet public key (base58). The escrow PDA is derived from agentWallet, depositorWallet, and nonce. |
depositorWallet | string | Depositor wallet public key (base58). Only the depositor can locally sign a withdrawal from this escrow. |
sap_escrow_build_close_transaction3 paramsHosted-safe unsigned builder for close_escrow_v2. The depositor signs locally; the builder refuses to close until balance and pendingAmou…
Hosted-safe unsigned builder for close_escrow_v2. The depositor signs locally; the builder refuses to close until balance and pendingAmount are both zero. SAP MCP context: Hosted-safe unsigned Escrow V2 builder. The output is not submitted and is not signed by hosted SAP MCP. Preview it, then call local sap_payments_finalize_transaction with submit:true and confirm:true. Never create temporary signing scripts or read keypair JSON.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
agentWallet | string | Agent owner wallet public key (base58). |
depositorWallet | string | Depositor wallet public key (base58). The depositor signs locally to close the empty escrow. |
sap_create_escrow_v212 paramsLocal-signer-only direct V2 escrow creation using SDK EscrowV2Module.create. Defaults to DisputeWindow settlementSecurity=2; SelfReport/0…
Local-signer-only direct V2 escrow creation using SDK EscrowV2Module.create. Defaults to DisputeWindow settlementSecurity=2; SelfReport/0 is rejected. Hosted accountless SAP MCP rejects this before x402 payment; hosted users should call sap_escrow_build_create_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Optional escrow nonce as a decimal string. Defaults to 0. |
arbiter | string | Optional arbiter public key kept for IDL compatibility and dispute workflows. |
coSigner | string | Required co-signer wallet public key when settlementSecurity=1 (CoSigned). |
maxCalls | string | Maximum number of calls covered by the escrow as a decimal string. Use 0 for unlimited when supported by policy. |
expiresAt | string | Optional expiry timestamp in unix seconds as a decimal string. Defaults to 0 (no expiry). |
tokenMint | string | Optional SPL payment token mint. Omit/null for native SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC x402 escrows. |
agentWallet | string | Agent owner wallet public key (base58). The V2 escrow PDA is derived from this wallet plus nonce. |
pricePerCall | string | Price per served call as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
tokenDecimals | number | Payment token decimals. Defaults to 6 when tokenMint is set, otherwise 9 for native SOL. |
initialDeposit | string | Initial escrow deposit as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
disputeWindowSlots | string | Required positive dispute window in slots for settlementSecurity=2. Defaults to 2160 (~15 minutes). |
settlementSecurity | number | V2 settlement security mode. 1=CoSigned (requires coSigner). 2=DisputeWindow (recommended default; requires disputeWindowSlots > 0). SelfReport/0 is deprecated and rejected on-chain. |
sap_deposit_escrow_v23 paramsLocal-signer-only direct deposit into a V2 escrow. Hosted users should call sap_escrow_build_deposit_transaction and finalize locally. SA…
Local-signer-only direct deposit into a V2 escrow. Hosted users should call sap_escrow_build_deposit_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
amount | string | Deposit amount as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
agentWallet | string | Agent wallet public key (base58) |
sap_settle_escrow_v24 paramsLocal-signer-only direct settlement against a V2 escrow. Hosted users should call sap_escrow_build_settle_transaction and finalize locall…
Local-signer-only direct settlement against a V2 escrow. Hosted users should call sap_escrow_build_settle_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
serviceHash | array | 32-byte service hash as a byte array, hex string, or base64 string |
callsToSettle | string | Number of calls to settle (as a decimal string) |
depositorWallet | string | Depositor wallet public key (base58) |
sap_next_settlement_index3 paramsRead the next V2 settlement index. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settl…
Read the next V2 settlement index. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
agentWallet | string | Agent wallet public key (base58) |
depositorWallet | string | Depositor wallet public key (base58) |
sap_finalize_settlement_v24 paramsLocal-signer-only direct finalization of a V2 pending settlement. Hosted users should call sap_escrow_build_finalize_transaction and fina…
Local-signer-only direct finalization of a V2 pending settlement. Hosted users should call sap_escrow_build_finalize_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
agentWallet | string | Agent wallet public key (base58) |
depositorWallet | string | Depositor wallet public key (base58) |
settlementIndex | string | Settlement index to finalize (as a decimal string) |
sap_file_dispute_v24 paramsFile a dispute for a V2 pending settlement. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chai…
File a dispute for a V2 pending settlement. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
agentWallet | string | Agent wallet public key (base58) |
evidenceHash | array | 32-byte evidence hash as a byte array, hex string, or base64 string |
settlementIndex | string | Settlement index to dispute (as a decimal string) |
sap_withdraw_escrow_v23 paramsLocal-signer-only direct withdrawal from a V2 escrow. Hosted users should call sap_escrow_build_withdraw_transaction and finalize locally…
Local-signer-only direct withdrawal from a V2 escrow. Hosted users should call sap_escrow_build_withdraw_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
amount | string | Withdrawal amount as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token. |
agentWallet | string | Agent wallet public key (base58) |
sap_close_escrow_v22 paramsLocal-signer-only direct close for an empty V2 escrow. Hosted users should call sap_escrow_build_close_transaction and finalize locally. …
Local-signer-only direct close for an empty V2 escrow. Hosted users should call sap_escrow_build_close_transaction and finalize locally. SAP MCP context: Payment and settlement flow. Estimate or fetch state before creating escrows or settling calls; write operations require an enabled signer mode and MCP policy approval.
| Parameter | Type | Description |
|---|---|---|
nonce | string | Escrow nonce (as a decimal string, default: 0) |
agentWallet | string | Agent wallet public key (base58) |
sap_give_feedback4 paramsCreate on-chain feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wal…
Create on-chain feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
tag | string | Optional feedback tag/category (default: "general") |
score | number | Feedback score (numeric, e.g. 1–5) |
agentWallet | string | Agent wallet public key (base58) to give feedback for |
commentHash | array | Optional 32-byte comment hash as a byte array, hex string, or base64 string |
sap_update_feedback4 paramsUpdate existing on-chain feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent P…
Update existing on-chain feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
tag | string | Optional new feedback tag/category |
score | number | New feedback score (numeric, e.g. 1–5) |
agentWallet | string | Agent wallet public key (base58) to update feedback for |
commentHash | array | Optional 32-byte comment hash as a byte array, hex string, or base64 string |
sap_revoke_feedback1 paramRevoke feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and k…
Revoke feedback for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
agentWallet | string | Agent wallet public key (base58) to revoke feedback for |
sap_create_attestation4 paramsCreate an on-chain attestation for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA …
Create an on-chain attestation for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
expiresAt | string | Optional expiry timestamp (as a decimal string, 0 = no expiry) |
agentWallet | string | Agent wallet public key (base58) to create attestation for |
metadataHash | array | 32-byte metadata hash as a byte array, hex string, or base64 string |
attestationType | string | Optional attestation type string (default: "generic") |
sap_revoke_attestation1 paramRevoke attestation for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet an…
Revoke attestation for an agent wallet. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
agentWallet | string | Agent wallet public key (base58) to revoke attestation for |
sap_fairscale_score2 paramsScore an agent with SDK FairScaleRegistry.score. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or …
Score an agent with SDK FairScaleRegistry.score. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
task | string | Optional FairScale task type: one of "defi_execution", "trust_focused", "work_focused", "hiring" |
agent | string | Agent PDA or wallet (base58) to score |
sap_fairscale_trust_gate3 paramsEvaluate an agent with SDK FairScaleRegistry.trustGate. SAP MCP context: Reputation and trust flow. Use after verifying the target agent …
Evaluate an agent with SDK FairScaleRegistry.trustGate. SAP MCP context: Reputation and trust flow. Use after verifying the target agent PDA or wallet and keep hashes/attestation metadata stable and auditable.
| Parameter | Type | Description |
|---|---|---|
agent | string | Agent PDA or wallet (base58) to evaluate |
minScore | number | Optional minimum trust score threshold |
requireVerification | boolean | Whether verified status is required to pass the gate (default: false) |
sap_init_vault1 paramInitialize a memory vault for the connected agent. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or p…
Initialize a memory vault for the connected agent. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
vaultNonce | array | Vault nonce as a byte array, hex string, or base64 string |
sap_open_vault_session1 paramOpen a vault session by 32-byte session hash. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public…
Open a vault session by 32-byte session hash. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
sessionHash | array | 32-byte session hash as a byte array, hex string, or base64 string |
sap_inscribe_memoryInscribe encrypted memory using SDK VaultModule.inscribe. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloa…
Inscribe encrypted memory using SDK VaultModule.inscribe. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
sap_compact_inscribe_memory5 paramsCompact memory inscription with explicit vault/session PDAs. SAP MCP context: Memory/session flow. Store only intentionally encrypted pay…
Compact memory inscription with explicit vault/session PDAs. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
nonce | array | Encryption nonce as a byte array, hex string, or base64 string |
vaultPda | string | Vault PDA (base58) for the memory inscription |
sessionPda | string | Session PDA (base58) for the memory inscription |
contentHash | array | 32-byte content hash as a byte array, hex string, or base64 string |
encryptedData | array | Encrypted memory data as a byte array, hex string, or base64 string |
sap_session_start2 paramsStart a high-level SDK session by session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public…
Start a high-level SDK session by session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
sessionId | string | High-level session identifier string |
vaultNonce | array | Optional vault nonce as a byte array, hex string, or base64 string |
sap_session_read_latest1 paramRead latest entries from a high-level SDK session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads o…
Read latest entries from a high-level SDK session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
sessionId | string | High-level session identifier string to read latest entries from |
sap_session_status1 paramFetch high-level SDK session status by session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or p…
Fetch high-level SDK session status by session ID. SAP MCP context: Memory/session flow. Store only intentionally encrypted payloads or public hashes; session and vault PDAs are visible on-chain metadata.
| Parameter | Type | Description |
|---|---|---|
sessionId | string | High-level session identifier string to get status for |
sap_publish_tool_by_name10 paramsPublish a tool descriptor using SDK ToolsModule.publishByName. SAP MCP context: Use tool registry writes to advertise concrete capabiliti…
Publish a tool descriptor using SDK ToolsModule.publishByName. SAP MCP context: Use tool registry writes to advertise concrete capabilities that this MCP can serve, including AgentKit bridge tools such as bridging_bridgeWormhole and Metaplex tools such as metaplex-nft_mintNFT. Publish only schemas and descriptions that match the actual MCP tool surface.
| Parameter | Type | Description |
|---|---|---|
category | number | Numeric tool category ID |
toolName | string | Name of the tool to publish |
httpMethod | number | HTTP method code (e.g. 0=GET, 1=POST) |
isCompound | boolean | Whether the tool is a compound tool (default: false) |
protocolId | string | Protocol ID the tool belongs to (e.g. "jupiter") |
description | string | Human-readable description of the tool |
paramsCount | number | Total number of parameters the tool accepts |
requiredParams | number | Number of required parameters |
inputSchemaJson | string | JSON string of the tool input schema |
outputSchemaJson | string | JSON string of the tool output schema |
sap_update_toolUpdate tool descriptor hashes using SDK ToolsModule.update. SAP MCP context: Use tool registry writes to advertise concrete capabilities …
Update tool descriptor hashes using SDK ToolsModule.update. SAP MCP context: Use tool registry writes to advertise concrete capabilities that this MCP can serve, including AgentKit bridge tools such as bridging_bridgeWormhole and Metaplex tools such as metaplex-nft_mintNFT. Publish only schemas and descriptions that match the actual MCP tool surface.
sap_deactivate_tool1 paramDeactivate a SAP tool descriptor by name. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain …
Deactivate a SAP tool descriptor by name. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
| Parameter | Type | Description |
|---|---|---|
toolName | string | Name of the tool descriptor to deactivate |
sap_reactivate_tool1 paramReactivate a SAP tool descriptor by name. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain …
Reactivate a SAP tool descriptor by name. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
| Parameter | Type | Description |
|---|---|---|
toolName | string | Name of the tool descriptor to reactivate |
sap_report_tool_invocations2 paramsReport invocation count for a SAP tool descriptor. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return …
Report invocation count for a SAP tool descriptor. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require signer policy, configured RPC, and the active SAP profile.
| Parameter | Type | Description |
|---|---|---|
toolName | string | Name of the tool descriptor to report invocations for |
invocations | number | Number of invocations to report |
sap_init_stake2 paramsInitialize stake for an agent wallet. SAP MCP context: SAP protocol staking flow. Confirm agent wallet, amount, and unstake timing before…
Initialize stake for an agent wallet. SAP MCP context: SAP protocol staking flow. Confirm agent wallet, amount, and unstake timing before writes; this is distinct from external AgentKit staking protocol tools.
| Parameter | Type | Description |
|---|---|---|
agentWallet | string | Agent wallet public key (base58) to initialize stake for |
initialDeposit | string | Initial stake deposit amount in lamports (as a decimal string) |
sap_deposit_stake2 paramsDeposit additional stake for an agent wallet. SAP MCP context: SAP protocol staking flow. Confirm agent wallet, amount, and unstake timin…
Deposit additional stake for an agent wallet. SAP MCP context: SAP protocol staking flow. Confirm agent wallet, amount, and unstake timing before writes; this is distinct from external AgentKit staking protocol tools.
| Parameter | Type | Description |
|---|---|---|
amount | string | Additional stake deposit amount in lamports (as a decimal string) |
agentWallet | string | Agent wallet public key (base58) |
Ready-made
Prompts
register-sap-agentStep-by-step guide to register as SAP agent on Solana blockchainanalyze-sap-agentAnalyze SAP agent registration, capabilities, reputation, and on-chain activitygenerate-sap-integrationGenerate code snippets and configuration for integrating SAP SDK into a TypeScript projectdebug-sap-errorSystematic debugging workflow for SAP SDK errors, transaction failures, and on-chain issuesexplain-x402-settlementExplain x402 payment protocol, settlement flows, and escrow mechanics for AI agent paymentscreate-paid-apiCreate paid API endpoint with x402 payment protection for AI agent servicesexplain-proof-of-executionExplain proof-of-execution cryptography, hash chains, and audit trail verification for AI agent callsverify-execution-proofVerify execution proofs, validate hash chains, and audit AI agent call histories on-chainsap-agent-startStart SAP MCP agent mode. Use when the user says "Start SAP MCP", "Initialize SAP MCP", "Load SAP", or asks the agent to use SAP MCP.sap-agent-contextGet complete context about the current SAP MCP configuration, active profile, redacted signer status, and available capabilities. Use this before any SAP operations.