Model Context Protocol (MCP) server for freee API integration
Nothing to run from here
SAP MCP Server is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
453
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
Solana-native MCP gateway for SAP, DeFi tools, SNS identity, and x402 payments.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http sap-mcp-server https://mcp.sap.oobeprotocol.ai/mcp
# 2 — ask your agent for something these tools do
# sap_protocol_invariants, sap_agent_identity_plan, sap_register_agent and 450 more
SAP MCP Server costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
MSAll 1 server
mcp.sap.oobeprotocol.ai1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, read from the address; if the publisher says otherwise, swap that one word.
claude mcp add --scope user --transport http sap-mcp-server https://mcp.sap.oobeprotocol.ai/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
453 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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 b
No parameter schema on file.
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intendedAction | string | no | Agent identity lifecycle step to plan. Use register for a new SAP agent, update for profile/image/capability changes, link-metaplex for NFT/MPL Core identity, link-sns for .sol identity, or full-ident |
| name | string | no | Required public display name for the SAP agent. Keep it stable enough for explorers and humans. |
| description | string | no | Required public description of what the agent does, which protocols it can use, and its safety/trust boundaries. |
| capabilities | array | no | Required capability list. Prefer object form for production; strings are accepted as shorthand. |
| pricing | array | no | Optional pricing tiers advertised by the agent. Use tokenType usdc + settlementMode x402 for pay.sh/x402 agent commerce. |
| protocols | array | no | Required protocol tags the agent supports, for example sap, mcp, jupiter, pyth, metaplex, sns, x402, payments. |
| agentId | string | no | Optional stable lowercase agent id, for example solking. This is separate from the on-chain agent PDA. |
| agentUri | string | no | Optional public HTTPS/IPFS/Arweave/Kommodo URI for the agent profile metadata or profile page. Never use local desktop file paths. |
| metadataUri | string | no | Alias for agentUri. Prefer a public JSON metadata document containing name, description, image, external_url, attributes, sap, metaplex, sns, and x402 fields. |
| x402Endpoint | string | no | Optional public x402 discovery/payment endpoint, usually https://host/.well-known/x402 for external agent services. |
| snsDomain | string | no | Optional .sol domain to link after ownership or registration is verified. |
| imageUrl | string | no | Optional public image URL. This must be HTTPS, IPFS, Arweave, or another public URI; desktop file paths are not valid. |
| metaplexAsset | string | no | Optional Metaplex NFT or MPL Core asset/collection address to reference from public agent metadata. |
| ownerWallet | string | no | Optional expected SAP owner wallet. Use this for verification planning only; signing still comes from the active local SAP profile. |
DISABLED: this direct write cannot run in hosted Steve (no server keypair) and fails with "Explicit user approval is required" or hosted_local_signer_required. In Steve web the ONLY registration path is sap_build_agent_register_transaction → Steve UI preview → user approval → browser signature → finalize submit. In LOCAL sap_payments setups use sap_payments_register_agent instead. SAP MCP context:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Required public display name for the SAP agent. Keep it stable enough for explorers and humans. |
| description | string | no | Required public description of what the agent does, which protocols it can use, and its safety/trust boundaries. |
| capabilities | array | no | Required capability list. Prefer object form for production; strings are accepted as shorthand. |
| pricing | array | no | Optional pricing tiers advertised by the agent. Use tokenType usdc + settlementMode x402 for pay.sh/x402 agent commerce. |
| protocols | array | no | Required protocol tags the agent supports, for example sap, mcp, jupiter, pyth, metaplex, sns, x402, payments. |
| agentId | string | no | Optional stable lowercase agent id, for example solking. This is separate from the on-chain agent PDA. |
| agentUri | string | no | Optional public HTTPS/IPFS/Arweave/Kommodo URI for the agent profile metadata or profile page. Never use local desktop file paths. |
| metadataUri | string | no | Alias for agentUri. Prefer a public JSON metadata document containing name, description, image, external_url, attributes, sap, metaplex, sns, and x402 fields. |
| x402Endpoint | string | no | Optional public x402 discovery/payment endpoint, usually https://host/.well-known/x402 for external agent services. |
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 metadataU
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Optional replacement display name. Omit to keep the current name. |
| description | string | no | Optional replacement description. Omit to keep the current description. |
| capabilities | array | no | Optional full replacement capability list. Omit to keep current capabilities; do not send only the new item unless replacing the whole list is intended. |
| pricing | array | no | Optional full replacement pricing tier list. Omit to keep current pricing. |
| protocols | array | no | Optional full replacement protocol list. Omit to keep current protocols. |
| agentId | string | no | Optional replacement stable agent id. Omit to keep current agentId. |
| agentUri | string | no | Optional replacement public URI for agent metadata/profile. Use this to update pictures after uploading metadata to IPFS, Arweave, Kommodo, or HTTPS. |
| metadataUri | string | no | Alias for agentUri. Use a public metadata JSON URI; never use a desktop file path. |
| x402Endpoint | string | no | Optional replacement x402 discovery/payment endpoint. Omit to keep current endpoint. |
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 MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountle
No parameter schema on file.
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 MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountle
No parameter schema on file.
Backfill or resync the AgentPricingMenu PDA for the connected wallet SAP agent. Run this once if sap_update_agent, sap_close_agent, or createEscrowV2 fails with AccountNotInitialized on the pricing_menu account. Agents registered before pricing menus were created at registration need this one-time migration. Local-signer-only; hosted accountless SAP MCP rejects this direct write before x402 paymen
No parameter schema on file.
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 MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: host
No parameter schema on file.
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime
| Parameter | Type | Required | Notes |
|---|---|---|---|
| callsServed | number | no | Number of calls served to report for the agent |
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. SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| avgLatencyMs | number | no | Average response latency in milliseconds to report |
| uptimePercent | number | no | Uptime percentage (0–100) to report for the agent |
Free exact SAP agent identity read by owner wallet. If omitted, fetches the connected wallet agent. Use this before paid discovery when the wallet is known. 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 MCP execution guidance:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | no | Solana public key of the agent owner wallet (base58). If omitted, uses the connected wallet. |
Free exact SAP agent stats read by agent PDA. Use after sap_get_agent or sap_get_agent_profile when stats are needed. 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 MCP execution guidance: Intent: read/discovery workflow. Pricin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentPda | string | no | Agent PDA (base58) to fetch stats for |
Free compact global SAP registry state read. Use for initial orientation before paid network analytics. 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 MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by h
No parameter schema on file.
Hosted-safe unsigned builder for register_agent. Browser runtimes preview this transaction, the owner wallet approves and signs locally, then it goes through the Steve signed-transaction submit relay or sap_payments_finalize_transaction. Pays the 0.1 SOL SAP protocol registration fee from the signing wallet. Keypair bytes never leave the user device. SAP MCP context: Direct synapse-sap-sdk wrapper
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ownerWallet | string | no | Agent owner wallet public key (base58) — also the transaction fee payer and sole required signer. |
| name | string | no | Public display name for the SAP agent. |
| description | string | no | Public description of what the agent does. |
| capabilities | array | no | Capability list: [{ id, description, protocolId, version }] (strings accepted as shorthand). |
| pricing | array | no | Optional pricing tiers advertised by the agent. |
| protocols | array | no | Protocol tags the agent supports (sap, mcp, jupiter, sns, x402...). |
| agentId | string | no | Optional stable lowercase agent id (off-chain, separate from the on-chain PDA). |
| agentUri | string | no | Optional public HTTPS/IPFS/Arweave metadata URI. |
| x402Endpoint | string | no | Optional public x402 discovery/payment endpoint. |
Hosted-safe unsigned builder for update_agent. The owner wallet signs locally after preview; null fields are ignored on-chain. 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 MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid buil
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ownerWallet | string | no | Agent owner wallet public key (base58) — sole required signer. |
| name | string | no | Optional replacement display name. |
| description | string | no | Optional replacement description. |
| capabilities | array | no | Optional FULL replacement capability list. |
| pricing | array | no | Optional FULL replacement pricing tier list. |
| protocols | array | no | Optional FULL replacement protocol list. |
| agentId | string | no | Optional replacement stable agent id. |
| agentUri | string | no | Optional replacement public metadata URI (use for image updates after uploading to IPFS/etc). |
| x402Endpoint | string | no | Optional replacement x402 endpoint. |
Hosted-safe unsigned builder for the agent lifecycle actions: deactivate_agent, reactivate_agent, close_agent (reclaims rent), and migrate_pricing_menu (one-time backfill of the PricingMenu PDA for agents registered before pricing menus existed). The owner wallet signs locally. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools require
| Parameter | Type | Required | Notes |
|---|---|---|---|
| action | string | no | Lifecycle action to build. |
| ownerWallet | string | no | Agent owner wallet public key (base58) — sole required signer. |
Hosted-safe unsigned builder for report_calls. The agent owner wallet signs locally after serving calls to consumers. 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 MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; esti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ownerWallet | string | no | Agent owner wallet public key (base58) — sole required signer. |
| callsServed | number | no | Number of calls served to report for the agent. |
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 MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing
No parameter schema on file.
Free one-shot SAP orientation context for agents. Use this when the user asks whether SAP MCP is connected, wants to understand an agent/wallet, or needs the next safe paid/write route. It combines exact reads or a compact directory page with routing guidance without triggering x402. SAP MCP context: Direct synapse-sap-sdk wrapper served by this MCP. Read tools return on-chain state; write tools r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | no | Optional exact owner wallet public key (base58). When supplied, returns the matching agent identity, PDA, active state, and hydrated profile when available. |
| agentPda | string | no | Optional exact SAP agent PDA (base58) for compact context lookup when the owner wallet is not known. |
| query | string | no | Optional text query for a compact micro-read orientation search. Keep this narrow, for example "XONA" or "Solking". |
| limit | number | no | Maximum compact orientation rows to include when wallet is not supplied. Defaults to 10 and is capped at 20 to keep this tool in the micro-read tier. |
Export a known SAP agent into an OASF-style, machine-readable profile view for agent directories and cross-runtime discovery. This is an exact owner-wallet read: it derives the SAP agent PDA, fetches the current on-chain agent/profile/stats when available, and normalizes identity, protocols, capabilities, pricing, x402 endpoint, metadata links, and trust facts without exposing local wallet paths o
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | no | Required owner wallet public key in base58. Use sap_discover_agents or sap_agent_context first when the wallet is unknown. |
| includeSourceFragments | boolean | no | Whether to include redacted source account/profile fragments for debugging directory ingestion. Defaults to false. |
Micro-read exact SAP agent profile lookup by owner wallet. Use this for a known agent before read-premium discovery or enrichment. 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 MCP execution guidance: Intent: read/discovery wor
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | no | Solana public key of the agent owner wallet (base58) |
Micro-read exact activity check for an owner wallet. Use this before read-premium discovery when the wallet is known. 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 MCP execution guidance: Intent: SAP MCP tool workflow. Pricing:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | no | Solana public key of the wallet to check for an active SAP agent (base58) |
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 st
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
| wallet | string | no | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
| agentPda | string | no | Optional exact SAP agent PDA filter. |
| protocol | string | no | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
| capability | string | no | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
| capabilities | array | no | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
| capabilityMode | string | no | How to match the capability/capabilities filters. Defaults to "any". |
| hasX402Endpoint | boolean | no | Optional filter for agents that advertise a paid HTTP/x402 endpoint. |
| includeInactive | boolean | no | Include inactive agents. Defaults to false. |
| limit | number | no | Maximum rows to return. Defaults to 50; hard-capped at 500. |
| offset | number | no | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
| cursor | string | no | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
| view | string | no | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
| hydrate | boolean | no | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
| includeProtocolIndexes | boolean | no | Include compact protocol index summaries. Defaults to false for sap_discover_agents and true for sap_list_all_agents. |
Compact SAP agent orientation list. Micro-read when limit <= 20, view is compact, hydrate is false, and includeProtocolIndexes is false; larger or enriched pages are read-premium. 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 M
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
| wallet | string | no | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
| agentPda | string | no | Optional exact SAP agent PDA filter. |
| protocol | string | no | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
| capability | string | no | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
| capabilities | array | no | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
| capabilityMode | string | no | How to match the capability/capabilities filters. Defaults to "any". |
| hasX402Endpoint | boolean | no | Optional filter for agents that advertise a paid HTTP/x402 endpoint. |
| includeInactive | boolean | no | Include inactive agents. Defaults to false. |
| limit | number | no | Maximum rows to return. Defaults to 20; hard-capped at 500. |
| offset | number | no | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
| cursor | string | no | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
| view | string | no | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
| hydrate | boolean | no | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
| includeProtocolIndexes | boolean | no | Include compact protocol index summaries. Defaults to false for sap_discover_agents and true for sap_list_all_agents. |
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, mem
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". |
| wallet | string | no | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. |
| agentPda | string | no | Optional exact SAP agent PDA filter. |
| protocol | string | no | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". |
| capability | string | no | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". |
| capabilities | array | no | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. |
| capabilityMode | string | no | How to match the capability/capabilities filters. Defaults to "any". |
| hasX402Endpoint | boolean | no | Optional filter for agents that advertise a paid HTTP/x402 endpoint. |
| includeInactive | boolean | no | Include inactive agents. Defaults to false. |
| limit | number | no | Maximum rows to return. Defaults to 100; hard-capped at 500. |
| offset | number | no | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. |
| cursor | string | no | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. |
| view | string | no | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. |
| hydrate | boolean | no | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. |
| includeProtocolIndexes | boolean | no | Include compact protocol index summaries. Defaults to false for sap_discover_agents and true for sap_list_all_agents. |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string/number | no | Tool category name (e.g. "defi", "infrastructure") or numeric category ID |
| hydrate | boolean | no | Whether to include full hydrated tool descriptors in results (default: true) |
| limit | number | no | Maximum number of tools to return (default: 50) |
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 MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call;
No parameter schema on file.
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap
| Parameter | Type | Required | Notes |
|---|---|---|---|
| capabilityId | string | no | Capability ID to fetch the index for (e.g. "jupiter:swap") |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_est
| Parameter | Type | Required | Notes |
|---|---|---|---|
| protocolId | string | no | Protocol ID to fetch the index for (e.g. "jupiter", "adrena") |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | number | no | Numeric tool category ID to fetch the index for |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentPda | string | no | Agent PDA (base58) that owns the tool descriptor |
| toolName | string | no | Name of the tool descriptor to fetch |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_pay
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentPda | string | no | Agent PDA (base58) to fetch feedback for |
| reviewer | string | no | Optional reviewer wallet (base58) to filter feedback by |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentPda | string | no | Agent PDA (base58) to fetch attestation for |
| attester | string | no | Optional attester wallet (base58) to filter attestation by |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then us
| Parameter | Type | Required | Notes |
|---|---|---|---|
| escrowPda | string | no | Escrow PDA (base58) to fetch directly |
| agentPda | string | no | Agent PDA (base58) — used when escrowPda is omitted |
| depositor | string | no | Optional depositor wallet (base58) to filter by |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use
| Parameter | Type | Required | Notes |
|---|---|---|---|
| escrowPda | string | no | Escrow V2 PDA (base58) to fetch directly |
| agentPda | string | no | Agent PDA (base58) — used when escrowPda is omitted |
| depositor | string | no | Optional depositor wallet (base58) to filter by |
| nonce | number | no | Escrow nonce (default: 0) — used with agentPda and depositor |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pendingPda | string | no | Pending settlement PDA (base58) to fetch |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| disputePda | string | no | Dispute PDA (base58) to fetch |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentPda | string | no | Agent PDA (base58) to fetch the memory vault for |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionPda | string | no | Session PDA (base58) to fetch the ledger for |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionPda | string | no | Session PDA (base58) to fetch epoch page for |
| epochIndex | number | no | Zero-based epoch index to fetch |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_too
| Parameter | Type | Required | Notes |
|---|---|---|---|
| stakePda | string | no | Stake PDA (base58) to fetch directly |
| agentPda | string | no | Agent PDA (base58) — used when stakePda is omitted |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payme
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subscriptionPda | string | no | Subscription PDA (base58) to fetch directly |
| agentPda | string | no | Agent PDA (base58) — used when subscriptionPda is omitted |
| subscriber | string | no | Optional subscriber wallet (base58) to filter by |
| subId | number | no | Subscription ID (default: 0) — used with agentPda and subscriber |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| calls | number | no | Number of calls to estimate |
| pricePerCall | string | no | Optional base price per call override in token base units |
| totalCallsBefore | number | no | Optional cumulative settled calls before this estimate |
| volumeCurve | array | no | Optional array of { afterCalls, pricePerCall } pricing breakpoints |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| basePrice | string | no | Base price per call in token base units |
| calls | number | no | Number of calls to calculate |
| totalCallsBefore | number | no | Cumulative settled calls before this calculation (default: 0) |
| volumeCurve | array | no | Array of { afterCalls, pricePerCall } pricing breakpoints |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| pricePerCall | string | no | 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. |
| deposit | string | no | 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 | no | Optional maximum number of calls covered |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| expiresAt | string | no | Optional expiry timestamp in unix seconds |
| volumeCurve | array | no | Optional array of { afterCalls, pricePerCall } pricing breakpoints |
| tokenMint | string | no | Optional SPL token mint; omit/null for SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC. |
| tokenDecimals | number | no | Optional token decimals. Defaults to 6 for USDC/SPL flows when supplied by the SDK and 9 for native SOL. |
| networkIdentifier | string | no | Optional x402 network identifier written into headers |
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. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| escrowPda | string | no | Escrow PDA (base58) |
| agentPda | string | no | Agent PDA (base58) |
| agentWallet | string | no | Agent wallet public key (base58) |
| depositorWallet | string | no | Depositor wallet public key (base58) |
| pricePerCall | string | no | Price per call in token base units |
| maxCalls | string | no | Max calls as a decimal string |
| nonce | string | no | Escrow nonce as a decimal string. Defaults to 0. |
| txSignature | string | no | Escrow creation transaction signature |
| networkIdentifier | string | no | x402 network identifier stored in the payment context |
| network | string | no | Optional override for X-Payment-Network |
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. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid b
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| network | string | no | Optional network identifier for X-Payment-Network |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_to
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| depositor | string | no | Optional depositor wallet (base58); defaults to caller in SDK |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Ro
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| depositor | string | no | Optional depositor wallet (base58); defaults to caller in SDK |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
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. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and kee
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| depositor | string | no | Optional depositor wallet (base58) to filter balance by |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transacti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58) |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| callsToSettle | number | no | Number of calls to settle |
| serviceData | string | no | Service data to hash into the settlement proof |
| priorityFeeMicroLamports | number | no | Optional priority fee in microlamports per compute unit |
| computeUnits | number | no | Optional compute-unit limit |
| skipPreflight | boolean | no | Optional skip preflight flag |
| commitment | string | no | Optional processed|confirmed|finalized commitment |
| maxRetries | number | no | Optional RPC retry limit |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost an
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58) |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| entries | array | no | Array of { calls, serviceData } settlement entries |
| priorityFeeMicroLamports | number | no | Optional priority fee in microlamports per compute unit |
| computeUnits | number | no | Optional compute-unit limit |
| skipPreflight | boolean | no | Optional skip preflight flag |
| commitment | string | no | Optional processed|confirmed|finalized commitment |
| maxRetries | number | no | Optional RPC retry limit |
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 subm
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58). This wallet signs locally and funds the escrow; hosted SAP MCP never receives its private key. |
| agentWallet | string | no | Agent owner wallet public key (base58). The V2 escrow PDA is derived from this wallet plus nonce. |
| pricePerCall | string | no | 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. |
| maxCalls | string | no | Maximum number of calls covered by the escrow as a decimal string. Use 0 for unlimited when supported by policy. |
| initialDeposit | string | no | 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. |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| expiresAt | string | no | Optional expiry timestamp in unix seconds as a decimal string. Defaults to 0 (no expiry). |
| tokenMint | string | no | Optional SPL payment token mint. Omit/null for native SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC x402 escrows. |
| tokenDecimals | number | no | Payment token decimals. Defaults to 6 when tokenMint is set, otherwise 9 for native SOL. |
| settlementSecurity | number | no | V2 settlement security mode. 1=CoSigned (requires coSigner). 2=DisputeWindow (recommended default; requires disputeWindowSlots > 0). SelfReport/0 is deprecated and rejected on-chain. |
| disputeWindowSlots | string | no | Required positive dispute window in slots for settlementSecurity=2. Defaults to 2160 (~15 minutes). |
| coSigner | string | no | Required co-signer wallet public key when settlementSecurity=1 (CoSigned). |
| arbiter | string | no | Optional arbiter public key kept for IDL compatibility and dispute workflows. |
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 conf
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58). This wallet signs locally and provides the additional escrow funds. |
| agentWallet | string | no | Agent owner wallet public key (base58). The escrow PDA is derived from agentWallet, depositorWallet, and nonce. |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| amount | string | no | 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. |
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 submi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent owner wallet public key (base58). This wallet signs locally because settlement releases funds to the serving agent. |
| depositorWallet | string | no | Depositor wallet public key (base58) for the escrow being settled. |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| callsToSettle | string | no | Number of served calls to settle as a decimal string. |
| serviceHash | no | 32-byte service/audit hash. Use a stable hash of the fulfilled paid work. | |
| coSigner | string | no | Optional co-signer public key for CoSigned escrows when the escrow account requires it. |
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:tru
| Parameter | Type | Required | Notes |
|---|---|---|---|
| payerWallet | string | no | Wallet public key (base58) that signs and pays transaction fees to finalize the pending settlement. |
| agentWallet | string | no | Agent owner wallet public key (base58). |
| depositorWallet | string | no | Depositor wallet public key (base58). |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| settlementIndex | string | no | Pending settlement index as a decimal string. |
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 si
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58). Only the depositor can locally sign a withdrawal from this escrow. |
| agentWallet | string | no | Agent owner wallet public key (base58). The escrow PDA is derived from agentWallet, depositorWallet, and nonce. |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| amount | string | no | 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. |
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 sig
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58). The depositor signs locally to close the empty escrow. |
| agentWallet | string | no | Agent owner wallet public key (base58). |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent owner wallet public key (base58). The V2 escrow PDA is derived from this wallet plus nonce. |
| pricePerCall | string | no | 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. |
| maxCalls | string | no | Maximum number of calls covered by the escrow as a decimal string. Use 0 for unlimited when supported by policy. |
| initialDeposit | string | no | 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. |
| nonce | string | no | Optional escrow nonce as a decimal string. Defaults to 0. |
| expiresAt | string | no | Optional expiry timestamp in unix seconds as a decimal string. Defaults to 0 (no expiry). |
| tokenMint | string | no | Optional SPL payment token mint. Omit/null for native SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC x402 escrows. |
| tokenDecimals | number | no | Payment token decimals. Defaults to 6 when tokenMint is set, otherwise 9 for native SOL. |
| settlementSecurity | number | no | V2 settlement security mode. 1=CoSigned (requires coSigner). 2=DisputeWindow (recommended default; requires disputeWindowSlots > 0). SelfReport/0 is deprecated and rejected on-chain. |
| disputeWindowSlots | string | no | Required positive dispute window in slots for settlementSecurity=2. Defaults to 2160 (~15 minutes). |
| coSigner | string | no | Required co-signer wallet public key when settlementSecurity=1 (CoSigned). |
| arbiter | string | no | Optional arbiter public key kept for IDL compatibility and dispute workflows. |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
| amount | string | no | 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. |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| depositorWallet | string | no | Depositor wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
| callsToSettle | string | no | Number of calls to settle (as a decimal string) |
| serviceHash | array | no | 32-byte service hash as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 na
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| depositorWallet | string | no | Depositor wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pri
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| depositorWallet | string | no | Depositor wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
| settlementIndex | string | no | Settlement index to finalize (as a decimal string) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
| settlementIndex | string | no | Settlement index to dispute (as a decimal string) |
| evidenceHash | array | no | 32-byte evidence hash as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid v
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
| amount | string | no | 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. |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid val
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| nonce | string | no | Escrow nonce (as a decimal string, default: 0) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to give feedback for |
| score | number | no | Feedback score (numeric, e.g. 1–5) |
| tag | string | no | Optional feedback tag/category (default: "general") |
| commentHash | array | no | Optional 32-byte comment hash as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: paid hosted call; call sa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to update feedback for |
| score | number | no | New feedback score (numeric, e.g. 1–5) |
| tag | string | no | Optional new feedback tag/category |
| commentHash | array | no | Optional 32-byte comment hash as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: hosted accoun
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to revoke feedback for |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountless write is blocke
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to create attestation for |
| attestationType | string | no | Optional attestation type string (default: "generic") |
| metadataHash | array | no | 32-byte metadata hash as a byte array, hex string, or base64 string |
| expiresAt | string | no | Optional expiry timestamp (as a decimal string, 0 = no expiry) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: hosted acc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to revoke attestation for |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Agent PDA or wallet (base58) to score |
| task | string | no | Optional FairScale task type: one of "defi_execution", "trust_focused", "work_focused", "hiring" |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Rou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Agent PDA or wallet (base58) to evaluate |
| minScore | number | no | Optional minimum trust score threshold |
| requireVerification | boolean | no | Whether verified status is required to pass the gate (default: false) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vaultNonce | array | no | Vault nonce as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionHash | array | no | 32-byte session hash as a byte array, hex string, or base64 string |
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 MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. R
No parameter schema on file.
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionPda | string | no | Session PDA (base58) for the memory inscription |
| vaultPda | string | no | Vault PDA (base58) for the memory inscription |
| encryptedData | array | no | Encrypted memory data as a byte array, hex string, or base64 string |
| nonce | array | no | Encryption nonce as a byte array, hex string, or base64 string |
| contentHash | array | no | 32-byte content hash as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | no | High-level session identifier string |
| vaultNonce | array | no | Optional vault nonce as a byte array, hex string, or base64 string |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | no | High-level session identifier string to read latest entries from |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | no | High-level session identifier string to get status for |
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. SAP MCP execution guidance: Intent: SAP MCP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | no | Name of the tool to publish |
| protocolId | string | no | Protocol ID the tool belongs to (e.g. "jupiter") |
| description | string | no | Human-readable description of the tool |
| inputSchemaJson | string | no | JSON string of the tool input schema |
| outputSchemaJson | string | no | JSON string of the tool output schema |
| httpMethod | number | no | HTTP method code (e.g. 0=GET, 1=POST) |
| category | number | no | Numeric tool category ID |
| paramsCount | number | no | Total number of parameters the tool accepts |
| requiredParams | number | no | Number of required parameters |
| isCompound | boolean | no | Whether the tool is a compound tool (default: false) |
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 MCP execution guidance: Intent: local-sign
No parameter schema on file.
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountles
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | no | Name of the tool descriptor to deactivate |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountles
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | no | Name of the tool descriptor to reactivate |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot rep
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | no | Name of the tool descriptor to report invocations for |
| invocations | number | no | Number of invocations to report |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Rou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to initialize stake for |
| initialDeposit | string | no | Initial stake deposit amount in lamports (as a decimal string) |
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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountless wri
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| amount | string | no | Additional stake deposit amount in lamports (as a decimal string) |
Request unstake 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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Rout
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| amount | string | no | Unstake request amount in lamports (as a decimal string) |
Complete unstake 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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Rou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to complete unstaking for |
Create a recurring subscription for an agent 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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: h
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) to create subscription for |
| subId | string | no | Subscription ID (as a decimal string, default: 0) |
| pricePerInterval | string | no | Price per billing interval in lamports (as a decimal string) |
| billingInterval | number | no | Billing interval in seconds between charges |
| initialFund | string | no | Initial fund amount in lamports (as a decimal string) |
Fund a recurring subscription. 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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountless writ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| subId | string | no | Subscription ID (as a decimal string, default: 0) |
| amount | string | no | Funding amount in lamports (as a decimal string) |
Cancel a recurring subscription. 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. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: hosted accountless wr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agentWallet | string | no | Agent wallet public key (base58) |
| subId | string | no | Subscription ID (as a decimal string, default: 0) |
Check whether a .sol domain is available by deriving its Solana Name Service PDA and checking whether the account exists on-chain. This is a read-only helper and does not require the historical Bonfida npm package. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to check for availability (with or without .sol suffix) |
Check availability for multiple .sol domains (up to 25) by deriving each SNS PDA and checking account existence on-chain. This is read-only and safe for hosted mode. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domains | array | no | Array of .sol domain names to batch-check for availability (1-25 domains) |
Resolve a .sol domain to its wallet/owner and configured SNS records using direct Solana Name Service account reads. Agents should treat TXT/Pic/Url records as optional metadata and fall back to the wallet owner when no SOL record exists. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime can
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to resolve to SAP agent identity and SNS records |
Validate SNS records for SAP agent compatibility (checks SOL, Pic, TXT records on-chain). SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 nativ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name whose SNS records should be validated for SAP agent compatibility |
Derive the Solana Name Service domain PDA for a .sol domain. This helper is deterministic, read-only, and does not require any external SNS SDK. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to derive the SNS domain PDA for |
Derive the Solana Name Service record PDA for a root .sol domain and record type such as SOL, TXT, Pic, Url, or IPFS. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to derive the record PDA for |
| recordType | string | no | The SNS record type for the PDA derivation (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.) |
Temporarily unavailable. SAP MCP does not currently publish an SNS registration write path because the historical Bonfida SNS npm package is not installable from npmjs. Use this tool only to receive the fail-fast status before any payment or signing attempt. SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid value-action; preview cost and transaction effects before use
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to register for the SAP agent (with or without .sol suffix) |
| agentWallet | string | no | The Solana public key (base58) of the SAP agent wallet that will own the domain |
| pic | string | no | Profile picture URL for the SNS Pic record (required if not provided in records.Pic) |
| records | object | no | Optional map of SNS record key-value pairs to set during registration (e.g. { "Url": "https://...", "Twitter": "@handle" }). Note: SOL record is skipped during registration. |
| sapData | object | no | Optional structured SAP metadata to embed in the domain TXT record (capabilities, protocols, endpoints, etc.) |
| capabilities | array | no | Optional list of SAP capability IDs to advertise in the domain TXT record |
| protocols | array | no | Optional list of protocol IDs the agent supports |
| setAsPrimary | boolean | no | Whether to set this domain as the agent primary .sol domain |
| durationYears | number | no | Registration duration in years (default: 1) |
| space | number | no | Storage space in bytes for the domain name account (default: 600) |
Fetch known SNS records for a .sol domain using direct Solana Name Service account reads. Returns a key-value map for records that exist and can be decoded. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to fetch all configured SNS records for |
Fetch a single SNS record value for a .sol domain using direct Solana Name Service account reads. Returns null if the record account is absent or empty. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost fir
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to fetch a record from |
| recordType | string | no | The SNS record type to fetch (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.) |
Resolve a .sol domain to a wallet public key. The tool prefers the SOL record when available and falls back to the domain owner field from the SNS account header. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to resolve to its owner wallet public key |
Check whether a wallet matches the resolved SNS wallet for a .sol domain. This uses the SOL record when present and the domain owner as fallback. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to check ownership of |
| owner | string | no | Canonical field: Solana public key (base58) of the wallet to verify as the domain owner |
| wallet | string | no | Alias for owner, accepted for agent ergonomics when the user says wallet. |
Temporarily unavailable. SAP MCP does not currently publish an SNS record write builder because the historical Bonfida SNS npm package is not installable from npmjs. The tool fails fast before payment or signing. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. R
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name whose record should be created, updated, or deleted |
| recordType | string | no | The SNS record type to manage (e.g. TXT, Url, IPFS, ETH, BTC, etc.) |
| value | string/null | no | The new record value as a string, or null to delete the record |
| owner | string | no | The Solana public key (base58) of the domain owner authorizing the record change |
Temporarily unavailable. Setting primary SNS domains is disabled in SAP MCP until the SNS write path is migrated to a current installable SDK and covered by end-to-end tests. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: hosted accountless write is bl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | no | The .sol domain name to set as primary for the owner |
| owner | string | no | The Solana public key (base58) of the domain owner setting their primary domain |
Fetch real SAP network statistics using synapse-sap-sdk DiscoveryRegistry and GlobalRegistry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime canno
| Parameter | Type | Required | Notes |
|---|---|---|---|
| detailed | boolean | no | Detailed parameter for Get SAP Network Statistics. |
Fetch the SOL balance for a wallet or account using the configured Solana RPC endpoint. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing
| Parameter | Type | Required | Notes |
|---|---|---|---|
| address | string | no | Wallet or account public key in base58 |
| pubkey | string | no | Alias for address |
| commitment | string | no | Optional commitment override |
Deploy a new SPL token with Metaplex metadata. Returns the mint address and an unsigned transaction. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token ope
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Token owner / mint authority wallet |
| name | string | yes | Token name (stored in Metaplex metadata) |
| symbol | string | yes | Token symbol (e.g. "MYTKN") |
| decimals | number | no | Token decimals (default: 9) |
| initialSupply | string | no | Raw token amount (smallest unit, no decimals) |
| uri | string | no | URI to off-chain metadata JSON (image, description, etc.) |
| isMutable | boolean | no | Whether metadata is mutable (default: true) |
| freezeAuthority | string | no | Solana public key (base58) |
| mintAuthority | string | no | Solana public key (base58) |
| sellerFeeBasisPoints | number | no | Royalty fee in bps (for fungible with metadata) |
Transfer SPL tokens between wallets. Optionally creates the recipient ATA. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the ag
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | Sender wallet address |
| to | string | yes | Recipient wallet address |
| mint | string | yes | Token mint address |
| amount | string | yes | Amount to transfer (raw, smallest unit) |
| createAta | boolean | no | Create recipient ATA if needed (default: true) |
| memo | string | no | Optional memo to attach to the transaction |
Transfer native SOL between wallets via SystemProgram.transfer. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the agent service
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | Sender wallet address |
| to | string | yes | Recipient wallet address |
| amount | string | yes | Amount in lamports (1 SOL = 1_000_000_000 lamports) |
| memo | string | no | Optional memo to attach |
Get token or SOL balance for a wallet. If mint is omitted, returns native SOL balance. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are pa
No parameter schema on file.
List all SPL token accounts for a wallet with balances and metadata. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the agent se
No parameter schema on file.
Mint additional tokens to a destination wallet (requires mint authority). SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the age
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address |
| mintAuthority | string | yes | Mint authority wallet |
| destination | string | yes | Wallet to receive minted tokens |
| amount | string | yes | Amount to mint (raw, smallest unit) |
Burn SPL tokens from the owner's token account. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the agent service lifecycle. SAP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) |
| owner | string | yes | Token account owner |
| amount | string | yes | Amount to burn |
Freeze a token account (prevents all transfers). Requires freeze authority. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) |
| account | string | yes | Token account to freeze |
| freezeAuthority | string | yes | Freeze authority wallet |
Thaw (unfreeze) a previously frozen token account. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the agent service lifecycle.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) |
| account | string | yes | Token account to thaw |
| freezeAuthority | string | yes | Freeze authority wallet |
Close a token account and reclaim the rent SOL. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token operations are part of the agent service lifecycle. SAP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | yes | Token account to close |
| owner | string | yes | Token account owner |
| destination | string | no | Solana public key (base58) |
Check a token for potential rug pull risks: mint/freeze authority, holder concentration, liquidity. SAP MCP context: Protocol spl-token; operation class write. Use for SPL token deploy, mint, transfer, burn, freeze, thaw, and authority management. Confirm mint, decimals, authority, recipient, and amount before writes. Use token tools alongside SAP payments and settlement tools only when token oper
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint to analyze |
Stake native SOL to a validator. Creates a stake account and delegates. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP execution g
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet to stake from |
| amount | string | yes | Amount in lamports to stake |
| validator | string | no | Solana public key (base58) |
Deactivate and withdraw SOL from a stake account. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP execution guidance: Intent: SAP M
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| stakeAccount | string | yes | Stake account to deactivate and withdraw |
List all stake accounts for a wallet with delegation status. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP execution guidance: In
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet to query stake accounts for |
Stake SOL for jupSOL (Jupiter liquid staking). Instant liquidity, auto-compounding. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| amount | string | yes | Amount in lamports to stake for jupSOL |
Unstake jupSOL back to SOL. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pric
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| amount | string | yes | Amount of jupSOL to unstake |
Stake SOL for sSOL via Solayer. Re-staking protocol with additional yield. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP executio
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| amount | string | yes | Amount in lamports to stake for sSOL |
Unstake sSOL back to SOL via Solayer. SAP MCP context: Protocol staking; operation class write. Use for SOL and liquid staking flows. Confirm validator or provider, amount, lockup/unstake terms, and account ownership before writes. Use SAP staking tools for SAP protocol stake accounts; use AgentKit staking tools for external staking protocols. SAP MCP execution guidance: Intent: SAP MCP tool work
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| amount | string | yes | Amount of sSOL to unstake |
Bridge tokens across chains via Wormhole. Supports Solana ↔ EVM chains. SAP MCP context: Protocol bridging; operation class write. Use for cross-chain asset movement through Wormhole or deBridge. Confirm source chain, destination chain, token mint, amount, recipient, route fees, and finality expectations before invoking a bridge write. For bridge flows call the matching status tool after submissio
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceChain | string | yes | Source chain identifier (e.g. "solana", "ethereum", "base", "polygon") |
| destinationChain | string | yes | Destination chain identifier |
| token | string | yes | Token address on source chain |
| amount | string | yes | Amount to bridge (raw, smallest unit) |
| sender | string | yes | Sender wallet on source chain |
| recipient | string | yes | Recipient address on destination chain |
| relayerFee | string | no | Raw token amount (smallest unit, no decimals) |
Check the status of a Wormhole bridge transfer. SAP MCP context: Protocol bridging; operation class read. Use to check Wormhole bridge transfer status after a bridge submission. Call this after bridging_bridgeWormhole and keep the resulting status with the user-facing bridge audit trail. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then us
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sequence | string | yes | Wormhole sequence number from bridgeWormhole response |
| sourceChain | string | yes | Source Chain parameter for Bridging Bridge Wormhole Status. |
Bridge tokens across chains via deBridge DLN. Fast cross-chain transfers with deterministic pricing. SAP MCP context: Protocol bridging; operation class write. Use for cross-chain asset movement through Wormhole or deBridge. Confirm source chain, destination chain, token mint, amount, recipient, route fees, and finality expectations before invoking a bridge write. For bridge flows call the matchin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceChain | number | yes | Source chain ID (e.g. 7565164 for Solana) |
| destinationChain | number | yes | Destination chain ID |
| tokenIn | string | yes | Token address on source chain |
| tokenOut | string | yes | Token address on destination chain (use "0x0" for native) |
| amount | string | yes | Amount to bridge (raw) |
| sender | string | yes | Sender address |
| recipient | string | yes | Recipient address on destination chain |
| slippageBps | number | no | Slippage tolerance in bps |
Check the status of a deBridge DLN cross-chain transfer. SAP MCP context: Protocol bridging; operation class read. Use to check deBridge transfer status after a bridge submission. Call this after bridging_bridgeDeBridge and keep the resulting status with the user-facing bridge audit trail. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then
| Parameter | Type | Required | Notes |
|---|---|---|---|
| orderId | string | yes | deBridge DLN order ID |
Deploy a new NFT collection via Metaplex. Returns the collection mint and metadata addresses. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For ag
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Collection authority wallet |
| name | string | yes | Collection name |
| symbol | string | yes | Collection symbol |
| uri | string | yes | URI to collection metadata JSON |
| sellerFeeBasisPoints | number | no | Royalty fee in bps (500 = 5%) |
| isMutable | boolean | no | Is Mutable parameter for Metaplex-nft Deploy Collection. |
| maxSupply | number | no | Max NFTs in collection (0 = unlimited) |
| creators | array | no | Creator list with revenue shares (must sum to 100) |
Mint a new NFT via Metaplex. Supports both standard and compressed (cNFT) minting. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Mint authority wallet |
| collection | string | no | NFT mint address (base58) |
| name | string | yes | NFT name |
| symbol | string | no | NFT symbol |
| uri | string | yes | URI to NFT metadata JSON (image, attributes, etc.) |
| sellerFeeBasisPoints | number | no | Seller Fee Basis Points parameter for Metaplex-nft Mint N F T. |
| isMutable | boolean | no | Is Mutable parameter for Metaplex-nft Mint N F T. |
| creators | array | no | Creators parameter for Metaplex-nft Mint N F T. |
| recipient | string | no | Solana public key (base58) |
| isCompressed | boolean | no | Mint as compressed NFT (cNFT) for lower cost |
| merkleTree | string | no | Solana public key (base58) |
Update NFT metadata fields (name, symbol, URI, creators, royalties, authority). SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address |
| updateAuthority | string | yes | Current update authority |
| name | string | no | New name |
| symbol | string | no | New symbol |
| uri | string | no | New metadata URI |
| sellerFeeBasisPoints | number | no | Seller Fee Basis Points parameter for Metaplex-nft Update Metadata. |
| creators | array | no | Creators parameter for Metaplex-nft Update Metadata. |
| isMutable | boolean | no | Is Mutable parameter for Metaplex-nft Update Metadata. |
| primarySaleHappened | boolean | no | Primary Sale Happened parameter for Metaplex-nft Update Metadata. |
| newUpdateAuthority | string | no | Solana public key (base58) |
Verify a creator on an NFT's metadata (requires creator's signature). SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity, plan with
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address (base58) |
| creator | string | yes | Creator wallet to verify |
Verify an NFT as part of a collection. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity, plan with sap_agent_identity_plan, regist
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint to verify |
| collection | string | yes | Collection mint |
| collectionAuthority | string | yes | Collection authority wallet |
Set and verify a collection on an NFT in a single transaction. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity, plan with sap_age
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address (base58) |
| collection | string | yes | NFT mint address (base58) |
| collectionAuthority | string | yes | Solana public key (base58) |
| updateAuthority | string | yes | NFT update authority |
Delegate a specific authority (update, mint, freeze, collection) to another wallet. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address (base58) |
| currentAuthority | string | yes | Solana public key (base58) |
| newAuthority | string | yes | Solana public key (base58) |
| authorityType | string | yes | Type of authority to delegate |
Revoke (remove) a specific authority. Irreversible for some types. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity, plan with sap
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address (base58) |
| authority | string | yes | Current authority holder |
| authorityType | string | yes | Authority Type parameter for Metaplex-nft Revoke Authority. |
Configure royalty fee and creator splits for an NFT. SAP MCP context: Protocol metaplex-nft; operation class write. Use for Metaplex NFT collection, mint, metadata, royalty, creator verification, collection verification, and authority workflows. Confirm metadata URI, collection mint, creators, royalties, update authority, and ownership before writes. For agent identity, plan with sap_agent_identit
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | NFT mint address (base58) |
| updateAuthority | string | yes | Solana public key (base58) |
| sellerFeeBasisPoints | number | yes | Royalty fee in bps |
| creators | array | yes | Creator list with revenue shares (must sum to 100) |
Create a new NFT collection on 3.Land marketplace. SAP MCP context: Protocol 3land; operation class write. Use for 3.Land NFT collection, minting, listing, cancellation, and purchase flows. Confirm marketplace price, seller/buyer wallet, collection, and listing state before writes. Pair marketplace actions with SAP registry metadata only when the marketplace asset is part of the agent identity or
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Collection owner wallet |
| name | string | yes | Collection name |
| symbol | string | yes | Collection symbol |
| description | string | no | Collection description |
| image | string | yes | Collection cover image URL |
| royaltyBps | number | no | Royalty Bps parameter for 3land Create Collection. |
| creators | array | no | Creators parameter for 3land Create Collection. |
Mint an NFT on 3.Land and automatically list it for sale. SAP MCP context: Protocol 3land; operation class write. Use for 3.Land NFT collection, minting, listing, cancellation, and purchase flows. Confirm marketplace price, seller/buyer wallet, collection, and listing state before writes. Pair marketplace actions with SAP registry metadata only when the marketplace asset is part of the agent ident
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Solana public key (base58) |
| collection | string | yes | 3.Land collection ID |
| name | string | yes | Name name or domain value used by 3land Mint And List. |
| description | string | no | Description parameter for 3land Mint And List. |
| image | string | yes | NFT image URL |
| attributes | array | no | Attributes parameter for 3land Mint And List. |
| price | string | yes | Listing price in token amount |
| priceMint | string | no | NFT mint address (base58) |
| supply | number | no | Edition supply |
List an NFT for sale on 3.Land in any SPL token. SAP MCP context: Protocol 3land; operation class write. Use for 3.Land NFT collection, minting, listing, cancellation, and purchase flows. Confirm marketplace price, seller/buyer wallet, collection, and listing state before writes. Pair marketplace actions with SAP registry metadata only when the marketplace asset is part of the agent identity or se
| Parameter | Type | Required | Notes |
|---|---|---|---|
| seller | string | yes | Solana public key (base58) |
| mint | string | yes | NFT mint to list |
| price | string | yes | Listing price (in specified token) |
| priceMint | string | no | NFT mint address (base58) |
| expiry | string | no | ISO 8601 listing expiry timestamp |
Cancel an active NFT listing on 3.Land. SAP MCP context: Protocol 3land; operation class write. Use for 3.Land NFT collection, minting, listing, cancellation, and purchase flows. Confirm marketplace price, seller/buyer wallet, collection, and listing state before writes. Pair marketplace actions with SAP registry metadata only when the marketplace asset is part of the agent identity or service cat
| Parameter | Type | Required | Notes |
|---|---|---|---|
| seller | string | yes | Solana public key (base58) |
| listingId | string | yes | 3.Land listing ID to cancel |
Purchase an NFT from a 3.Land listing. SAP MCP context: Protocol 3land; operation class write. Use for 3.Land NFT collection, minting, listing, cancellation, and purchase flows. Confirm marketplace price, seller/buyer wallet, collection, and listing state before writes. Pair marketplace actions with SAP registry metadata only when the marketplace asset is part of the agent identity or service cata
| Parameter | Type | Required | Notes |
|---|---|---|---|
| buyer | string | yes | Solana public key (base58) |
| listingId | string | yes | 3.Land listing ID |
Get detailed information about a single NFT/asset via DAS. SAP MCP context: Protocol das; operation class read. Use for read-only DAS NFT and asset discovery by owner, creator, collection, or search query. Prefer DAS reads before Metaplex writes when validating existing assets for an agent profile, collection, or metadata update. SAP MCP execution guidance: Intent: read/discovery workflow. Pricin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | Asset mint address |
Get all NFTs/assets owned by a wallet via DAS (supports pagination). SAP MCP context: Protocol das; operation class read. Use for read-only DAS NFT and asset discovery by owner, creator, collection, or search query. Prefer DAS reads before Metaplex writes when validating existing assets for an agent profile, collection, or metadata update. SAP MCP execution guidance: Intent: read/discovery workfl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ownerAddress | string | yes | Solana public key (base58) |
| page | number | no | Page pagination control for Das Get Assets By Owner. |
| limit | number | no | Limit controlling the maximum number of results returned by Das Get Assets By Owner. |
| sortBy | string | no | Sort By parameter for Das Get Assets By Owner. |
| before | string | no | Before parameter for Das Get Assets By Owner. |
| after | string | no | After parameter for Das Get Assets By Owner. |
Get all NFTs/assets created by a specific creator via DAS. SAP MCP context: Protocol das; operation class read. Use for read-only DAS NFT and asset discovery by owner, creator, collection, or search query. Prefer DAS reads before Metaplex writes when validating existing assets for an agent profile, collection, or metadata update. SAP MCP execution guidance: Intent: read/discovery workflow. Pricin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creatorAddress | string | yes | Solana public key (base58) |
| onlyVerified | boolean | no | Only Verified parameter for Das Get Assets By Creator. |
| page | number | no | Page pagination control for Das Get Assets By Creator. |
| limit | number | no | Limit controlling the maximum number of results returned by Das Get Assets By Creator. |
Get all NFTs in a collection via DAS. SAP MCP context: Protocol das; operation class read. Use for read-only DAS NFT and asset discovery by owner, creator, collection, or search query. Prefer DAS reads before Metaplex writes when validating existing assets for an agent profile, collection, or metadata update. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| collectionAddress | string | yes | NFT mint address (base58) |
| page | number | no | Page pagination control for Das Get Assets By Collection. |
| limit | number | no | Limit controlling the maximum number of results returned by Das Get Assets By Collection. |
Search NFTs/assets with flexible filters via DAS. SAP MCP context: Protocol das; operation class read. Use for read-only DAS NFT and asset discovery by owner, creator, collection, or search query. Prefer DAS reads before Metaplex writes when validating existing assets for an agent profile, collection, or metadata update. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ownerAddress | string | no | Solana public key (base58) |
| creatorAddress | string | no | Solana public key (base58) |
| grouping | no | Grouping key-value pair (e.g. ["collection", "mint_address"]) | |
| compressed | boolean | no | Compressed parameter for Das Search Assets. |
| frozen | boolean | no | Frozen parameter for Das Search Assets. |
| burnt | boolean | no | Burnt parameter for Das Search Assets. |
| jsonUri | string | no | Json URI parameter for Das Search Assets. |
| page | number | no | Page pagination control for Das Search Assets. |
| limit | number | no | Limit controlling the maximum number of results returned by Das Search Assets. |
Launch a new token on Pump.fun via PumpPortal. Optionally include an initial dev buy. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution gui
| Parameter | Type | Required | Notes |
|---|---|---|---|
| deployer | string | yes | Deployer wallet |
| name | string | yes | Token name |
| symbol | string | yes | Token ticker |
| description | string | no | Description parameter for Pump Launch Token. |
| image | string | no | Token logo URL |
| string | no | Twitter/X handle | |
| telegram | string | no | Telegram group link |
| website | string | no | Website URL |
| initialBuyAmount | string | no | Raw token amount (smallest unit) |
Buy or sell tokens on Pump.fun bonding curve. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: Solana value-action or tr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| mint | string | yes | Pump.fun token mint |
| action | string | yes | Trade direction |
| amount | string | yes | Amount in SOL (buy) or tokens (sell) |
| slippageBps | number | no | Slippage Bps pagination control for Pump Trade. |
Create a Raydium CPMM (Constant Product Market Maker) pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP too
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| mintA | string | yes | Token A mint |
| mintB | string | yes | Token B mint |
| amountA | string | yes | Initial liquidity for token A |
| amountB | string | yes | Initial liquidity for token B |
| startTime | number | no | Pool start time (Unix timestamp) |
Create a Raydium CLMM (Concentrated Liquidity) pool with a price range. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| mintA | string | yes | Token mint address (base58) |
| mintB | string | yes | Token mint address (base58) |
| initialPrice | number | yes | Initial price of token A in terms of token B |
| tickSpacing | number | yes | Tick spacing (defines fee tier: 1=0.01%, 10=0.05%, 60=0.3%, 200=1%) |
| amountA | string | yes | Initial liquidity for token A |
| amountB | string | yes | Initial liquidity for token B |
| priceLower | number | yes | Lower price bound for liquidity range |
| priceUpper | number | yes | Upper price bound for liquidity range |
| startTime | number | no | Start Time parameter for Raydium-pools Create C L M M. |
Create a Raydium AMM v4 pool (requires an existing Openbook market). SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SA
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| marketId | string | yes | Openbook market ID |
| baseAmount | string | yes | Raw token amount (smallest unit) |
| quoteAmount | string | yes | Raw token amount (smallest unit) |
| startTime | number | no | Start Time parameter for Raydium-pools Create A M Mv4. |
Add liquidity to a Raydium pool (CPMM, CLMM, or AMM v4). SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool w
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| poolId | string | yes | Raydium pool ID |
| amountA | string | no | Raw token amount (smallest unit) |
| amountB | string | no | Raw token amount (smallest unit) |
| priceLower | number | no | Lower price for CLMM range |
| priceUpper | number | no | Upper price for CLMM range |
| fixedSide | string | no | Fixed side for single-sided liquidity |
Remove liquidity from a Raydium pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| poolId | string | yes | Solana public key (base58) |
| lpAmount | string | no | Raw token amount (smallest unit) |
| positionNft | string | no | Token mint address (base58) |
| percentage | number | no | Percentage of liquidity to remove |
Get Orca Whirlpool pool information. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Whirlpool pool address |
Swap tokens on an Orca Whirlpool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: Solana value-action or trading workfl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| poolAddress | string | yes | Solana public key (base58) |
| inputMint | string | yes | Token mint address (base58) |
| amount | string | yes | Raw token amount (smallest unit) |
| slippageBps | number | no | Slippage Bps pagination control for Orca Swap. |
| isExactInput | boolean | no | Is Exact Input parameter for Orca Swap. |
Open a concentrated liquidity position on an Orca Whirlpool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP to
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| poolAddress | string | yes | Solana public key (base58) |
| priceLower | number | yes | Price Lower parameter for Orca Open Position. |
| priceUpper | number | yes | Price Upper parameter for Orca Open Position. |
| amountA | string | no | Raw token amount (smallest unit) |
| amountB | string | no | Raw token amount (smallest unit) |
Close a Whirlpool position and collect all fees/rewards. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool w
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionMint | string | yes | Token mint address (base58) |
Collect accumulated fees from a Whirlpool position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workfl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionMint | string | yes | Token mint address (base58) |
Create a new Manifest market for a token pair. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| baseMint | string | yes | Base token mint |
| quoteMint | string | yes | Quote token mint |
Place a limit order on a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| marketId | string | yes | Solana public key (base58) |
| side | string | yes | Side parameter for Manifest Place Limit Order. |
| price | number | yes | Limit price |
| size | string | yes | Order size in base tokens |
| orderType | string | no | Order Type parameter for Manifest Place Limit Order. |
Cancel a limit order on a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Prici
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| marketId | string | yes | Solana public key (base58) |
| orderId | string | yes | Order ID parameter for Manifest Cancel Order. |
Get the current orderbook for a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/discovery workflo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| marketId | string | yes | Solana public key (base58) |
| depth | number | no | Depth parameter for Manifest Get Orderbook. |
Create a Meteora Dynamic AMM pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| mintA | string | yes | Token mint address (base58) |
| mintB | string | yes | Token mint address (base58) |
| amountA | string | yes | Raw token amount (smallest unit) |
| amountB | string | yes | Raw token amount (smallest unit) |
| tradeFeeNumerator | number | no | Trade fee numerator (default pool fee) |
| tradeFeeDenominator | number | no | Trade Fee Denominator parameter for Meteora Create Dynamic Pool. |
| activationType | string | no | Activation Type parameter for Meteora Create Dynamic Pool. |
| activationPoint | number | no | Activation slot/timestamp |
Create a Meteora DLMM (Discrete Liquidity Market Maker) pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| mintX | string | yes | Token X mint |
| mintY | string | yes | Token Y mint |
| binStep | number | yes | Bin step size (defines fee tier and price granularity) |
| initialPrice | number | yes | Initial Price parameter for Meteora Create D L M M Pool. |
| amountX | string | no | Raw token amount (smallest unit) |
| amountY | string | no | Raw token amount (smallest unit) |
| priceRoundingUp | boolean | no | Price Rounding Up parameter for Meteora Create D L M M Pool. |
| feeBps | number | no | Fee Bps parameter for Meteora Create D L M M Pool. |
| activationType | string | no | Activation Type parameter for Meteora Create D L M M Pool. |
| activationPoint | number | no | Activation Point parameter for Meteora Create D L M M Pool. |
Add liquidity to a Meteora DLMM pool with a distribution strategy. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| poolAddress | string | yes | Solana public key (base58) |
| amountX | string | yes | Raw token amount (smallest unit) |
| amountY | string | yes | Raw token amount (smallest unit) |
| strategy | string | no | Liquidity distribution strategy |
| minBinId | number | no | Min Bin ID parameter for Meteora Add D L M M Liquidity. |
| maxBinId | number | no | Max Bin ID parameter for Meteora Add D L M M Liquidity. |
Remove liquidity from a Meteora DLMM position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionAddress | string | yes | Solana public key (base58) |
| percentage | number | no | Percentage parameter for Meteora Remove D L M M Liquidity. |
Create a Meteora Alpha Vault for fair token launches with vesting. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| poolAddress | string | yes | Solana public key (base58) |
| depositMint | string | yes | Token mint accepted for deposits |
| maxDeposit | string | yes | Maximum deposit cap |
| vestingDuration | number | yes | Vesting duration in seconds |
| startTime | number | no | Vault start time (Unix timestamp) |
Create a new Openbook DEX market for a token pair. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| baseMint | string | yes | Token mint address (base58) |
| quoteMint | string | yes | Token mint address (base58) |
| lotSize | number | yes | Minimum order size |
| tickSize | number | yes | Minimum price increment |
Place an order on an Openbook market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| marketId | string | yes | Solana public key (base58) |
| side | string | yes | Side parameter for Openbook Place Order. |
| price | number | yes | Price parameter for Openbook Place Order. |
| size | string | yes | Raw token amount (smallest unit) |
| orderType | string | no | Order Type parameter for Openbook Place Order. |
Cancel an open order on an Openbook market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pric
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| marketId | string | yes | Solana public key (base58) |
| orderId | string | yes | Order ID parameter for Openbook Cancel Order. |
Open a leveraged perpetual position on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool wo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| market | string | yes | Market symbol (e.g. "SOL", "BTC", "ETH") |
| collateralMint | string | yes | Collateral token mint (e.g. USDC, SOL) |
| collateralAmount | string | yes | Raw token amount (smallest unit) |
| side | string | yes | Side parameter for Adrena Open Position. |
| leverage | number | yes | Leverage multiplier |
| stopLoss | number | no | Stop loss price |
| takeProfit | number | no | Take profit price |
Close a perpetual position on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionKey | string | yes | Solana public key (base58) |
Add collateral to an existing Adrena position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionKey | string | yes | Solana public key (base58) |
| amount | string | yes | Raw token amount (smallest unit) |
Remove collateral from an Adrena position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Prici
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| positionKey | string | yes | Solana public key (base58) |
| amount | string | yes | Raw token amount (smallest unit) |
Get all open positions on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/discovery workflow. Pri
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
Deposit into the best APR lending protocol via Lulo aggregator. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| mint | string | yes | Token to deposit (e.g. USDC) |
| amount | string | yes | Raw token amount (smallest unit) |
Withdraw from Lulo lending position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| mint | string | yes | Token mint address (base58) |
| amount | string | yes | Raw token amount (smallest unit) |
Get the best lending/yield rates across all protocols via Lulo. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/di
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | no | Token mint address (base58) |
Get all Lulo lending positions for a wallet. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/discovery workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
Send a Jito bundle for MEV-protected, atomic transaction execution. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: SAP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transactions | array | yes | Array of base64-encoded signed transactions (max 5) |
| tipLamports | string | no | Raw token amount (smallest unit) |
Check the status of a submitted Jito bundle. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent: read/discovery workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| bundleId | string | yes | Bundle ID parameter for Jito Get Bundle Status. |
Get current Jito tip percentile estimates for bundle inclusion priority. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_agent_identity_plan, sap_payments_register_agent, sap_payments_update_agent, and sap_publish_tool_by_name when the capability should become part of an on-chain SAP agent profile or tool registry entry. SAP MCP execution guidance: Intent
No parameter schema on file.
Resolve a .sol domain to its owner wallet address. SAP MCP context: Protocol sns; operation class read. Use to resolve a .sol domain through AgentKit SNS helpers. For SAP-linked domains, prefer sap_sns_resolve_domain because it returns SAP MCP-shaped context. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned tran
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | yes | Full domain name (e.g. "myname.sol") |
Reverse-lookup all .sol domains owned by a wallet. SAP MCP context: Protocol sns; operation class read. Use to find the SNS domain associated with a wallet. For SAP profile checks, pair this with sap_sns_resolve_wallet or sap_sns_check_ownership. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions loca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet address to reverse-lookup |
Register a domain on AllDomains (supports multiple TLDs: .abc, .bonk, .poor, etc.). SAP MCP context: Protocol alldomains; operation class write. Use for AllDomains name registration and resolution workflows. Confirm domain, TLD, owner, and renewal or purchase terms before writes. Use only when the requested name service is not SNS-specific. SAP MCP execution guidance: Intent: local-signer write w
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| domain | string | yes | Full domain (e.g. "myname.abc", "trader.bonk") |
| tld | string | no | TLD if not included in domain string |
Resolve a multi-TLD domain to its owner wallet. SAP MCP context: Protocol alldomains; operation class read. Use to resolve an AllDomains name without changing ownership or records. Use only when the requested name service is not SNS-specific. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | yes | Full domain to resolve |
Get all domains owned by a wallet across all TLDs. SAP MCP context: Protocol alldomains; operation class read. Use to list domains owned by a wallet through AllDomains. Use as discovery context before choosing a name to associate with an agent. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions loca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| tld | string | no | Filter by TLD |
Get the current price from a Pyth on-chain oracle feed. SAP MCP context: Protocol pyth; operation class read. Use for Pyth oracle price reads and feed discovery. Use oracle reads as context for pricing, risk checks, and market-aware agent decisions; do not treat them as settlement proof. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| priceId | string | yes | Pyth price feed ID (hex) or symbol (e.g. "SOL/USD") |
Get historical price data from Pyth oracle. SAP MCP context: Protocol pyth; operation class read. Use for Pyth oracle price reads and feed discovery. Use oracle reads as context for pricing, risk checks, and market-aware agent decisions; do not treat them as settlement proof. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_paym
| Parameter | Type | Required | Notes |
|---|---|---|---|
| priceId | string | yes | Price ID parameter for Pyth Get Price History. |
| period | string | no | Period parameter for Pyth Get Price History. |
List available Pyth price feeds, optionally filtered by query or asset type. SAP MCP context: Protocol pyth; operation class read. Use for Pyth oracle price reads and feed discovery. Use oracle reads as context for pricing, risk checks, and market-aware agent decisions; do not treat them as settlement proof. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Search filter (e.g. "SOL", "BTC") |
| assetType | string | no | Asset Type parameter for Pyth List Price Feeds. |
Get token price and market data from CoinGecko. SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tokenId | string | yes | CoinGecko token ID or contract address |
| vsCurrency | string | no | Vs Currency parameter for Coingecko Get Token Price. |
| includeMarketCap | boolean | no | Include Market Cap parameter for Coingecko Get Token Price. |
| include24hChange | boolean | no | Include24h Change parameter for Coingecko Get Token Price. |
| include24hVolume | boolean | no | Include24h Volume parameter for Coingecko Get Token Price. |
Get trending tokens and NFTs on CoinGecko. SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premi
No parameter schema on file.
Get top gainers and losers from CoinGecko. SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vsCurrency | string | no | Vs Currency parameter for Coingecko Get Top Gainers Losers. |
| duration | string | no | Duration parameter for Coingecko Get Top Gainers Losers. |
Get detailed token information from CoinGecko (description, links, market data). SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discov
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tokenId | string | yes | CoinGecko token ID |
Get all liquidity pools for a token from CoinGecko on-chain DEX tracker. SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discovery work
| Parameter | Type | Required | Notes |
|---|---|---|---|
| network | string | no | Network Solana network or cluster selector for Coingecko Get Pools By Token. |
| tokenAddress | string | yes | Token contract/mint address |
| page | number | no | Page pagination control for Coingecko Get Pools By Token. |
Get OHLCV (price chart) data from CoinGecko. SAP MCP context: Protocol coingecko; operation class read. Use for off-chain market data such as token prices, trending assets, token info, pools, and OHLCV. Use market data as advisory context. On-chain SAP settlement and escrow state remain authoritative for payments. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-pre
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tokenId | string | yes | Token ID mint, symbol, or token identifier used by Coingecko Get O H L C V. |
| vsCurrency | string | no | Vs Currency parameter for Coingecko Get O H L C V. |
| days | string | no | Days parameter for Coingecko Get O H L C V. |
Create a new bounty on Gib Work with on-chain escrow. SAP MCP context: Protocol gibwork; operation class write. Use for bounty creation, listing, and work submission. Confirm scope, payout, recipient, and deliverable evidence before writes. Use SAP attestation or feedback tools after work completion when reputation should be recorded on SAP. SAP MCP execution guidance: Intent: SAP MCP tool workfl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| creator | string | yes | Solana public key (base58) |
| title | string | yes | Bounty title |
| description | string | yes | Detailed bounty description |
| rewardMint | string | no | Token mint address (base58) |
| rewardAmount | string | yes | Reward amount |
| tags | array | no | Tags parameter for Gibwork Create Bounty. |
| deadline | number | no | Deadline (Unix timestamp) |
List available bounties on Gib Work. SAP MCP context: Protocol gibwork; operation class write. Use for bounty creation, listing, and work submission. Confirm scope, payout, recipient, and deliverable evidence before writes. Use SAP attestation or feedback tools after work completion when reputation should be recorded on SAP. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Status parameter for Gibwork List Bounties. |
| tags | array | no | Tags parameter for Gibwork List Bounties. |
| limit | number | no | Limit controlling the maximum number of results returned by Gibwork List Bounties. |
Submit completed work for a Gib Work bounty. SAP MCP context: Protocol gibwork; operation class write. Use for bounty creation, listing, and work submission. Confirm scope, payout, recipient, and deliverable evidence before writes. Use SAP attestation or feedback tools after work completion when reputation should be recorded on SAP. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Prici
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| bountyId | string | yes | Bounty ID parameter for Gibwork Submit Work. |
| submissionUrl | string | yes | URL to the completed work (PR, doc, etc.) |
| notes | string | no | Notes parameter for Gibwork Submit Work. |
List available games on Send Arcade. SAP MCP context: Protocol send-arcade; operation class write. Use for Send Arcade game listing and play flows. Confirm account, wager or spend, and game rules before writes. Keep gaming activity separate from SAP identity unless it is intentionally part of an agent profile. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Status parameter for Send-arcade List Games. |
Enter and play a game on Send Arcade (pays entry fee via transaction). SAP MCP context: Protocol send-arcade; operation class write. Use for Send Arcade game listing and play flows. Confirm account, wager or spend, and game rules before writes. Keep gaming activity separate from SAP identity unless it is intentionally part of an agent profile. SAP MCP execution guidance: Intent: SAP MCP tool work
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Solana public key (base58) |
| gameId | string | yes | Game ID parameter for Send-arcade Play Game. |
| betAmount | string | no | Raw token amount (smallest unit) |
Fetch metadata for a Solana Action (Blink) — returns title, description, available actions, and parameters. SAP MCP context: Protocol blinks; operation class read. Use for Solana Actions and Blinks metadata fetch, validation, and POST action preparation. Preview and validate actions before signing or submitting transactions through SAP transaction tools. SAP MCP execution guidance: Intent: read/d
| Parameter | Type | Required | Notes |
|---|---|---|---|
| actionUrl | string | yes | Solana Action URL (https endpoint implementing the Actions spec) |
Execute a Solana Action — sends wallet to the Action endpoint and receives a transaction to sign. SAP MCP context: Protocol blinks; operation class write. Use to execute a Solana Action POST flow. Confirm the action metadata, parameters, expected transaction, and user intent before invoking. Preview and validate action output before signing or submitting any returned transaction through SAP transa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| actionUrl | string | yes | Action endpoint URL (from getAction links) |
| wallet | string | yes | User wallet to sign the transaction |
| params | object | no | Key-value parameters to fill Action template variables |
Confirm a completed Solana Action by sending the tx signature back to the Action provider. SAP MCP context: Protocol blinks; operation class read. Use for Solana Actions and Blinks metadata fetch, validation, and POST action preparation. Preview and validate actions before signing or submitting transactions through SAP transaction tools. SAP MCP execution guidance: Intent: SAP MCP tool workflow.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| actionUrl | string | yes | Action URL parameter for Blinks Confirm Action. |
| signature | string | yes | Transaction signature after signing and submitting |
Resolve a Blink URL (e.g. dial.to link) to its underlying Solana Action URL. SAP MCP context: Protocol blinks; operation class read. Use for Solana Actions and Blinks metadata fetch, validation, and POST action preparation. Preview and validate actions before signing or submitting transactions through SAP transaction tools. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| blinkUrl | string | yes | Blink URL (e.g. https://dial.to/?action=solana-action:...) |
Validate a domain's actions.json file — checks if a website correctly implements the Solana Actions spec. SAP MCP context: Protocol blinks; operation class read. Use for Solana Actions and Blinks metadata fetch, validation, and POST action preparation. Preview and validate actions before signing or submitting transactions through SAP transaction tools. SAP MCP execution guidance: Intent: SAP MCP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| domain | string | yes | Domain to check for actions.json (e.g. "jupiter.exchange") |
Build and optionally wrap a Solana Action URL for sharing as a Blink. SAP MCP context: Protocol blinks; operation class read. Use for Solana Actions and Blinks metadata fetch, validation, and POST action preparation. Preview and validate actions before signing or submitting transactions through SAP transaction tools. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder
| Parameter | Type | Required | Notes |
|---|---|---|---|
| baseUrl | string | yes | Action API endpoint |
| params | object | no | Template parameters to encode |
| blinkProvider | string | no | Optionally wrap in a Blink provider URL |
Get a quote + unsigned swap transaction in a single call (Ultra API). The recommended entry-point for swaps. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery w
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputMint | string | yes | Token mint address (base58) |
| outputMint | string | yes | Token mint address (base58) |
| amount | string | yes | Raw token amount as string (no decimals) |
| taker | string | yes | Taker (sender) wallet address |
| slippageBps | number | no | Slippage tolerance in bps (e.g. 50 = 0.5%) |
| referralAccount | string | no | Solana wallet public key (base58) |
| referralFeeBps | number | no | Referral fee in bps |
Execute a signed swap transaction obtained from getOrder and receive execution status. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid v
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | yes | Base64-encoded signed transaction |
| requestId | string | yes | requestId from getOrder response |
Fetch token balances and holdings for specific token accounts, including USD valuations. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tokenAccountAddresses | array | yes | Array of token account addresses to query balances for |
Check token mints for potential security risks (honeypot, freeze authority, low liquidity, etc.). SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pric
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mints | array | yes | Token mints to check |
Search for tokens by symbol, name, or mint address. Returns matching tokens with metadata. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Search by token symbol, name, or mint address |
Get an optimally-routed swap quote with full route plan details (Metis engine). SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputMint | string | yes | Token mint address (base58) |
| outputMint | string | yes | Token mint address (base58) |
| amount | string | yes | Raw token amount as string (no decimals) |
| slippageBps | number | no | Slippage tolerance in bps (e.g. 50 = 0.5%) |
| swapMode | string | no | Swap Mode parameter for Jupiter Get Quote. |
| onlyDirectRoutes | boolean | no | Restrict to single-hop routes |
| asLegacyTransaction | boolean | no | Return a legacy transaction |
| maxAccounts | number | no | Max accounts in transaction (default 64) |
| platformFeeBps | number | no | Platform fee in bps |
| restrictIntermediateTokens | boolean | no | Restrict Intermediate Tokens mint, symbol, or token identifier used by Jupiter Get Quote. |
| dynamicSlippage | boolean | no | Dynamic Slippage pagination control for Jupiter Get Quote. |
Build an unsigned swap transaction from a quote response. Sign and send the returned transaction. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: Solana value-action or trad
| Parameter | Type | Required | Notes |
|---|---|---|---|
| userPublicKey | string | yes | Solana wallet public key (base58) |
| wrapAndUnwrapSol | boolean | no | Auto wrap/unwrap SOL (default true) |
| useSharedAccounts | boolean | no | Use Shared Accounts parameter for Jupiter Swap. |
| feeAccount | string | no | Solana wallet public key (base58) |
| computeUnitPriceMicroLamports | number | no | Priority fee in µ-lamports/CU |
| asLegacyTransaction | boolean | no | As Legacy Transaction transaction payload used by Jupiter Swap. |
| useTokenLedger | boolean | no | Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap. |
| destinationTokenAccount | string | no | Solana wallet public key (base58) |
| dynamicComputeUnitLimit | boolean | no | Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap. |
| skipUserAccountsRpcCalls | boolean | no | Skip User Accounts RPC Calls endpoint or RPC selector used by Jupiter Swap. |
| dynamicSlippage | boolean | no | Dynamic Slippage pagination control for Jupiter Swap. |
| quoteResponse | object | yes | The full quoteResponse object from getQuote |
Get individual swap instructions instead of a full transaction. Useful for composing with other instructions. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: Solana value-ac
| Parameter | Type | Required | Notes |
|---|---|---|---|
| userPublicKey | string | yes | Solana wallet public key (base58) |
| wrapAndUnwrapSol | boolean | no | Wrap And Unwrap Sol parameter for Jupiter Swap Instructions. |
| useSharedAccounts | boolean | no | Use Shared Accounts parameter for Jupiter Swap Instructions. |
| feeAccount | string | no | Solana wallet public key (base58) |
| computeUnitPriceMicroLamports | number | no | Compute Unit Price Micro Lamports value to use for Jupiter Swap Instructions. |
| asLegacyTransaction | boolean | no | As Legacy Transaction transaction payload used by Jupiter Swap Instructions. |
| useTokenLedger | boolean | no | Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap Instructions. |
| destinationTokenAccount | string | no | Solana wallet public key (base58) |
| dynamicComputeUnitLimit | boolean | no | Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap Instructions. |
| quoteResponse | object | yes | The full quoteResponse object from getQuote |
Get a mapping from program ID to human-readable label for all DEX programs in the routing engine. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pric
No parameter schema on file.
Get real-time heuristic prices for tokens. Supports buy/sell price, confidence, and depth info. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. Parameter aliases accepted by SAP MCP: mint/id/token/address -> id
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ids | array | yes | Token mints to price |
| vsToken | string | no | Token mint address (base58) |
| showExtraInfo | boolean | no | Include confidence, depth, timestamps |
Get Jupiter tokens by tag ("verified" or "lst"). Returns token metadata, organic score, price, and audit info. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Tag to filter by — "verified" or "lst" |
Search for token information by mint address, symbol, or name. Returns detailed metadata, price, organic score, and audit info. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Inten
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Search by mint address, symbol, or name. Comma-separate for multiple (max 100) |
Create a limit order. Returns an unsigned transaction — sign and submit via executeTrigger. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: p
| Parameter | Type | Required | Notes |
|---|---|---|---|
| maker | string | yes | Wallet address of the order creator |
| payer | string | yes | Wallet paying for transaction fees |
| inputMint | string | yes | Input token mint |
| outputMint | string | yes | Output token mint |
| makingAmount | string | yes | Amount of input token to sell |
| takingAmount | string | yes | Amount of output token to receive |
| expiredAt | string | no | ISO 8601 expiry timestamp |
| feeBps | number | no | Referral fee in bps |
| computeUnitPrice | string | no | Priority fee (µ-lamports/CU) |
Submit a signed limit-order transaction for on-chain execution. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview co
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | yes | Base64-encoded signed transaction |
| requestId | string | yes | Request ID from createLimitOrder response |
Create an unsigned transaction to cancel a specific limit order. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview c
| Parameter | Type | Required | Notes |
|---|---|---|---|
| maker | string | yes | Solana wallet public key (base58) |
| order | string | yes | Order public key to cancel |
| computeUnitPrice | string | no | Compute Unit Price parameter for Jupiter Cancel Limit Order. |
Create unsigned transactions to cancel multiple limit orders in batch. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; pre
| Parameter | Type | Required | Notes |
|---|---|---|---|
| maker | string | yes | Solana wallet public key (base58) |
| orders | array | yes | Array of order public keys to cancel |
| computeUnitPrice | string | no | Compute Unit Price parameter for Jupiter Cancel Limit Orders. |
Get all limit orders (active and optionally historical) for a wallet. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; es
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet address to query |
| orderStatus | string | yes | Filter by order status: "active" for open orders, "history" for filled/cancelled |
| inputMint | string | no | Token mint address (base58) |
| outputMint | string | no | Token mint address (base58) |
| page | number | no | Page pagination control for Jupiter Get Limit Orders. |
| limit | number | no | Limit controlling the maximum number of results returned by Jupiter Get Limit Orders. |
Create a Dollar-Cost Averaging (DCA) recurring order. Returns an unsigned transaction. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid v
| Parameter | Type | Required | Notes |
|---|---|---|---|
| payer | string | yes | Wallet paying for the DCA setup |
| user | string | yes | Wallet executing the DCA |
| inputMint | string | yes | Token mint address (base58) |
| outputMint | string | yes | Token mint address (base58) |
| totalInAmount | string | yes | Total amount of input token to DCA |
| frequency | string | yes | DCA interval |
| numberOfOrders | number | yes | Total number of orders to split into |
| minOutAmountPerOrder | string | no | Raw token amount as string (no decimals) |
| maxOutAmountPerOrder | string | no | Raw token amount as string (no decimals) |
| startAt | string | no | ISO 8601 start timestamp (default: now) |
Submit a signed DCA order creation/cancellation transaction. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | yes | Base64-encoded signed transaction |
| requestId | string | yes | Request ID from createDCA response |
Create an unsigned transaction to cancel a DCA recurring order. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview co
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | yes | Wallet that owns the DCA order |
| order | string | yes | DCA order public key to cancel |
| recurringType | string | yes | Recurring order type — "time" for time-based DCA, "price" for price-triggered |
| computeUnitPrice | string | no | Compute Unit Price parameter for Jupiter Cancel D C A. |
Get all DCA orders (active and optionally historical) for a wallet. SAP MCP context: Jupiter protocol tools are served as AgentKit ecosystem tools. Use them for quote, route, and swap preparation, then use SAP transaction preview/sign/submit tools when an unsigned transaction must pass MCP signer policy. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; esti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| user | string | yes | Wallet address to query (sent as "user" query param to Jupiter) |
| recurringType | string | yes | Recurring order type — "time" for time-based DCA, "price" for price-triggered, "all" for both |
| orderStatus | string | yes | Filter by order status: "active" for running orders, "history" for completed/cancelled |
| includeFailedTx | boolean | no | Include failed transactions in results (default: false) |
| inputMint | string | no | Token mint address (base58) |
| outputMint | string | no | Token mint address (base58) |
| page | number | no | Page pagination control for Jupiter Get D C A Orders. |
| limit | number | no | Limit controlling the maximum number of results returned by Jupiter Get D C A Orders. |
Smart Swap — all-in-one compound tool that fetches a quote and builds swap instructions in a single call. Provide input/output mints, amount, and wallet address to get back a quote, individual swap instructions, and a human-readable summary. The returned instructions can be assembled into a transaction and signed. This is the recommended entry-point for AI agents preparing a swap. SAP MCP context:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputMint | string | yes | Source token mint address |
| outputMint | string | yes | Destination token mint address |
| amount | string | yes | Raw token amount to swap (in smallest unit, no decimals) |
| userPublicKey | string | yes | Wallet public key that will sign the transaction |
| slippageBps | number | no | Slippage tolerance in bps (e.g. 50 = 0.5%) |
| swapMode | string | no | Swap mode (default: ExactIn) |
| onlyDirectRoutes | boolean | no | Restrict to single-hop routes for lower latency |
| dynamicSlippage | boolean | no | Enable dynamic slippage for better execution |
| asLegacyTransaction | boolean | no | Return a legacy transaction instead of v0 |
| wrapAndUnwrapSol | boolean | no | Auto wrap/unwrap SOL (default: true) |
| destinationTokenAccount | string | no | Solana wallet public key (base58) |
| computeUnitPriceMicroLamports | number | no | Priority fee in micro-lamports per compute unit |
| dynamicComputeUnitLimit | boolean | no | Use dynamic compute unit limit based on simulation |
| maxAccounts | number | no | Max accounts in transaction (default: 64) |
| platformFeeBps | number | no | Platform fee in bps for referral revenue |
| feeAccount | string | no | Solana wallet public key (base58) |
| restrictIntermediateTokens | boolean | no | Restrict intermediate tokens to reduce risk |
Decode a serialized Solana transaction and return stable transaction metadata. Use this before signing when a SAP MCP, Jupiter, MagicBlock, SNS, Metaplex, or DeFi tool returns transactionBase64 or an unsigned transaction. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction | string | no | Serialized transaction |
| encoding | string | no | Input encoding |
Preview a Solana transaction before signing or submission. This is the required preflight step for agent workflows; do not create local signing scripts or read keypair files. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders nev
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction | string | no | Serialized transaction |
| encoding | string | no | Input encoding |
Sign a serialized Solana transaction with the configured SAP MCP signer after sap_preview_transaction. This is the supported non-custodial signing path for agents; never read keypair JSON or sign raw message bytes in temporary scripts. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction | string | no | Unsigned or partially signed transaction |
| encoding | string | no | Input encoding |
Submit a signed Solana transaction produced by sap_sign_transaction through the configured RPC endpoint. Use this instead of custom sendRawTransaction scripts so policy, retries, and audit stay inside SAP MCP. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid value-action; preview cost and transaction effects before user confirmation. Routing: paid hosted call; call sap_est
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | no | Signed serialized transaction |
| encoding | string | no | Input encoding |
| skipPreflight | boolean | no | Skip RPC preflight checks |
| maxRetries | number | no | Maximum RPC send retries |
| confirmationTimeoutMs | number | no | Bounded confirmation wait in milliseconds. Defaults to 90000; maximum 180000. |
| commitment | string | no | Desired confirmation status before returning success. Defaults to confirmed. |
| submitViaRelay | boolean | no | When true, submit through the hosted OOBE relay. The relay only broadcasts already-signed bytes and never signs. Defaults to false for this local tool. |
| submitRelayUrl | string | no | Optional submit relay URL. Must be HTTPS, localhost, or 127.0.0.1. |
| intentId | string | no | Optional caller-provided id binding submission, confirmation, and audit output. |
Build an unsigned native SOL transfer transaction using SystemProgram.transfer. Returns serialized base64 transaction for the agent to sign locally with sap_payments_finalize_transaction or sap_sign_transaction → sap_submit_signed_transaction. This is the hosted-safe equivalent of spl-token_transferSol (which is local-signer-only and cannot run on the hosted accountless server). Builder fee applie
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromPubkey | string | no | Sender public key in base58. This is the fee payer and must sign the transaction locally. |
| toPubkey | string | no | Recipient public key in base58. |
| lamports | number | no | Amount in lamports (1 SOL = 1,000,000,000 lamports). Use sap_estimate_tool_cost to check the builder fee before calling. |
Build an unsigned SPL token transfer transaction. Returns serialized base64 transaction for the agent to sign locally with sap_payments_finalize_transaction or sap_sign_transaction → sap_submit_signed_transaction. This is the hosted-safe equivalent of spl-token_transfer (which is local-signer-only and cannot run on the hosted accountless server). Builder fee applies. SAP MCP execution guidance: I
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sourceOwner | string | no | Source token account owner public key in base58. This is the fee payer and must sign the transaction locally. |
| destinationOwner | string | no | Destination wallet public key in base58. The destination ATA will be created if it does not exist. |
| mint | string | no | SPL token mint address in base58. |
| amount | number | no | Amount of tokens to transfer in base units (respect the mint decimals). |
| decimals | number | no | Optional expected token decimals. The builder verifies this against the mint account on-chain. |
Derive a deterministic SAP chat room/session ID. Group and public room IDs are active; DM derivation is reserved for future native support. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Start an on-chain SAP chat room by creating the backing vault, session, and ledger if needed. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime canno
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Send a chunked SAP chat message to a room. Public messages store UTF-8 text; private messages store caller-provided ciphertext bytes. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_paym
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Required thematic group topic when deriving or writing to topic-scoped groups. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
| content | string | no | Plain UTF-8 message content for public messages. |
| payloadBase64 | string | no | Base64 payload. Required for private/ciphertext messages. |
| visibility | string | no | Message visibility. Defaults to public. |
| contentType | string | no | MIME content type. Defaults to text/plain for public messages. |
| replyTo | string | no | Optional parent message ID. |
| policy | object | no | Optional compact group policy reference or policy hash. Full policy bodies should live off-chain and be linked by hash. |
| links | array | no | Optional signed link references. Each link must include url and may include kind, label, sha256. |
| metadata | object | no | Optional JSON metadata. Keep small; large metadata should be stored off-chain and hashed. |
Publish a signed thematic room/group manifest for discovery indexers, policy-aware agents, and chat clients. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
| description | string | no | Short public room/group description. |
| tags | array | no | Small topic tags used by discovery, for example openbook, markets, sol-usdc. |
| policy | object | no | Compact group policy or content-addressed policy reference. |
| links | array | no | Optional signed room links for docs, market references, IPFS manifests, or execution receipts. |
| metadata | object | no | Optional compact manifest metadata. |
Read latest SAP chat messages from the room ring buffer. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer bounda
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Read all SAP chat messages from sealed ledger pages plus the latest ring buffer. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Get backing SAP memory session status for a chat room. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Seal the current chat ring buffer into an immutable SAP ledger page for permanent history. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot h
| Parameter | Type | Required | Notes |
|---|---|---|---|
| roomKind | string | no | Chat room kind: dm, group, or room. |
| roomId | string | no | Optional explicit room ID. If omitted, one is derived deterministically. |
| roomName | string | no | Human-readable room name for public thematic rooms. |
| topic | string | no | Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery. |
| participants | array | no | Participant agent/wallet identifiers for DM or group rooms. |
Hosted paid tool that creates a prepaid session. The x402 charge for this tool IS the funding deposit. After settlement, creates a prepaid credit session with the specified amount and per-call cost. Returns sessionId, remainingUsd, and expiresAt. Pass the returned sessionId as prepaidSessionId to sap_payments_call_paid_tool for future calls to bypass per-call 402 challenges (x402 Lifecycle Hooks g
| Parameter | Type | Required | Notes |
|---|---|---|---|
| amountUsd | number | yes | Total USDC to deposit into the prepaid session. This amount is charged via x402 when calling this tool. |
| perCallCostUsd | number | no | Cost deducted from the prepaid balance per granted call. Defaults to 0.015 USD. |
| ttlHours | number | no | Session TTL in hours. Defaults to 24. |
FREE local tool that checks the remaining balance of a prepaid session. No x402 charge. Returns the session ID, remaining USD, total USD, per-call cost, expiry, and call count. Use this before calling sap_payments_call_paid_tool with prepaidSessionId to verify the session still has balance. SAP MCP execution guidance: Intent: local non-custodial payment/signing bridge. Pricing: free; call directl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | no | Prepaid session ID returned by sap_payments_start_prepaid. |
Return the currently loaded SAP MCP profile and redacted signer/config metadata. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is requi
No parameter schema on file.
List available SAP MCP profiles with redacted signer metadata and no wallet paths. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is r
No parameter schema on file.
Return the configured public agent key for a profile without reading or exposing keypair bytes. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| profileName | string | no | Profile name. Defaults to the loaded profile. |
Switch the live SAP MCP runtime to another existing profile and reload client, signer, connection, and policy. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if
| Parameter | Type | Required | Notes |
|---|---|---|---|
| profileName | string | no | Existing profile name to load. |
| confirm | boolean | no | Must be true because switching profile can change signer, network, and policy. |
Return the concise startup playbook for agents using SAP MCP. Call this when the user says "Start SAP MCP", "Initialize SAP MCP", "Load SAP", or asks what SAP MCP can do. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary
| Parameter | Type | Required | Notes |
|---|---|---|---|
| goal | string | no | Optional user goal to tailor the startup plan, such as "register an agent", "check wallet balance", or "swap tokens". |
Free machine-readable readiness and routing summary for SAP MCP. Use this for "are you connected?", paid/write readiness, local profile visibility, and exact next actions without dumping the whole tool catalog. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it sm
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intent | string | no | Optional user intent so the status can highlight the correct next tool path. |
Free intent-level preflight planner for SAP MCP. Call before paid calls, swaps, registry writes, escrow, identity updates, external x402 calls, premium streams, or transaction finalization. It returns the correct hosted/local route, fresh-data requirements, max-price guidance, confirmation policy, retry rules, proof-tape shape, and forbidden actions without charging x402. SAP MCP execution guidan
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intent | string | no | Closest user intent. Use registry-write for agent registration, update-agent for profile/image updates, swap for token swaps, escrow for SAP Escrow V2, external-x402 for third-party x402 agents, and p |
| toolName | string | no | Exact hosted or local tool name being planned, such as jupiter_getOrder, sap_update_agent, sap_create_escrow_v2, or sap_payments_register_agent. |
| userGoal | string | no | Short user-facing goal in natural language, used only to tailor the plan and proof-tape shape. |
| maxPriceUsd | number | no | Optional user or policy x402 spend cap for this planned action. Agents should normally estimate first and use estimate × 1.25. |
| estimatedNotionalUsd | number | no | Optional estimated trade, escrow, or value-moving notional in USD for confirmation-policy guidance. |
| hasUnsignedTransaction | boolean | no | Set true when a hosted builder already returned unsigned transaction bytes that should be finalized locally. |
| hasSubmittedSignature | boolean | no | Set true when a transaction signature was already submitted. The planner will route to verification before any retry. |
Free agentic-standards orientation for SAP MCP. Use this after sap_agent_start when an agent needs to understand how SAP MCP maps MCP, x402/pay.sh, A2A-style Agent Cards, OASF-style agent facts, AP2-style mandate planning, local signing, and hosted unsigned builders without guessing or over-claiming unsupported standards. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or re
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intent | string | no | Closest user intent so the standards context can highlight the correct MCP/x402/local-signer route. |
| includeRoadmap | boolean | no | Whether to include planned-but-not-claimed standards work such as MCP Apps, A2A signatures, AG-UI views, and full AP2 mandate signatures. Defaults to true. |
Free AP2-style mandate planner for SAP MCP agent commerce. It converts a user intent into a bounded, unsigned planning artifact with spend limits, tool/protocol allow-lists, freshness rules, confirmation thresholds, proof-tape fields, and the correct hosted/local signing route. This tool does not sign, submit, authorize payment, or replace wallet confirmation. SAP MCP execution guidance: Intent:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intent | string | yes | Human intent to bind, for example "check solking.sol", "register Solking", "swap 0.05 SOL to USDC", or "open a $10 BONK short". |
| operationType | string | no | Closest operation family. Use registry-write for SAP agent registration/update, escrow for SAP Escrow V2, and transaction-finalize when an unsigned hosted transaction is already available. |
| profile | string | no | Optional local SAP profile name the user expects the runtime to use. Do not guess wallet/keypair paths from this value. |
| wallet | string | no | Optional expected owner/signer wallet public key in base58. Used only as a public constraint, never as a keypair path. |
| maxX402Usd | number | no | Maximum x402/pay.sh fee the agent may auto-pay for one hosted tool call under the user policy. |
| maxTotalX402Usd | number | no | Maximum total x402/pay.sh spend for this mandate before asking the user again. |
| maxTradeUsd | number | no | Maximum value-moving notional in USD for swaps, perps, escrow, or transaction finalization under this mandate. |
| maxSlippageBps | number | no | Maximum slippage in basis points for swap or trading routes. 100 means 1%. |
| allowedProtocols | array | no | Protocol allow-list such as sap, mcp, x402, jupiter, adrena, pyth, metaplex, sns, magicblock, or custom protocol ids. |
| allowedTools | array | no | Exact SAP MCP tool allow-list for this mandate. Use exact names from tools/list and do not rewrite hyphenated tools. |
| requireConfirmationAboveUsd | number | no | Require a human preview and explicit confirmation above this USD notional or spend threshold. |
| expiresInSeconds | number | no | Mandate TTL in seconds. Defaults to 900 and is capped to 86400. |
Free machine-readable x402/pay.sh pricing catalog generated from the hosted SAP MCP pricing registry. Use before paid calls to understand free, micro-read, read-premium, builder, value-action, and batch tiers. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer
No parameter schema on file.
Free routing resolver for SAP MCP errors and partial results. Use this before retrying after payment_required, hosted_local_signer_required, BlockhashNotFound, missing sap_payments, timeout, or a submitted signature that has not confirmed. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| intent | string | no | Current user intent or workflow area. |
| toolName | string | no | Tool that produced the error or partial result, for example sap_register_agent, sap_update_agent, or sap_create_escrow_v2. |
| errorCode | string | no | Machine error code when available, for example hosted_local_signer_required, payment_required, BlockhashNotFound, or expired_or_not_landed. |
| errorMessage | string | no | Human or structured error message returned by the runtime, hosted server, local bridge, or wallet/RPC layer. |
| hasSignature | boolean | no | True when a transaction signature was already produced or submitted. This prevents unsafe duplicate retries. |
| paymentRequired | boolean | no | True when the previous response was an x402/pay.sh payment challenge. |
Free pre-call cost estimator (dry-run — no charge, no x402 challenge). Given a tool name, returns the hosted pricing tier, estimated USD cost, and the recommended maxPriceUsd to pass to sap_payments_call_paid_tool. Always call this before any paid tool to avoid silent cap aborts. Set your maxPriceUsd to the estimate × 1.25 to avoid abort-and-retry. This tool is always free and never triggers x402
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | yes | The MCP tool name to estimate, such as jupiter_getQuote, magicblock_swap, or sap_discover_agents. |
| arguments | object | no | Optional tool arguments. For value-action tools, the amount or size may affect the price. |
Free single-call bootstrap aggregator. Returns a compact markdown-like summary with server version, total tools count, tools by category, pricing tiers summary, premium plugins/capabilities count, bundled skills list, and nextAction guidance. Pass agentKnownVersion with the version you currently know to get skillsUpdateRequired + skillsContents (full SKILL.md inline) when the server version differ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| include | array | no | Optional subset of section names to include (version, tools, pricing, premium, skills, nextAction). When omitted, all sections are returned. |
| compact | boolean | no | When true (default), the summary string is kept compact. When false, a more readable multi-line summary is returned. |
| maxChars | number | no | Maximum character length for the summary string. Defaults to 4000. The summary is truncated if it exceeds this length. |
| agentKnownVersion | string | no | The SAP MCP version the agent currently knows about. When this differs from the server version, skillsUpdateRequired is set to true and skillsContents is populated with full SKILL.md contents. Omit to |
| intent | string | no | Optional user intent for the embedded sessionContextPacket. Use this to route bootstrap toward paid calls, registry writes, swaps, escrow, external x402 agents, premium streams, balance reads, or disc |
Free premium capability discovery. Lists SAP MCP stream, webhook, and premium tool plugin manifests with strict schemas, x402/pay.sh pricing contracts, provider readiness, and private enterprise plugin loader guidance. This tool never returns fake live data. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call direct
| Parameter | Type | Required | Notes |
|---|---|---|---|
| includeSchemas | boolean | no | When true, include full input/output JSON Schemas for every capability so agent runtimes can validate calls before payment. |
Free stream discovery for paid real-time SAP MCP capabilities. Returns only stream contracts, including event names, latency targets, x402 pricing, strict schemas, provider env requirements, and whether each stream is live or waiting for provider configuration. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call dir
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pluginId | string | no | Optional premium plugin id used to narrow stream discovery, for example sap-premium-market-data. |
Free webhook discovery for paid SAP MCP event delivery. Returns webhook event contracts, signed-delivery expectations, replay windows, x402/pay.sh pricing, provider readiness, and strict subscription schemas. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer b
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pluginId | string | no | Optional premium plugin id used to narrow webhook discovery, for example sap-premium-market-data. |
Free manifest validator for SAP MCP premium plugins. Validates ids, semver, descriptions, strict input/output schemas, x402/pay.sh pricing policies, and delivery contracts. It never executes plugin code or loads provider secrets. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact wh
| Parameter | Type | Required | Notes |
|---|---|---|---|
| manifest | object | yes | Premium plugin manifest candidate to validate before publishing or loading from a private plugin directory. |
Free premium plugin manifest builder. Generates a strict, data-only stream/webhook/tool manifest template that teams can place in a private plugin subrepo, validate, plug, and unplug without executing untrusted code or exposing provider secrets. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep i
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pluginId | string | yes | Lowercase premium plugin id, for example sap-premium-custom-alpha. This becomes the manifest id. |
| capabilityId | string | yes | Lowercase capability id, for example custom.signal.stream or custom:tool:score. |
| capabilityType | string | yes | Capability type to template: stream, webhook, or tool. |
| title | string | no | Human-readable plugin and capability title shown to agent runtimes. |
| description | string | no | Full agent-facing description explaining the use case, provider boundary, pricing model, and what the capability delivers. |
| publisher | string | no | Publisher name used for enterprise review and marketplace metadata. |
| visibility | string | no | Discovery visibility. Use private or enterprise for non-public provider contracts. |
| unitPriceUsd | number | no | Suggested x402/pay.sh unit price in USD. Agents should see pricing before activation. |
| providerEnv | array | no | Uppercase provider env var names required to make the capability live. Do not pass secret values. |
Free premium session planner. Creates a bounded session plan for a stream, webhook, or premium tool capability before any x402 charge. Use it to validate plugin id, capability id, requested units, TTL, provider readiness, and estimated price; paid activation happens only on the delivery rail. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Rou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pluginId | string | yes | Premium plugin id from sap_premium_plugin_catalog, for example sap-premium-market-data. |
| capabilityId | string | yes | Capability id from sap_stream_catalog or sap_webhook_catalog, for example jupiter.quote.delta. |
| capabilityType | string | yes | Capability type being planned: stream, webhook, or tool. |
| requestedUnits | number | no | Requested paid units for the session. Streams use minutes, webhooks use events, tools use sessions. |
| ttlSeconds | number | no | How long the unpaid planning object should remain valid. Clamped between 60 and 3600 seconds. |
| maxPriceUsd | number | no | Optional buyer budget cap in USD. Agents should compare this to estimatedPriceUsd before paid activation. |
| consumer | string | no | Optional runtime, agent id, wallet, or application identifier requesting the premium session plan. |
Free premium session status lookup. Returns the current planning status for a premium stream/webhook/tool session id, or lists recent in-memory session plans when no id is provided. It does not expose secrets or stream payload data. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | no | Optional premium session id returned by sap_premium_session_start. |
Activates a pending premium session with a verified x402/pay.sh payment receipt. This tool is FREE — it does not charge x402. The paymentReceipt must be the actual Solana transaction signature (tx hash) from the x402 facilitator settlement, NOT "pending" or any placeholder. Flow: 1) sap_premium_session_start creates a pending session (free). 2) The x402 challenge is settled via the local bridge (s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Premium session id returned by sap_premium_session_start. |
| paymentReceipt | string | yes | The Solana transaction signature (tx hash) from the x402 facilitator settlement. NOT "pending" — must be the real tx hash like "3ozKaRujGGymu3s9q67qfwfG21s2BpjJQ5zEEFCWen1u...". Get this by settling t |
| payerAddress | string | no | Optional Solana payer public key for audit binding. |
Closes an active premium session, stopping all stream and webhook delivery. Use this when the buyer wants to stop delivery before the unit quota is exhausted. No refund is issued — the session is simply closed. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Ro
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | The active premium session id to close. |
| reason | string | yes | Human-readable reason for closing the session. |
Registers an HTTPS webhook target for signed premium event delivery. The session must be active (activated via sap_premium_activate_session). The target URL must be HTTPS, reachable, and not a private/localhost endpoint in production. Events are filtered to the exact event ids listed in the request. SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid read-premium; estim
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Active premium session id. |
| targetUrl | string | yes | HTTPS webhook endpoint owned by the buyer. Localhost and private network URLs are rejected in production. |
| events | array | yes | Exact event ids to deliver, from the capability delivery contract. |
| signingPublicKey | string | no | Optional buyer public key for webhook signature verification. |
Deactivates and removes a webhook subscription. No further events will be delivered to the target URL. SAP MCP execution guidance: Intent: local-signer write workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subscriptionId | string | yes | Webhook subscription id returned by sap_premium_webhook_register. |
Returns the current status of a webhook subscription, including delivery stats and recent delivery attempt records with HTTP status codes and signatures. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost firs
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subscriptionId | string | yes | Webhook subscription id returned by sap_premium_webhook_register. |
| includeDeliveries | boolean | no | When true, include recent delivery attempt records. Default: true. |
Registers a buffer-only webhook subscription for an active premium session. Unlike sap_premium_webhook_register, this does not require a public HTTPS endpoint — events matching the subscription are buffered server-side in the event store and the agent consumes them via sap_premium_stream_poll or sap_premium_stream_flush. Use this when the agent runs locally or behind NAT and cannot expose a public
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Active premium session id to buffer webhook events for. |
| events | array | yes | Exact event ids to buffer and deliver via poll/flush. At least one event id is required. |
| filters | object | no | Optional narrow filters applied to the provider subscription, forwarded to the delivery loop. |
Returns the status of buffer-only (relay) webhook subscriptions for a session, including the relay configuration, buffered event count, and per-subscription delivery stats. Use this to check how many events are waiting in the server-side buffer before calling sap_premium_stream_poll or sap_premium_stream_flush to consume them. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: fr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Premium session id to inspect relay subscriptions and buffered event counts for. |
Returns a point-in-time metrics snapshot of the premium subsystem: active/pending/blocked sessions, total events delivered, estimated revenue, active streams, active webhooks, and provider health status. Use this for monitoring and operational insights. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly an
No parameter schema on file.
Long-poll buffered premium stream events for an active session. Returns events that have been delivered to the server-side event buffer since the last poll. This is the MCP-compatible alternative to holding open an SSE connection — call this tool periodically to drain the event buffer. This tool is transport-agnostic: because it is a standard MCP tool call (request/response), it works over any MCP
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Active premium session id whose stream events should be polled. |
| sinceEventId | string | no | Optional event id cursor. Only events delivered after this event id are returned. Use the last event id from the previous poll to paginate. |
| maxEvents | number | no | Maximum number of events to return in a single poll. Default: 10, max: 100. |
| waitMs | number | no | Long-poll wait timeout in milliseconds. If no events are available, the tool waits up to this duration for events to arrive before returning. Default: 15000 (15s). Max: 30000 (30s). Set to 0 for insta |
| eventType | string | no | Optional event type filter. Only events matching this type are returned. |
Flush all buffered premium stream events for a session with cursor-based pagination. Unlike sap_premium_stream_poll (which returns a small batch for periodic polling), flush returns all events up to the cursor limit in a single call. Use this when an agent reconnects after a disconnection and needs to catch up on missed events. The nextCursor can be used as sinceEventId in subsequent calls to fetc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sessionId | string | yes | Active or recently active premium session id whose buffered events should be flushed. |
| sinceEventId | string | no | Optional event id cursor. Only events delivered after this event id are returned. Use nextCursor from the previous flush call. |
| limit | number | no | Maximum number of events to return. Default: 50, max: 500. |
| eventType | string | no | Optional event type filter. |
List available Adrena perpetual futures markets from Pool/Custody accounts with funding/accounting fields, open interest, leverage caps, and oracle identifiers. Read-only analysis tool. Custody accounts do not expose a ready mark price, so markPrice is null until an oracle/feed decoder or configured Adrena data runtime is available. If markets are empty, treat it as data unavailable, not proof tha
| Parameter | Type | Required | Notes |
|---|---|---|---|
| market | string | no | Optional market symbol filter (e.g. "SOL", "BTC"). Empty = all markets. |
Read all open perpetual positions on Adrena for a given wallet address. Returns position key, market, side, size, collateral, entry price, leverage, unrealized PnL, and liquidation price from the on-chain Position account. markPrice mirrors entryPrice until SAP MCP has a live oracle/feed price decoder. Read-only — uses Solana RPC with PDA derivation (works on public RPC without getProgramAccounts)
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet public key (base58) to read positions for. |
Compute the current funding rate for an Adrena perpetual market from on-chain Custody account data. Pass the custodyAddress from sap_perp_markets. Returns current funding rate, cumulative funding, and open interest. Read-only — reads Custody account directly from Solana RPC (on-chain). Note: on-chain data provides the current funding snapshot only, not historical time-series. SAP MCP execution gu
| Parameter | Type | Required | Notes |
|---|---|---|---|
| custodyAddress | string | yes | Custody account public key (base58). Obtain from sap_perp_markets output — the custodyAddress field. |
| market | string | no | Optional market symbol (e.g. "SOL", "BTC") for display purposes. |
| limit | number | no | Maximum number of funding records to return (default 100). On-chain mode returns the current funding snapshot only. |
Fetch OHLC candlestick data for any Solana token from DexScreener. Returns open, high, low, close, volume, liquidity, and FDV. Read-only — uses free DexScreener REST API. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) to fetch OHLC data for. |
| resolution | string | no | Chart resolution: "5m", "1h", "6h", "24h" (default "1h"). |
Fetch long-term price history for a Solana token from DexScreener and optional protocol TVL data from DeFiLlama. Returns price changes, volume, liquidity, FDV, and TVL history. Read-only — uses free REST APIs. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) for price history. |
| protocol | string | no | Optional DeFiLlama protocol slug for TVL history (e.g. "jupiter", "raydium"). |
Compute volume profile (POC, VAH, VAL) for any Solana token using DexScreener price and volume data. Returns point of control, value area high/low, and bucket distribution. Read-only — uses free DexScreener REST API + local computation. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) to compute volume profile for. |
| buckets | number | no | Number of price buckets (default 20). |
Fetch OHLC candlestick data for multiple resolutions in a single call. Returns open, high, low, close, and volume for each requested timeframe. Uses free DexScreener API — one fetch, multiple timeframes. Reduces multi-timeframe analysis cost by 5x. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58). |
| resolutions | array | yes | Resolutions to fetch (e.g. ["5m","1h","6h","24h"]). |
Compute technical indicators (RSI, EMA-20, EMA-50, MACD, Bollinger Bands, ATR) from DexScreener price data. Returns pre-calculated values with trend/momentum/volatility signals. Reduces analysis time by 5-10 tool calls. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_pay
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58). |
| resolution | string | no | Chart resolution for indicator calculation. |
| indicators | array | no | Indicators to compute. Default: all. |
Compute liquidation zones for all open Adrena perp positions of a wallet. Reads on-chain positions via Solana RPC and calculates liquidation geometry from entry price, leverage, and liquidation price. currentPrice mirrors entryPrice until SAP MCP has a live oracle/feed price decoder. Read-only. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x402 challenge. Ro
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet public key (base58) to compute liquidation zones for. |
Create a trader-grade perpetual futures plan from a simple intent. Returns notional size, stop risk, reward/risk, liquidation estimate, preflight checklist, and the exact SAP MCP read tools to call next. This is analysis-only: SAP MCP does not expose Adrena execution builders until they are IDL-backed and locally finalizable. Required fields: market, side, collateralAmountUsd, leverage, entryPrice
| Parameter | Type | Required | Notes |
|---|---|---|---|
| market | string | yes | Perp market symbol or pair, for example SOL-PERP, BTC-PERP, or ETH-PERP. |
| side | string | yes | Intended direction for the trade. |
| collateralAmountUsd | number | yes | Collateral to allocate in USD. This is the margin budget, not notional size. |
| leverage | number | yes | Requested leverage multiplier. Keep conservative unless user policy explicitly allows more. |
| entryPrice | number | yes | Reference entry price in USD used for risk math. Required. Get the current price from sap_adrena_get_trading_prices or sap_adrena_get_prices before calling this tool. |
| stopLossPrice | number | no | Optional stop loss price in USD. Strongly recommended before execution. |
| takeProfitPrice | number | no | Optional take profit price in USD used to compute reward/risk. |
| maxAccountRiskPct | number | no | Maximum account risk percentage allowed by local policy. Default 1%. |
| maxSlippageBps | number | no | Maximum execution slippage in basis points. Default 50 bps. |
| timeframe | string | no | Trading horizon such as scalp, intraday, swing, or hedge. |
| notes | string | no | Optional user notes, catalyst, invalidation thesis, or strategy context. |
Free readiness check for perps execution. Returns whether SAP MCP has native Adrena perps builders or a configured hosted unsigned transaction builder. Builder availability is not execution approval: agents must dry-run the exact market/side/collateral/leverage before requesting a paid build or showing approval. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call direct
| Parameter | Type | Required | Notes |
|---|---|---|---|
| venue | string | no | Optional perp venue to check, for example "adrena" or "sap-perps-provider". |
Build an unsigned transaction to open or increase a long perp position on Adrena only after policy, balance, oracle-readiness, and simulation checks pass. Returns transactionBase64 for local signing via sap_payments_finalize_transaction only when safeToApprove=true and approvalBlocked=false. If oracleReadiness.ready=false, simulationError, safeToApprove is not true, or approvalBlocked appears, do
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). This is the fee payer and signer. |
| principalToken | string | yes | Asset to trade (long). Supported: JITOSOL, WBTC, BONK. |
| collateralToken | string | yes | Collateral token. Must match principal for longs. Supported: JITOSOL, WBTC, BONK. |
| collateralAmount | number | yes | Collateral amount in human-readable units (e.g. 10 = 10 JITOSOL). |
| leverage | number | yes | Leverage multiplier (e.g. 3 = 3x). |
| priceUsd | number | no | Optional limit price in USD. Omit for market order. |
| stopLossPriceUsd | number | no | Optional stop-loss price in USD. When provided, the policy engine treats this trade as having a stop loss. Omit to skip the SL requirement (if policy requires SL, this field must be present). |
Build an unsigned transaction to open or increase a short perp position on Adrena only after policy, balance, oracle-readiness, and simulation checks pass. Collateral must be USDC for shorts. Returns transactionBase64 only when safeToApprove=true, approvalBlocked=false, and the transaction passed pre-submit simulation. If oracleReadiness.ready=false, simulationError, safeToApprove is not true, or
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset to short. Supported: JITOSOL, WBTC, BONK. |
| collateralToken | string | yes | Collateral token. Must be USDC for shorts. |
| collateralAmount | number | yes | Collateral (USDC) amount in human-readable units. |
| leverage | number | yes | Leverage multiplier. |
| priceUsd | number | no | Optional limit price in USD. Omit for market order. |
| stopLossPriceUsd | number | no | Optional stop-loss price in USD. When provided, the policy engine treats this trade as having a stop loss. Omit to skip the SL requirement (if policy requires SL, this field must be present). |
Build an unsigned transaction to close a long perp position on Adrena. Default closes 100% at market price. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. Supported: JITOSOL, WBTC, BONK. |
| priceUsd | number | no | Optional close price in USD. Omit for market close. |
| percentage | number | no | Percentage to close (0-1000000, where 1000000 = 100%). Default 1000000. |
Build an unsigned transaction to close a short perp position on Adrena. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned tra
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| collateralToken | string | yes | Collateral token. USDC for shorts. |
| priceUsd | number | no | Optional close price in USD. |
| percentage | number | no | Percentage to close (0-1000000). Default 1000000. |
Build an unsigned transaction to set stop loss on an Adrena position. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned trans
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| side | string | yes | Position side. |
| stopLossPriceUsd | number | yes | Stop loss trigger price in USD. |
| closePositionPriceUsd | number | no | Optional close position price in USD. If set, the position closes at this price when triggered. |
Build an unsigned transaction to set take profit on an Adrena position. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned tra
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| side | string | yes | Position side. |
| takeProfitPriceUsd | number | yes | Take profit trigger price in USD. |
Build an unsigned transaction to cancel stop loss on an Adrena position. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned tr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| side | string | yes | Position side. |
Build an unsigned transaction to cancel take profit on an Adrena position. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| side | string | yes | Position side. |
FREE dry-run tool (no x402 charge): checks live Adrena oracle readiness and simulates opening a perp position only when oracle coverage can satisfy the pool. Returns oracleReadiness, balanceCheck, program logs, compute units, and wouldSucceed without transaction bytes. Use this before any paid build. Build only when wouldSucceed=true and oracleReadiness.ready=true. SAP MCP execution guidance: Int
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). This is the fee payer and signer. |
| principalToken | string | yes | Asset to trade. Supported: JITOSOL, WBTC, BONK, plus XAU, XAG, WTI in the commodities pool. |
| collateralToken | string | yes | Collateral token. For longs must match principal (main pool) or be USDC (commodities pool). For shorts must be USDC. Supported: USDC, JITOSOL, WBTC, BONK. |
| collateralAmount | number | yes | Collateral amount in human-readable units (e.g. 10 = 10 JITOSOL or 10 USDC). |
| leverage | number | yes | Leverage multiplier (e.g. 3 = 3x). |
| side | string | yes | Position side: long or short. |
| poolName | string | no | Pool to use. Default: main-pool. Use commodities-pool for XAU/XAG/WTI. |
Build a single unsigned transaction that atomically opens a perp position AND sets stop loss AND take profit only after policy, balance, oracle-readiness, and simulation checks pass. If stopLossPriceUsd or takeProfitPriceUsd is omitted, that instruction is skipped. Returns transactionBase64 only when the whole package is safe to approve; otherwise return structured blocked diagnostics and do not c
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset to trade. |
| collateralToken | string | yes | Collateral token. USDC for shorts, match principal for longs. |
| collateralAmount | number | yes | Collateral amount in human-readable units. |
| leverage | number | yes | Leverage multiplier (e.g. 3 = 3x). |
| side | string | yes | Position side. |
| stopLossPriceUsd | number | no | Optional stop loss trigger price in USD. Omit to skip. |
| takeProfitPriceUsd | number | no | Optional take profit trigger price in USD. Omit to skip. |
| priceUsd | number | no | Optional limit price in USD for the open. Omit for market order. |
Intent-level Adrena trading API. Pass market name, side, USD collateral, and leverage (or "max"). Resolves custody, collateral, prices, policy, balance, oracle-readiness, and simulation before returning a signable transaction. Never describe the result as ready-to-sign unless transactionBase64 exists and no oracleReadiness.ready=false, simulationError, safeToApprove=false, or approvalBlocked field
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Wallet public key (base58). |
| market | string | yes | Market symbol: BONK, JITOSOL, WBTC, USDC, XAU, XAG, WTI. |
| side | string | yes | Position side. |
| collateralUsd | number | yes | Collateral amount in USD. Converted to token amount using oracle price. |
| leverage | string | yes | Leverage multiplier (e.g. "3" for 3x) or "max" for maxInitialLeverage. |
| stopLossPct | number | no | Optional stop loss as % from entry (e.g. 5 = 5% away). Omit to skip. |
| takeProfitPct | number | no | Optional take profit as % from entry (e.g. 15 = 15% away). Omit to skip. |
| poolName | string | no | Pool: main-pool (default) or commodities-pool. |
Build an unsigned transaction to set a trailing stop loss on an Adrena position. Reads the current oracle price and computes the stop loss at the specified percentage distance. For longs: SL below current price. For shorts: SL above current price. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| side | string | yes | Position side. |
| trailPct | number | yes | Trailing distance as percentage from current price (e.g. 3 = 3% away). |
Build an unsigned transaction to modify an existing Adrena position by adding collateral. Uses openOrIncreasePosition which atomically adds collateral to an existing position. The leverage parameter can be changed to adjust the position risk. Returns transactionBase64 only after policy, oracle-readiness, balance, and builder-side RPC simulation pass. Show approval only when safeToApprove=true and
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Asset of the position. |
| collateralToken | string | yes | Collateral token. |
| collateralAmount | number | yes | Additional collateral amount in human-readable units to add to the position. |
| leverage | number | yes | New leverage multiplier. Pass the same value to keep current leverage, or a different value to change it. |
| side | string | yes | Position side. |
Returns a complete market snapshot: all Adrena market data (leverage, OI, flags), live oracle prices, and pool health (AUM, LP supply) in one call. Includes a 30-second TTL cache — repeated calls within the cache window return cached data without re-fetching. Reduces market data costs by 20x for polling bots. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: priced by hosted x40
| Parameter | Type | Required | Notes |
|---|---|---|---|
| forceRefresh | boolean | no | When true, bypasses the cache and fetches fresh data. Default false. |
Build an unsigned transaction to place a limit order on Adrena. The order fills when the oracle price reaches the trigger price. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Order owner wallet public key (base58). |
| principalToken | string | yes | Asset to trade. |
| collateralToken | string | yes | Collateral token. |
| collateralAmount | number | yes | Collateral amount in human-readable units. |
| leverage | number | yes | Leverage multiplier. |
| side | string | yes | Order side. |
| triggerPriceUsd | number | yes | Trigger price in USD. Order fills when oracle reaches this price. |
| limitPriceUsd | number | no | Optional limit price cap. Omit for market price at fill. |
Build an unsigned transaction to cancel a limit order on Adrena. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactio
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Order owner wallet public key (base58). |
| collateralToken | string | yes | Collateral token used for the order. |
| orderId | number | yes | Limit order ID to cancel. |
Build an unsigned transaction to open a long position on a synthetic commodity (XAU, XAG, WTI) on Adrena only after policy, balance, oracle-readiness, and simulation checks pass. Uses the commodities pool with USDC collateral. Returns transactionBase64 only when safeToApprove=true and approvalBlocked=false; if blocked diagnostics are returned, do not show approval or call finalize. SAP MCP execut
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Commodity to trade. |
| collateralAmount | number | yes | USDC collateral amount in human-readable units. |
| leverage | number | yes | Leverage multiplier. |
| priceUsd | number | no | Optional limit price in USD. |
Build an unsigned transaction to open a short position on a synthetic commodity (XAU, XAG, WTI) on Adrena only after policy, balance, oracle-readiness, and simulation checks pass. Uses the commodities pool with USDC collateral. Returns transactionBase64 only when safeToApprove=true and approvalBlocked=false; if blocked diagnostics are returned, do not show approval or call finalize. SAP MCP execu
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Commodity to short. |
| collateralAmount | number | yes | USDC collateral amount. |
| leverage | number | yes | Leverage multiplier. |
| priceUsd | number | no | Optional limit price in USD. |
Build an unsigned transaction to close a long commodity position on Adrena. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Commodity of the position. |
| priceUsd | number | no | Optional close price in USD. |
| percentage | number | no | Percentage to close (0-1000000). Default 1000000. |
Build an unsigned transaction to close a short commodity position on Adrena. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigne
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Position owner wallet public key (base58). |
| principalToken | string | yes | Commodity of the position. |
| priceUsd | number | no | Optional close price in USD. |
| percentage | number | no | Percentage to close (0-1000000). Default 1000000. |
Build an unsigned transaction to add liquidity to an Adrena pool. Deposits collateral and receives LP tokens. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Liquidity provider wallet public key (base58). |
| collateralToken | string | yes | Collateral token to deposit. |
| amount | number | yes | Amount in human-readable units. |
| minLpAmountOut | number | no | Minimum LP tokens to receive (raw). 0 for no slippage protection. |
| poolName | string | no | Pool to add liquidity to. |
Build an unsigned transaction to remove liquidity from an Adrena pool. Burns LP tokens and receives collateral. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Liquidity provider wallet public key (base58). |
| collateralToken | string | yes | Collateral token to receive. |
| lpAmountIn | number | yes | LP tokens to burn (raw, 6 decimals). |
| minAmountOut | number | no | Minimum collateral to receive (raw). 0 for no slippage protection. |
| poolName | string | no | Pool to remove liquidity from. |
Build an unsigned transaction to swap tokens through an Adrena pool. Uses zero-slippage oracle pricing. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Swapper wallet public key (base58). |
| fromToken | string | yes | Token to swap from. |
| toToken | string | yes | Token to swap to. |
| amount | number | yes | Amount to swap in human-readable units. |
| minAmountOut | number | no | Minimum amount to receive (raw). 0 for no slippage protection. |
Build an unsigned transaction to initialize a user staking account on Adrena. Must be called before add_liquid_stake or add_locked_stake. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Staker wallet public key (base58). |
Build an unsigned transaction to add a liquid stake on Adrena (stake LP tokens). Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize uns
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Staker wallet public key (base58). |
| amount | number | yes | Amount of LP tokens to stake (raw, 6 decimals). |
Build an unsigned transaction to remove a liquid stake on Adrena (unstake LP tokens). Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finaliz
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Staker wallet public key (base58). |
| amount | number | yes | Amount of staked LP tokens to withdraw (raw, 6 decimals). |
Build an unsigned transaction to add a locked stake on Adrena. LP tokens are locked for a specified duration. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, th
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Staker wallet public key (base58). |
| amount | number | yes | Amount of LP tokens to lock (raw, 6 decimals). |
| lockedDays | number | yes | Lock duration in days. |
Build an unsigned transaction to claim staking rewards on Adrena. Returns transactionBase64 only after builder-side RPC simulation passes. Show approval only when safeToApprove=true and approvalBlocked=false; otherwise do not call finalize. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transacti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Staker wallet public key (base58). |
| lockedStakeIndexes | string | no | Optional comma-separated list of locked stake indexes to claim. Omit to claim all. |
Fetch position history for a wallet from the Adrena Data API. Returns closed and open positions with P&L, entry/exit prices, and status. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet public key (base58). |
Read Adrena pool statistics directly from the on-chain Pool account. Returns TVL (AUM), LP token price, pool name, custody list, trade/swap flags, and fees debt. Reads from Solana mainnet via RPC. Use this before opening positions to check pool health and available custodies. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hoste
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolName | string | no | Pool name. Supported: main-pool (default), commodities-pool. |
Fetch per-asset custody statistics from the Adrena Data API. Returns open interest, utilization, volume, and fees for each custody. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | no | Optional symbol filter (e.g. JITOSOL, WBTC). |
Fetch trader performance metrics from the Adrena Data API. Returns total volume, P&L, fees, win rate, and rank. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Trader wallet public key (base58). |
Fetch trader leaderboard from the Adrena Data API. Returns top traders by volume and P&L. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never re
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | Optional limit. Default 50. |
Fetch Mutagen points for a wallet from the Adrena Data API. Returns total points, rank, and breakdown. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never recei
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet public key (base58). |
Fetch Mutagen points leaderboard from the Adrena Data API. Returns top wallets by points. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never receive keypair by
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | Optional limit. Default 50. |
Fetch current ADX and ALP token prices from the Adrena Data API. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results
No parameter schema on file.
Fetch latest oracle trading prices for all Adrena assets. Returns price and custody address for each traded asset. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: hosted reads/builders
No parameter schema on file.
Free Adrena execution readiness check for an exact market/pool/collateral route. Reads on-chain pool, custody, and oracle accounts and returns whether each required oracle symbol has enough fresh prices for Adrena minAgree. Use this before any sap_adrena_build_* open-position tool. If ready=false, do not show approval and do not call sap_payments_finalize_transaction. SAP MCP execution guidance:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| principalToken | string | no | Market symbol to trade, for example WBTC, JITOSOL, BONK, XAU, XAG, WTI. |
| collateralToken | string | no | Collateral symbol. USDC for shorts and commodities; same token for main-pool longs. |
| poolName | string | no | Adrena pool. Default main-pool; use commodities-pool for XAU/XAG/WTI. |
| requiredSymbols | array | no | Optional explicit oracle symbols to check. If omitted, SAP MCP derives them from principal/collateral custody accounts. |
Fetch live position status (P&L, size, liquidation price, entry price, oracle price) from the Adrena Data API for a specific wallet and token. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: priced by hosted x402 challenge. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer bou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| wallet | string | yes | Wallet public key (base58). |
| principalToken | string | yes | Principal token symbol (e.g. JITOSOL, WBTC, BONK, XAU). |
| side | string | yes | Position side. |
Read all Adrena custody accounts directly from Solana mainnet and return real market data for every supported asset: mint address, decimals, max initial leverage, max leverage, allowTrade/allowSwap flags, oracle feed IDs, open interest (long/short USD), locked amounts, borrow rates, and funding rates. This is the authoritative source for what markets Adrena supports and their current on-chain para
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolName | string | no | Optional pool filter. Supported: main-pool, commodities-pool. Omit for all pools. |
Get Phoenix exchange snapshot: all markets, status, configuration. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402
No parameter schema on file.
Get Phoenix market metadata for a symbol (e.g. SOL, BTC). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol (e.g. SOL, BTC, ETH) |
List all Phoenix perp markets WITH live stats merged: symbol, mark price, oracle price, 24h volume, open interest, funding rates, leverage tiers. Sorted data source for opportunity ranking and dashboards. Free read — stats come from one batched /v1/markets/stats/latest call. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payme
No parameter schema on file.
Get Phoenix orderbook for a symbol. Use depth to limit the number of bid/ask levels returned (default 20, max 100). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol (e.g. SOL) |
| depth | number | no | Number of bid/ask levels to return (default 20, max 100) |
Get Phoenix market stats history (24h volume, OI, funding). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 nativel
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol |
| limit | number | no | Max data points (default 100) |
Get Phoenix funding rate history for a symbol. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer bou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol |
Get recent fills for a Phoenix market. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary: h
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol |
| limit | number | no | Max fills (default 100) |
Get OHLCV candles for a Phoenix market. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer boundary:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol |
| timeframe | string | yes | Candle timeframe (e.g. 1m, 5m, 1h, 1d) |
| limit | number | no | Max candles (default 100) |
Get Phoenix trader state (positions, orders, collateral). You MUST provide the trader's wallet address (base58 public key). If querying your own positions, use your own wallet address. Free read. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader wallet authority public key (base58). This is REQUIRED — the tool will fail without it. |
Get Phoenix trader state snapshot (subaccounts, positions, collateral). You MUST provide the trader's wallet address (base58 public key). Free read. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader wallet authority public key (base58). REQUIRED. |
| traderPdaIndex | number | no | Trader PDA index (default 0) |
Get Phoenix trader PnL history. You MUST provide the trader's wallet address (base58 public key). Free read. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader wallet authority public key (base58). REQUIRED. |
Build an unsigned Phoenix limit order transaction. Pass authority, symbol, side, priceUsd (human limit price, e.g. "106.50"), baseUnits (human size). Raw priceInTicks/numBaseLots also accepted. Returns transactionBase64 for browser approval. Builder fee applies. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and final
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key (base58) |
| symbol | string | yes | Market symbol (e.g. SOL) |
| side | string | yes | Order side: bid (buy) or ask (sell) |
| priceUsd | string | no | Human limit price in USD (e.g. "106.50") |
| limitPrice | string | no | Alias of priceUsd |
| price | string | no | Alias of priceUsd |
| priceInTicks | string | no | Limit price in ticks (raw integer; overrides priceUsd) |
| baseUnits | string | no | Human size in base units (e.g. "0.01") |
| size | string | no | Alias of baseUnits |
| numBaseLots | string | no | Raw base lots (overrides baseUnits) |
| clientOrderId | string | no | Client order ID (unique per trader); optional |
| reduceOnly | boolean | no | Reduce-only: order can only decrease an existing position (OrderFlags.ReduceOnly) |
| holderTier | string | no | Caller $STEVE holder tier — lowers the builder fee (bronze −10%, silver −20%, gold −30%, platinum −50%). Omit for the standard fee. |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build place limit order. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build place limit order. |
Build an unsigned Phoenix market order transaction. Pass authority, symbol, side (bid=buy, ask=sell), and baseUnits (human size, e.g. "0.01" SOL). numBaseLots raw lots also accepted. Returns transactionBase64 for browser approval. Builder fee applies. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigne
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| side | string | yes | Order side |
| baseUnits | string | no | Human-readable size in base units (e.g. "0.01" = 0.01 SOL) |
| size | string | no | Alias of baseUnits |
| numBaseLots | string | no | Raw base lots (advanced; overrides baseUnits) |
| reduceOnly | boolean | no | Reduce-only: order can only decrease an existing position (OrderFlags.ReduceOnly) |
| holderTier | string | no | Caller $STEVE holder tier — lowers the builder fee (bronze −10%, silver −20%, gold −30%, platinum −50%). Omit for the standard fee. |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build place market order. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build place market order. |
Build an unsigned cancel orders by ID transaction for Phoenix. Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot han
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| orders | array | yes | Array of { priceInTicks, orderSequenceNumber } objects |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build cancel orders. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build cancel orders. |
Build an unsigned cancel all orders transaction for a Phoenix market. Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime can
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build cancel all. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build cancel all. |
Build an unsigned Phoenix stop loss order transaction. Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| triggerPrice | string | yes | Trigger price in ticks (raw integer) |
| tradeSide | string | yes | Trade side |
| executionDirection | string | yes | Trigger direction |
| orderKind | string | no | Order kind (default ioc) |
| slippageBps | number | no | Slippage Bps pagination control for sap phoenix build place stop loss. |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build place stop loss. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build place stop loss. |
Build an unsigned cancel stop loss transaction for Phoenix. Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| executionDirection | string | yes | Trigger direction |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build cancel stop loss. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build cancel stop loss. |
Build an unsigned Phoenix conditional order transaction (TP/SL bracket). Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| symbol | string | yes | Market symbol |
| lessTriggerPrice | string | no | Less-than trigger price in ticks |
| lessTradeSide | string | no | Less Trade Side parameter for sap phoenix build place conditional order. |
| greaterTriggerPrice | string | no | Greater-than trigger price in ticks |
| greaterTradeSide | string | no | Greater Trade Side parameter for sap phoenix build place conditional order. |
| sizePercent | number | no | Size Percent parameter for sap phoenix build place conditional order. |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build place conditional order. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build place conditional order. |
Build an unsigned USDC deposit transaction into a Phoenix trader account. Returns transactionBase64 for browser approval. Requires an ACTIVATED trader: check sap_phoenix_get_trader_state first — if state is "frozen" or depositCollateral.immediate=false, run the activation flow (sap_phoenix_build_onboard_trader → sign → sap_phoenix_submit_onboard_trader) before depositing, or this build simulates C
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key (base58) |
| amountUsdc | string | yes | Amount in raw USDC units (1 USDC = 1000000) |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build deposit. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build deposit. |
Build an unsigned USDC withdraw transaction from a Phoenix trader account. Returns transactionBase64. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtim
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader authority public key |
| amountUsdc | string | yes | Amount in raw USDC units |
| traderPdaIndex | number | no | Trader PDA Index parameter for sap phoenix build withdraw. |
| traderSubaccountIndex | number | no | Trader Subaccount Index parameter for sap phoenix build withdraw. |
Create a Phoenix trader account (RegisterTrader only — the account stays FROZEN with NO deposit capability until activation). Full onboarding = registration + activation: 1) sap_phoenix_build_register_trader → preview/sign/submit locally (creates the account); 2) sap_phoenix_build_onboard_trader + sap_phoenix_submit_onboard_trader (Phoenix co-signs, enables deposit/withdraw/trade); 3) verify with
| Parameter | Type | Required | Notes |
|---|---|---|---|
| authority | string | yes | Trader wallet authority public key (base58). REQUIRED — pass the user's wallet address. |
| maxPositions | number | no | Maximum positions (default 8) |
Build Phoenix trader ACTIVATION instructions (enables all six capabilities incl. deposit). ALWAYS required after register — a RegisterTrader-only account is frozen and every deposit simulates CapabilityDenied. Fetches instructions from Phoenix's build-register-ixs API (the only source of the OnboardTraderDelegated instruction). The browser assembles and signs them, then MUST submit via sap_phoenix
| Parameter | Type | Required | Notes |
|---|---|---|---|
| traderAuthority | string | yes | Trader authority wallet public key (base58, FULL 44 chars). |
| txFeePayer | string | yes | Wallet paying fees and rent (base58). Usually the same as traderAuthority. Must NOT be the Phoenix onboarder. |
| maxPositions | number | no | Max positions for registration (32-128, default 128). Only used when the account still needs RegisterTrader. |
Submit a user-signed Phoenix activation transaction through Phoenix's co-signing API (send-register-ixs): Phoenix validates it, adds the onboarder signature, simulates, verifies the onboarder pays nothing, and broadcasts. Pair with sap_phoenix_build_onboard_trader. After success verify with sap_phoenix_get_trader_state (state leaves "frozen", depositCollateral.immediate=true) before building depos
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transaction | string | yes | Base64-encoded transaction assembled from build_onboard_trader instructions and signed by the fee payer. |
| traderAuthority | string | yes | Trader authority wallet public key (base58) — same as used in build_onboard_trader. |
| txFeePayer | string | yes | Fee payer wallet public key (base58) — same as used in build_onboard_trader. |
Get a cross-chain deposit quote from Relay.link. Generates a deposit address that the user sends funds to (from Ethereum, Base, Arbitrum, or any supported EVM chain) and receives USDC on Solana automatically. The user just sends a normal transfer to the deposit address — no wallet connection or bridge UI needed. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| recipient | string | yes | Solana wallet address (base58) that will receive the USDC. This is the user's wallet on Solana. |
| originChainId | number | yes | Origin chain ID. Supported: 1 (Ethereum), 10 (Optimism), 8453 (Base), 42161 (Arbitrum), 137 (Polygon), 56 (BSC), 43114 (Avalanche). Default: 1 (Ethereum). |
| originCurrency | string | no | Origin token address. Use 0x0000000000000000000000000000000000000000 for native ETH/gas token, or the ERC20 contract address (e.g. USDC). Default: native (0x000...000). |
| amount | string | yes | Amount in smallest unit (wei for ETH, or raw token units for ERC20). Example: 100000000000000000 = 0.1 ETH. Required. |
| tradeType | string | no | EXACT_INPUT = amount is what you send. EXPECTED_OUTPUT = amount is what you want to receive. Default: EXACT_INPUT. |
Check the status of a cross-chain deposit via Relay.link. Returns the current status (pending/success/failed/refunded), transaction hashes, and chain IDs. Use the requestId from sap_phoenix_get_cross_chain_quote. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x4
| Parameter | Type | Required | Notes |
|---|---|---|---|
| requestId | string | yes | Request ID from the cross-chain quote response. Required. |
List all chains supported by Relay.link for cross-chain deposits to Solana. Returns chain IDs, names, and native currency info. Use this to show users which chains they can deposit from. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid
No parameter schema on file.
Jupiter Universal Deposit: generate a deposit address to bridge funds from any EVM chain (Ethereum, Base, Arbitrum, etc.) to Solana USDC. Powered by Relay.link — same infrastructure as jup.ag/deposit. The user sends a normal transfer to the deposit address and receives USDC on Solana automatically. Flat $0.30 fee. Free read. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| recipient | string | yes | Solana wallet address (base58) that will receive USDC. |
| originChainId | number | yes | Origin chain ID: 1 (Ethereum), 8453 (Base), 42161 (Arbitrum), 10 (Optimism), 137 (Polygon), 56 (BSC). |
| originCurrency | string | no | Origin token address. 0x0000000000000000000000000000000000000000 for native ETH. Default: native. |
| amount | string | yes | Amount in smallest unit (wei for ETH). Required. |
Track a Jupiter Universal Deposit cross-chain transfer. Returns status (pending/success/failed), transaction hashes. Use requestId from jupiter_universal_deposit_quote. Free read. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| requestId | string | yes | Request ID from the deposit quote. |
List all chains supported by Jupiter Universal Deposit for cross-chain transfers to Solana. Returns chain IDs, names, and popular chains. Free read. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, th
No parameter schema on file.
Pre-trade dynamic risk gate. Reads the trade journal to compute daily P&L, drawdown, and cooldown status. Returns allowed/disallowed with a risk score (0-1) and recommendation (PROCEED/WAIT/BLOCK). Call this before sap_adrena_build_open_long or sap_adrena_build_open_short. Combines with the static policy engine for full risk management. SAP MCP execution guidance: Intent: SAP MCP tool workflow. P
| Parameter | Type | Required | Notes |
|---|---|---|---|
| market | string | yes | Market symbol (e.g. BONK, JITOSOL, WBTC, XAU). |
| side | string | yes | Position side. |
| collateralUsd | number | yes | Collateral amount in USD. |
| leverage | number | yes | Leverage multiplier (e.g. 3 for 3x). |
Compute an aggregate portfolio risk score from the trade journal and open positions. Returns total exposure, weighted leverage, diversification score, and a risk recommendation (SAFE/MODERATE/HIGH/CRITICAL). Use this to assess overall portfolio health before opening new positions or when monitoring existing ones. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call direc
No parameter schema on file.
List all Backpack Exchange markets with metadata (tickSize, stepSize, price, volume). Optional marketType filter: SPOT or PERP. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| marketType | string | no | Optional market type filter |
Get one Backpack market by exact symbol (e.g. SOL_USDC). Resolved by filtering the full markets list client-side — the upstream /markets/{symbol} path is a 404 trap and is never called. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol, e.g. SOL_USDC (spot) or SOL_USDC_PERP (perp) |
Get one Backpack ticker snapshot (lastPrice, bidPrice, askPrice, volume24h...) by symbol, e.g. SOL_USDC. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol, e.g. SOL_USDC or SOL_USDC_PERP |
List ALL Backpack tickers (every market's lastPrice/bid/ask/24h volume) in one call. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when po
No parameter schema on file.
Get Backpack order book depth ([price, qty] ask/bid string pairs) for a symbol; optional limit caps levels per side (default 20; upstream default 1000, max 5000). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol, e.g. SOL_USDC or SOL_USDC_PERP |
| limit | number | no | Levels per side (default 20, upstream max 5000) |
Get recent Backpack trades (id, price, quantity, quoteQuantity, timestamp ms, isBuyerMaker) for a symbol; optional limit (default 50). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: free; call directly without x402. Routin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol, e.g. SOL_USDC |
| limit | number | no | Max trades (default 50) |
Get Backpack OHLCV klines for a symbol. interval is one of 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M (case-sensitive: 'M' = month). startTime/endTime accept ISO-8601 strings or epoch milliseconds and are converted to epoch SECONDS upstream. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execut
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Market symbol, e.g. SOL_USDC or SOL_USDC_PERP |
| interval | string | yes | Kline interval (1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M) |
| startTime | string | no | Range start: ISO-8601 string or epoch (seconds or milliseconds) |
| endTime | string | no | Range end: ISO-8601 string or epoch (seconds or milliseconds) |
Get Backpack mark price, index price, funding rate and next funding timestamp for a PERP symbol (e.g. SOL_USDC_PERP). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directl
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Perp market symbol, e.g. SOL_USDC_PERP |
Get Backpack funding-rate history for a perp symbol (e.g. SOL_USDC_PERP). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Sig
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Perp market symbol, e.g. SOL_USDC_PERP |
Get Backpack open interest for a perp symbol (e.g. SOL_USDC_PERP). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer bou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | yes | Perp market symbol, e.g. SOL_USDC_PERP |
Get Backpack collateral requirements per asset: haircut/imf/mmf functions and weights. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP. No arguments. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never recei
No parameter schema on file.
List Backpack assets (raw response is 2.1MB — compacted server-side to symbol + per-token deposit/withdraw fields; optional exact-symbol filter). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: fr
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | no | Optional exact asset symbol filter, e.g. SOL |
List Backpack tradable securities/stocks (raw response is 500KB — compacted server-side; optional asset prefix filter, e.g. "AAPL." matches AAPL.US): cusip, name, trading sessions with max/min quantity and stepSize. Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/disc
| Parameter | Type | Required | Notes |
|---|---|---|---|
| asset | string | no | Optional asset prefix filter, e.g. AAPL. or AAPL.US |
List Backpack market sessions (e.g. US_EQUITIES_PRE_MARKET, US_EQUITIES_REGULAR, US_EQUITIES_POST_MARKET, US_EQUITIES_OVERNIGHT) governing stock market availability. Backpack symbols: stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. No arguments. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call dir
No parameter schema on file.
List Backpack borrow/lend markets: borrow/lend interest rates, utilization, optimal utilization, limits per asset; optional symbol filter (e.g. SOL). Backpack symbols: spot SOL_USDC, perp SOL_USDC_PERP (marketType SPOT|PERP), stock spot MU.US_USDC, stock RFQ AAPL.US_USDC_RFQ. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbol | string | no | Optional asset symbol filter, e.g. SOL |
List all Sunrise-supported tokens on Solana with canonical mint addresses: symbol, name, decimals, assetClass (stock|crypto|commodity), tokenProgram (spl-token|token-2022), issuer, icon. Optional filters: assetClass, symbol substring, limit (max 200), cursor. USDC/USDT/WETH/WBTC are core assets NOT in this list but quotable. Canonical-mint warning: always resolve mints via sap_sunrise_list_tokens
| Parameter | Type | Required | Notes |
|---|---|---|---|
| assetClass | string | no | Optional filter: stock, crypto, or commodity |
| symbol | string | no | Optional case-insensitive symbol substring filter (e.g. MON) |
| limit | number | no | Max tokens per upstream page (1-200, default 200) |
| cursor | string | no | Pagination cursor from a previous call |
Resolve a Sunrise token by symbol or mint address: returns the canonical mint, decimals, assetClass, and tokenProgram. Knows the core assets (USDC, USDT, WETH, WBTC) even though they are absent from the token list. Use this instead of trusting third-party mint lists. Free read. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free host
| Parameter | Type | Required | Notes |
|---|---|---|---|
| symbolOrMint | string | yes | Token symbol (e.g. MON, USDC) or Solana mint address |
Get Sunrise swap quotes between two canonical mints. fromToken/toToken are MINT ADDRESSES (resolve symbols first with sap_sunrise_resolve_token); fromAmount is a STRING in base units ('1000000' = 1 USDC at 6 decimals — numbers are rejected). Without wallet addresses you get a price-only quote (no unsignedTransaction); include fromAddress+toAddress to receive a signable transaction. BUILDER tier.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromToken | string | yes | Input token MINT address (from sap_sunrise_resolve_token) |
| toToken | string | yes | Output token MINT address |
| fromAmount | string | yes | Input amount as STRING in base units (e.g. 1000000 for 1 USDC at 6 decimals) |
| fromAddress | string | no | Optional wallet address sending the input token — include to receive unsignedTransaction |
| toAddress | string | no | Optional wallet address receiving the output token |
Execute a signed Sunrise swap: submits the user-signed transaction from sap_sunrise_get_quote. Poll by re-calling with IDENTICAL arguments while status is 'SUBMITTED'; stop at 'CONFIRMED' and report the txHash. If polling times out, check the wallet activity FIRST — blind retries cause duplicate swaps. BUILDER tier. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder;
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signedTransaction | string | yes | Base64 transaction signed by the user wallet (from the quote unsignedTransaction, signed locally) |
| quoteId | string | yes | quoteId from sap_sunrise_get_quote |
| routeName | string | yes | routeName from sap_sunrise_get_quote (e.g. titan) |
| providerRequestId | string | no | Optional providerRequestId from the quote |
One-call Sunrise swap intent: resolves both token SYMBOLS to canonical mints, then fetches a quote with the user's wallets and returns the unsignedTransaction + quoteId + routeName + providerRequestId. The transaction is NOT broadcast — sign it locally and execute with sap_sunrise_execute_quote. BUILDER tier. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| fromSymbol | string | yes | Input token symbol (e.g. USDC, MON) |
| toSymbol | string | yes | Output token symbol |
| fromAmount | string | yes | Input amount as STRING in base units of the FROM token |
| fromAddress | string | yes | Wallet address sending the input token |
| toAddress | string | yes | Wallet address receiving the output token |
Aggregate technical signal score (0-1) from RSI, EMA, MACD, Bollinger Bands, price action, and on-chain funding rate. Returns a single score with LONG/SHORT/WAIT recommendation and confidence. Replaces 5-7 individual indicator calls with 1 aggregation call. Use this before opening a position to get a quantitative decision baseline. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricin
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | Token mint address (base58) for DexScreener price data. |
| market | string | yes | Market symbol for on-chain funding rate (e.g. BONK, JITOSOL, WBTC). |
Fetch the Crypto Fear & Greed Index from alternative.me (free, no API key). Returns current value (0-100), classification (Extreme Fear to Extreme Greed), historical values (yesterday, last week, last month), and a risk_on/risk_off recommendation. Use this as a market sentiment overlay before opening positions. Extreme Fear (<25) can indicate capitulation (contrarian bullish). Extreme Greed (>75)
No parameter schema on file.
Resolve one launch from its original DBC pool to the currently executable Meteora venue. Returns bonding-curve reserves/capacity or the migrated DAMM v2 pool. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Pool Address public key or address used by sap meteora launchpad state. |
Quote an exact-in buy or sell on the active Meteora DBC curve or its graduated DAMM v2 pool. Amounts are strings to preserve token precision. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Original Meteora DBC pool address. The tool follows migration to DAMM v2 automatically. |
| side | string | yes | Side parameter for sap meteora launchpad quote. |
| amount | string | no | Exact-in amount as a decimal string in quote units for buy or base-token units for sell. |
| amountRaw | string | no | Alternative exact-in amount in base units. Mutually exclusive with amount. |
| slippageBps | number | no | Slippage Bps pagination control for sap meteora launchpad quote. |
Build an unsigned official Meteora DBC to DAMM v2 migration after the curve reaches its threshold. The destination must be server-allowlisted. Position NFT ephemerals are co-signed; the payer remains the only external signer. Never broadcasts. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Original Meteora DBC pool address. |
| payer | string | yes | Wallet paying for and authorizing migration. |
| dammConfig | string | no | Optional expected DAMM v2 config. The gateway always derives the authoritative address from the DBC pool config. |
| latestBlockhash | string | yes | Fresh Solana blockhash supplied by the caller. |
Build an unsigned exact-in Meteora buy or sell. Routes automatically between an active DBC curve and its graduated DAMM v2 pool; never broadcasts or signs. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost fir
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Original Meteora DBC pool address. The tool follows migration to DAMM v2 automatically. |
| side | string | yes | Side parameter for sap meteora build launchpad trade. |
| amount | string | no | Exact-in amount as a decimal string in quote units for buy or base-token units for sell. |
| amountRaw | string | no | Alternative exact-in amount in base units. Mutually exclusive with amount. |
| slippageBps | number | no | Slippage Bps pagination control for sap meteora build launchpad trade. |
| owner | string | yes | Wallet that signs and pays for the swap. |
| latestBlockhash | string | yes | Fresh mainnet blockhash supplied by the caller. |
List PerpsPad supported underlying perp markets with leverage caps (e.g. BTC 1-40x, SOL 1-25x, OIL 1-20x, memecoins 1-3x). Every PerpsPad coin is backed by a leveraged perp position on one of these markets. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possibl
No parameter schema on file.
List PerpsPad launched tokens: ticker, name, mint, backing perp (underlying, leverage, direction), quote token, SOL raised, migration status, pool addresses. Sort: newest (default), oldest, or raised (most SOL raised first). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sort | string | no | Sort order |
| limit | number | no | Max tokens per page |
| offset | number | no | Pagination offset |
Fetch one PerpsPad token by UUID or mint address: full metadata including backing perp (underlying, leverage, direction), pool addresses, SOL raised, and migration status. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/bu
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | Token UUID or base58 mint address |
Fetch buyback / burn / fee transaction events for one PerpsPad token (its backing perp PnL drives buybacks and burns). Optional kind filter (comma-separated: buyback, external_buyback, burn, claim, creator_payout; default buyback+external_buyback+burn) and paging. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hoste
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | Token UUID or mint address |
| kind | string | no | Comma-separated event kinds filter (e.g. "buyback,burn") |
| limit | number | no | Max events per page |
| offset | number | no | Pagination offset |
Poll a PerpsPad launch status by token id. A launch is 'live' once its backing pool confirms on-chain (no callback needed — poll this after signing and sending the launch transactions). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: h
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tokenId | string | yes | Token UUID returned by the launch builder |
List stock mints pairable for PerpsPad stock-paired launches (token paired against a tokenized stock). Use with the stock launch builder flow. Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair
No parameter schema on file.
PerpsPad platform-wide stats: SOL price, KPIs (live tokens, total, graduated, OI USD, collateral USD, fees, raised USD, burn events, buyback USD), distributions, series, and leaderboards. Optional include filter (comma-separated subset). Free read. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and k
| Parameter | Type | Required | Notes |
|---|---|---|---|
| include | string | no | Optional comma-separated subset: kpis, distributions, series, leaderboards |
Build a PerpsPad token launch backed by a leveraged perp: returns the UNSIGNED config + pool transactions. This tool does NOT broadcast anything — sign and send BOTH transactions from the user wallet (pays rent, dev-buy 0.1-5 SOL or 5-5000 USDC, and the 0.01 SOL fee), then poll sap_perpspad_get_launch_status until live. Backing: underlying+leverage+direction (single) or 2-leg basket. Validate leve
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Coin ticker, A-Z 0-9 only (e.g. MOON) |
| name | string | yes | Coin display name |
| creatorAddress | string | yes | Creator wallet: signer, payer, buyer, dev-buy recipient |
| devBuy | number | yes | Dev-buy in quote units (SOL 0.1-5, USDC 5-5000) |
| underlying | string | no | Single-perp market backing the coin (e.g. SOL, BTC, OIL — see sap_perpspad_get_markets). Provide underlying+leverage+direction OR legs. |
| leverage | number | no | Leverage of the backing perp (1..market cap) |
| direction | string | no | Side of the backing perp |
| legs | array | no | Optional 2-leg basket instead of single underlying (e.g. NVDA long + SOL short). Each leg: {underlying, leverage, direction}. |
| quote | string | no | Pairing token: SOL (default), USDC, or CUSTOM |
| quoteMint | string | no | CUSTOM only: the SPL mint to pair against (verified server-side) |
| quoteDecimals | number | no | CUSTOM only: decimals hint (server uses on-chain decimals) |
| imageUrl | string | no | Optional coin image URL |
| websiteUrl | string | no | Optional website URL |
| twitterUrl | string | no | Optional X/Twitter URL |
Build an escrow-backed PerpsPad launch (creator-split Option B): derives the trustless escrow PDA from the NEW token mint, swaps the launch creatorAddress to that PDA, and returns the unsigned config + pool + initialize_escrow transactions. The hourly creator_payout then lands on the escrow PDA, which hard-splits 70% to the agent wallet / 30% to the OOBE treasury on-chain — non-custodial, permissi
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Coin ticker, A-Z 0-9 only (e.g. MOON) |
| name | string | yes | Coin display name |
| agentWallet | string | yes | Agent wallet that receives the 70% share (stored immutably as the escrow's distribute destination) |
| mintKeypairSecret | array | yes | 64-byte secret key of the NEW mint keypair (generated client-side, never persisted server-side). The escrow PDA derives from this mint. |
| payerWallet | string | no | Wallet that signs the transactions and pays rent + dev-buy. Usually the same as agentWallet. |
| devBuy | number | yes | Dev-buy in quote units (SOL 0.1-5, USDC 5-5000) |
| underlying | string | no | Single-perp market backing the coin (e.g. SOL, BTC, OIL). Provide underlying+leverage+direction OR legs. |
| leverage | number | no | Leverage of the backing perp (1..market cap) |
| direction | string | no | Side of the backing perp |
| legs | array | no | Optional 2-leg basket instead of single underlying. |
| quote | string | no | Pairing token: SOL (default), USDC, or CUSTOM |
| quoteMint | string | no | CUSTOM only: the SPL mint to pair against |
| quoteDecimals | number | no | CUSTOM only: decimals hint |
| imageUrl | string | no | Optional coin image URL |
| websiteUrl | string | no | Optional website URL |
| twitterUrl | string | no | Optional X/Twitter URL |
Build a Steve-native direct Meteora DBC launch: create config, initialize pool, transfer creator authority to the 70/30 escrow PDA, then initialize escrow. A requested initial buy is built separately after pool confirmation with sap_steve_launch_build_dbc_dev_buy and a fresh blockhash. Supports SOL, USDC, and validated SPL/Token-2022 quote mints. SAP MCP execution guidance: Intent: hosted unsigne
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Coin ticker, A-Z 0-9 only (e.g. MOON) |
| name | string | yes | Coin display name |
| agentWallet | string | yes | Agent wallet: receives 70% of claimed trading fees; also the leftover-token receiver |
| payer | string | yes | Transaction payer + initial pool creator (signs the returned transactions client-side) |
| devBuyAmount | number | no | Initial buy amount, denominated in the selected quote token |
| devBuySol | number | no | Deprecated alias for devBuyAmount (SOL launches only) |
| latestBlockhash | string | yes | FRESH mainnet blockhash fetched by the CALLER (getLatestBlockhash) — guarantees signability from the client. Required. |
| metadataUri | string | no | Exact permanent HTTPS URI of the Metaplex JSON (for example an IPFS/Arweave gateway URL). Preferred for production launches. |
| metadataBaseUrl | string | no | HTTPS base URL used to build the Metaplex JSON URI |
| underlying | string | no | Perp backing: Phoenix market symbol (e.g. SOL, TSLA, OIL). A-Z 0-9, 1-12 chars. REQUIRED together with leverage and direction (all-or-nothing). |
| leverage | number | no | Perp backing: integer leverage 1-10. REQUIRED together with underlying and direction (all-or-nothing). |
| direction | string | no | Perp backing: long|short. REQUIRED together with underlying and leverage (all-or-nothing). |
| quote | string | no | Quote token: SOL, USDC, or CUSTOM with quoteMint. Custom SPL/Token-2022 mints are validated on-chain. |
| quoteMint | string | no | Required when quote=CUSTOM: SPL or Token-2022 mint with 6-9 decimals and no unsupported transfer behavior. |
| quotePriceUsd | number | no | Live USD price of one quote token. Required for non-SOL quotes. |
| solPriceUsd | number | no | Live SOL/USD reference. Required for non-SOL quotes. |
| migrationQuoteThreshold | no | Optional positive quote reserve target that graduates the bonding curve to DAMM v2, in human quote-token units. Decimal strings preserve exact large custom-quote amounts. |
DEPRECATED alias; use sap_steve_launch_build_dbc. Build a Steve-native direct Meteora DBC launch: create config, initialize pool, transfer creator authority to the 70/30 escrow PDA, then initialize escrow. A requested initial buy is built separately after pool confirmation with sap_steve_launch_build_dbc_dev_buy and a fresh blockhash. Supports SOL, USDC, and validated SPL/Token-2022 quote mints.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Coin ticker, A-Z 0-9 only (e.g. MOON) |
| name | string | yes | Coin display name |
| agentWallet | string | yes | Agent wallet: receives 70% of claimed trading fees; also the leftover-token receiver |
| payer | string | yes | Transaction payer + initial pool creator (signs the returned transactions client-side) |
| devBuyAmount | number | no | Initial buy amount, denominated in the selected quote token |
| devBuySol | number | no | Deprecated alias for devBuyAmount (SOL launches only) |
| latestBlockhash | string | yes | FRESH mainnet blockhash fetched by the CALLER (getLatestBlockhash) — guarantees signability from the client. Required. |
| metadataUri | string | no | Exact permanent HTTPS URI of the Metaplex JSON (for example an IPFS/Arweave gateway URL). Preferred for production launches. |
| metadataBaseUrl | string | no | HTTPS base URL used to build the Metaplex JSON URI |
| underlying | string | no | Perp backing: Phoenix market symbol (e.g. SOL, TSLA, OIL). A-Z 0-9, 1-12 chars. REQUIRED together with leverage and direction (all-or-nothing). |
| leverage | number | no | Perp backing: integer leverage 1-10. REQUIRED together with underlying and direction (all-or-nothing). |
| direction | string | no | Perp backing: long|short. REQUIRED together with underlying and leverage (all-or-nothing). |
| quote | string | no | Quote token: SOL, USDC, or CUSTOM with quoteMint. Custom SPL/Token-2022 mints are validated on-chain. |
| quoteMint | string | no | Required when quote=CUSTOM: SPL or Token-2022 mint with 6-9 decimals and no unsupported transfer behavior. |
| quotePriceUsd | number | no | Live USD price of one quote token. Required for non-SOL quotes. |
| solPriceUsd | number | no | Live SOL/USD reference. Required for non-SOL quotes. |
| migrationQuoteThreshold | no | Optional positive quote reserve target that graduates the bonding curve to DAMM v2, in human quote-token units. Decimal strings preserve exact large custom-quote amounts. |
Legacy DBC-only initial-buy builder. New integrations must use sap_meteora_build_launchpad_trade, which supports buy/sell, exact decimal amounts, curve-capacity errors, and automatic routing after DAMM v2 graduation. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returne
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Pool Address public key or address used by sap steve launch build dbc dev buy. |
| owner | string | yes | Owner address used by sap steve launch build dbc dev buy. |
| amount | number | yes | Amount value to use for sap steve launch build dbc dev buy. |
| latestBlockhash | string | yes | Latest Blockhash parameter for sap steve launch build dbc dev buy. |
| slippageBps | number | no | Slippage Bps pagination control for sap steve launch build dbc dev buy. |
DEPRECATED alias; use sap_steve_launch_build_dbc_dev_buy. Legacy DBC-only initial-buy builder. New integrations must use sap_meteora_build_launchpad_trade, which supports buy/sell, exact decimal amounts, curve-capacity errors, and automatic routing after DAMM v2 graduation. SAP MCP execution guidance: Intent: hosted unsigned transaction builder. Pricing: paid builder; estimate first, then pay/bui
| Parameter | Type | Required | Notes |
|---|---|---|---|
| poolAddress | string | yes | Pool Address public key or address used by sap perpspad build dbc dev buy. |
| owner | string | yes | Owner address used by sap perpspad build dbc dev buy. |
| amount | number | yes | Amount value to use for sap perpspad build dbc dev buy. |
| latestBlockhash | string | yes | Latest Blockhash parameter for sap perpspad build dbc dev buy. |
| slippageBps | number | no | Slippage Bps pagination control for sap perpspad build dbc dev buy. |
PRE-LAUNCH DBC economics readout: decodes the exact Meteora DBC config the gateway will sign (scaled per quote decimals) and simulates the dev-buy with the official SDK swap math. Returns migration threshold, start price, curve breakdown, tokens out (supply-capped) and min-out after slippage. Call this instead of estimating locally — the frontend renders these values verbatim. SAP MCP execution g
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteMint | string | yes | Quote mint address (SOL = wrapped SOL mint, CUSTOM = the verified mint) |
| devBuyAmount | number | no | Human dev-buy amount in quote units (e.g. 1 SOL, 1000 OOBE). 0/omitted = curve facts only. |
| slippageBps | number | no | Dev-buy slippage in bps (default 300) |
| quotePriceUsd | number | no | Live USD price of one quote token; required for non-SOL quotes. |
| solPriceUsd | number | no | Live SOL/USD reference; required for non-SOL quotes. |
| migrationQuoteThreshold | no | Optional positive quote reserve target that graduates the bonding curve to DAMM v2, in human quote-token units. Decimal strings preserve exact large custom-quote amounts. |
DEPRECATED alias; use sap_steve_launch_preview_dbc. PRE-LAUNCH DBC economics readout: decodes the exact Meteora DBC config the gateway will sign (scaled per quote decimals) and simulates the dev-buy with the official SDK swap math. Returns migration threshold, start price, curve breakdown, tokens out (supply-capped) and min-out after slippage. Call this instead of estimating locally — the frontend
| Parameter | Type | Required | Notes |
|---|---|---|---|
| quoteMint | string | yes | Quote mint address (SOL = wrapped SOL mint, CUSTOM = the verified mint) |
| devBuyAmount | number | no | Human dev-buy amount in quote units (e.g. 1 SOL, 1000 OOBE). 0/omitted = curve facts only. |
| slippageBps | number | no | Dev-buy slippage in bps (default 300) |
| quotePriceUsd | number | no | Live USD price of one quote token; required for non-SOL quotes. |
| solPriceUsd | number | no | Live SOL/USD reference; required for non-SOL quotes. |
| migrationQuoteThreshold | no | Optional positive quote reserve target that graduates the bonding curve to DAMM v2, in human quote-token units. Decimal strings preserve exact large custom-quote amounts. |
List bundled SAP MCP skills and their files. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is required.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skills | array | no | Skills parameter for List SAP MCP Skills. |
Return bundled SAP MCP skills as JSON so an agent can load or write them itself. Pass skills: ["name1","name2"] to bundle only specific skills (filterNames pattern). Pass includeContents: false to get only file paths without content (metadata-only mode for cheap discovery). Combine both for efficient loading: skills:["sap-defi"], includeContents:true returns only the sap-defi skill files with full
| Parameter | Type | Required | Notes |
|---|---|---|---|
| skills | array | no | Optional subset of bundled skill names to bundle. When omitted, all bundled skills are returned. Use this to load only the skills you need and avoid context bloat. |
| includeContents | boolean | no | When false, only file paths are returned without file content (metadata-only). When true (default), full file contents are included. Set to false for cheap discovery, then call again with skills:["nam |
Install bundled SAP MCP skills into a local agent skill directory. Requires confirm: true. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must b
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Agent parameter for Install SAP MCP Skills. |
| targetDir | string | no | Target Dir parameter for Install SAP MCP Skills. |
| skills | array | no | Skills parameter for Install SAP MCP Skills. |
| confirm | boolean | no | Confirm flag required before local signing, payment, or write execution. Set true only after the user approves the preview/cost. |
Free helper that returns exact latest-release commands and target directories for upgrading SAP MCP skills. Hosted mode returns a local action plan; local mode can then use sap_skills_install to write files. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Optional target runtime whose default skill directory should be used. |
| targetDir | string | no | Optional explicit local skill directory. |
| skills | array | no | Optional subset of bundled skill names to upgrade. |
Free helper that returns the pinned latest-release repair command for hosted SAP MCP plus local sap_payments bridge setup. Use this before asking users to manually edit runtime config. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. S
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Optional runtime to focus repair instructions on. |
Compare the bundled skill version with the latest published npm package and report which local agent skill directories are stale. Read-only. Works in every server mode. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Optional runtime whose default skill directory should be checked. |
| targetDir | string | no | Optional explicit local skill directory to check. |
Refresh local agent skill files from the latest published @oobe-protocol-labs/sap-mcp-server package. Local-mode only (hosted MCP cannot write to the caller machine). Requires confirm: true. Uses npm pack + tar extraction; no shell interpolation of paths. SAP MCP execution guidance: Intent: agent bootstrap, routing, skills, or repair guidance. Pricing: paid read-premium; estimate first, then use
| Parameter | Type | Required | Notes |
|---|---|---|---|
| agent | string | no | Agent parameter for Self-Update SAP MCP Skills. |
| targetDir | string | no | Target Dir parameter for Self-Update SAP MCP Skills. |
| skills | array | no | Skills parameter for Self-Update SAP MCP Skills. |
| confirm | boolean | no | Confirm flag required before local signing, payment, or write execution. Set true only after the user approves the preview/cost. |
List available Ephemeral Rollup nodes from the Magic Router (identity, FQDN, fee, block time, country).. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid builder; estimate first, then pay/build and finalize unsigned transactions locally when returned. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot
| Parameter | Type | Required | Notes |
|---|---|---|---|
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Get the identity and FQDN of the current ER Validator node.. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signer
| Parameter | Type | Required | Notes |
|---|---|---|---|
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Check whether a Solana account is delegated to an Ephemeral Rollup. Returns authority, owner, delegation slot, and lamports.. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_c
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | yes | Account pubkey to check delegation status for |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Fetch account information (data, lamports, owner, executable, space) via the Magic Router.. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime canno
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account | string | yes | Account pubkey to fetch info for |
| encoding | string | no | Encoding for account data |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Get a blockhash and last valid block height for a batch of account addresses (max 100).. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot h
| Parameter | Type | Required | Notes |
|---|---|---|---|
| accounts | array | yes | Array of account addresses (max 100) |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Check the confirmation status (processed/confirmed/finalized) of one or more transaction signatures.. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the run
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signatures | array | yes | Array of transaction signatures |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Check the health status of the MagicBlock Private Payments API.. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x402 natively. Signe
No parameter schema on file.
Generate a challenge string for the wallet to sign (step 1 of the PER auth flow).. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x4
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pubkey | string | yes | Wallet pubkey that will sign the challenge |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
Exchange a signed challenge for a bearer token (step 2 of PER auth flow). The token is used for private-balance and private transfers.. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| pubkey | string | yes | Wallet pubkey that signed the challenge |
| challenge | string | yes | Challenge string from magicblock_challenge |
| signature | string | yes | Wallet signature over the challenge string |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
Read the base-chain SPL token balance for an address (public, no auth required).. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized locally when signing is requ
| Parameter | Type | Required | Notes |
|---|---|---|---|
| address | string | yes | Owner wallet pubkey |
| mint | string | yes | SPL mint pubkey |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
Read the ephemeral-rollup SPL token balance for an address (requires bearer token from login).. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime can
| Parameter | Type | Required | Notes |
|---|---|---|---|
| address | string | yes | Owner wallet pubkey |
| mint | string | yes | SPL mint pubkey |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| authToken | string | yes | Bearer token from magicblock_login (required for private reads) |
Read the ephemeral-rollup SPL token balance for an address (requires bearer token from login).. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime can
| Parameter | Type | Required | Notes |
|---|---|---|---|
| address | string | yes | Owner wallet pubkey |
| mint | string | yes | SPL mint pubkey |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| authToken | string | yes | Bearer token from magicblock_login (required for private reads) |
Build an unsigned transaction to deposit SPL tokens from Solana into an Ephemeral Rollup. Then use sap_preview_transaction, sap_sign_transaction, and sap_submit_signed_transaction — or use sap_payments_finalize_transaction for 1-call preview+sign+submit (hosted mode). Do not create local signing scripts. Builder fee applies. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Wallet pubkey that owns the tokens and will sign |
| amount | number | yes | Base-unit amount to deposit (integer, minimum 1) |
| mint | string | no | SPL mint. Defaults to USDC (mainnet) or devnet USDC |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey. Defaults to the selected ephemeral RPC identity. |
| initIfMissing | boolean | no | Initialize the transfer queue if missing (default true) |
| initVaultIfMissing | boolean | no | Initialize the vault if missing (default true) |
| initAtasIfMissing | boolean | no | Initialize associated token accounts if missing (default true) |
| idempotent | boolean | no | Use idempotent variants for preparatory init instructions (default true) |
Build an unsigned SPL token transfer through an Ephemeral Rollup. Use this only when private visibility or an ephemeral balance is explicitly requested. For an ordinary public base-to-base wallet transfer, use sap_build_spl_transfer instead; it detects legacy SPL versus Token-2022 from the mint on-chain. Supports delayed settlement, split transfers, and gasless mode. Then use sap_preview_transacti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | Sender wallet pubkey |
| to | string | yes | Recipient wallet pubkey |
| mint | string | yes | SPL mint pubkey |
| amount | number | yes | Base-unit amount to transfer (integer, minimum 1) |
| visibility | string | yes | 'public' = transparent SPL transfer, 'private' = routed through Private ER with delayed+split settlement |
| fromBalance | string | yes | Where the sender's balance is held |
| toBalance | string | yes | Where the recipient should receive funds |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey |
| authToken | string | no | Bearer token from login (required for private transfers) |
| initIfMissing | boolean | no | Initialize transfer queue if missing (default true) |
| initAtasIfMissing | boolean | no | Initialize recipient ATA if missing (default true) |
| initVaultIfMissing | boolean | no | Initialize vault if missing (default false). WARNING: when legacy=true, setting this to true can exceed the 1232-byte legacy transaction limit and produce TRANSACTION_TOO_LARGE errors. Prefer v0 (lega |
| memo | string | no | Optional memo appended to the transaction |
| minDelayMs | string | no | Private only. Earliest (ms) the queued transfer may settle. Default '0' |
| maxDelayMs | string | no | Private only. Latest (ms) the queued transfer may settle (<= 600000) |
| clientRefId | string | no | Private only. Encrypted client reference ID for payment confirmation |
| split | number | no | Private only. Number of queue entries to split across (1-15, default 1) |
| gasless | boolean | no | When true, uses configured sponsor as fee payer (default false) |
| legacy | boolean | no | Skip lookup-table compilation, return a legacy transaction (default false) |
Build an unsigned transaction to withdraw SPL tokens from an Ephemeral Rollup back to Solana. Then use sap_preview_transaction, sap_sign_transaction, and sap_submit_signed_transaction — or use sap_payments_finalize_transaction for 1-call preview+sign+submit (hosted mode). Builder fee applies. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pa
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Wallet pubkey that owns the tokens and will sign |
| mint | string | yes | SPL mint on Solana |
| amount | number | yes | Base-unit amount to withdraw (integer, minimum 1) |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey |
| initIfMissing | boolean | no | Initialize transfer queue if missing (default true) |
| initAtasIfMissing | boolean | no | Initialize ATAs if missing (default true) |
| escrowIndex | number | no | Optional escrow index for the withdrawal |
| idempotent | boolean | no | Use idempotent variants for preparatory init instructions (default true) |
Get a swap quote between two SPL mints (proxies Triton Metis swap API). Pass the result into magicblock_swap. Lightweight read tier; use this before any value-moving swap. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputMint | string | yes | Input token mint address |
| outputMint | string | yes | Output token mint address |
| amount | string | yes | Raw amount to swap (unsigned integer string, e.g. '1000000') |
| slippageBps | number | no | Slippage threshold in basis points (e.g. 50 = 0.5%) |
| swapMode | string | no | Swap mode: fixed input or fixed output amount |
| onlyDirectRoutes | boolean | no | Limit routing to a single hop (default false) |
| restrictIntermediateTokens | boolean | no | Restrict intermediate tokens to a more stable set (default false) |
| platformFeeBps | number | no | Optional platform fee in basis points |
| maxAccounts | number | no | Approximate maximum account budget for the route (default 64) |
Get a swap quote between two SPL mints (proxies Triton Metis swap API). Pass the result into magicblock_swap. Lightweight read tier; use this before any value-moving swap. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputMint | string | yes | Input token mint address |
| outputMint | string | yes | Output token mint address |
| amount | string | yes | Raw amount to swap (unsigned integer string, e.g. '1000000') |
| slippageBps | number | no | Slippage threshold in basis points (e.g. 50 = 0.5%) |
| swapMode | string | no | Swap mode: fixed input or fixed output amount |
| onlyDirectRoutes | boolean | no | Limit routing to a single hop (default false) |
| restrictIntermediateTokens | boolean | no | Restrict intermediate tokens to a more stable set (default false) |
| platformFeeBps | number | no | Optional platform fee in basis points |
| maxAccounts | number | no | Approximate maximum account budget for the route (default 64) |
Build an unsigned swap transaction from a quote. 'public' mode passes through Jupiter. 'private' mode routes output through a scheduled private transfer: requires destination, minDelayMs (string ms), maxDelayMs (string ms, <= 600000), and split (1-14). The API appends a schedule_private_transfer instruction that registers a one-shot Hydra crank for delivery. Legacy transactions are not allowed in
| Parameter | Type | Required | Notes |
|---|---|---|---|
| userPublicKey | string | yes | Wallet that will sign the swap transaction |
| quoteResponse | object | yes | Quote response object from magicblock_swapQuote (pass as-is) |
| visibility | string | no | 'public' = transparent Jupiter pass-through, 'private' = output routed through scheduled private transfer |
| destination | string | no | Final private-transfer recipient (required when visibility='private') |
| minDelayMs | string | no | Private only. Earliest (ms) the queued transfer may settle |
| maxDelayMs | string | no | Private only. Latest (ms) the queued transfer may settle (<= 600000) |
| split | number | no | Private only. Number of queue entries to split across (1-14) |
| clientRefId | string | no | Private only. Optional u64 client correlation ID |
| validator | string | no | Optional validator pubkey for the transfer-queue PDA |
| wrapAndUnwrapSol | boolean | no | Auto wrap/unwrap native SOL when needed (default true) |
| asLegacyTransaction | boolean | no | Build a legacy transaction (not allowed when visibility=private, default false) |
Build an unsigned transaction that initializes a validator-scoped transfer queue for a mint. Then use sap_preview_transaction, sap_sign_transaction, and sap_submit_signed_transaction — or use sap_payments_finalize_transaction for 1-call preview+sign+submit (hosted mode). Builder fee applies. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid builder; estimate first, then pay
| Parameter | Type | Required | Notes |
|---|---|---|---|
| owner | string | yes | Wallet pubkey that will sign the transaction |
| mint | string | yes | SPL mint to initialize a transfer queue for |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey |
Check whether a mint has a validator-scoped transfer queue on the ephemeral RPC.. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call sap_estimate_tool_cost first, then use sap_payments_call_paid_tool if the runtime cannot handle x40
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | SPL mint to check |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey |
Force a transfer queue crank attempt for a mint. Use this after a private transfer or private swap if the Hydra delivery crank has not yet delivered funds to the recipient. The API verifies the validator-scoped transfer queue and forces one crank attempt, returning the crank signature. Read-only tier: this does not move funds, it triggers the existing queued delivery.. SAP MCP execution guidance:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| mint | string | yes | SPL mint to crank the transfer queue for |
| cluster | string | no | Cluster: 'mainnet', 'devnet', or custom RPC URL |
| validator | string | no | Optional ER validator pubkey. Defaults to the well-known MagicBlock validator (MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57) |
Request provably fair on-chain randomness from the MagicBlock VRF oracle (Vrf1RNUjXmQGjmQrQLvJHs9SNkvDJEsRVFPkfSQUwGz). Builds an unsigned transaction that invokes request_randomness on the VRF program. Use sap_preview_transaction, sap_sign_transaction, and sap_submit_signed_transaction; do not create local signing scripts. The oracle queue defaults to the base-layer queue (Cuj97ggrhhidhbu39TijNVq
| Parameter | Type | Required | Notes |
|---|---|---|---|
| payer | string | yes | Wallet pubkey that will pay for the request and sign the transaction |
| callbackProgramId | string | yes | Program ID of the callback program (the program that will consume the randomness) |
| callbackDiscriminator | string | yes | Base58 or hex discriminator for the callback instruction in your program |
| callerSeed | string | yes | Seed string for the VRF request — committed before randomness is produced. The seed is hashed to 32 bytes. |
| callbackAccounts | array | yes | Accounts to pass to the callback instruction |
| ephemeral | boolean | no | Use the Ephemeral Rollup oracle queue instead of the base-layer queue (default false) |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Check whether a VRF request has been fulfilled by reading the RandomnessRequest account on-chain. Returns fulfilled status, random bytes (if available), and the request metadata.. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: paid read-premium; estimate first, then use sap_payments_call_paid_tool when the runtime cannot replay x402 natively. Routing: paid hosted call; call
| Parameter | Type | Required | Notes |
|---|---|---|---|
| requestKey | string | yes | VRF request PDA key from magicblock_requestRandomness |
| endpoint | string | no | MagicBlock Router endpoint: 'mainnet' or 'devnet' |
Free local tool. Records a tool call execution in the agent memory database (SQLite FTS5). Auto-call after any paid or significant tool call to build searchable history. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/b
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | yes | MCP tool name that was called. |
| sessionId | string | no | Optional session identifier. |
| callerProfile | string | no | Optional signer profile used. |
| input | string | no | JSON-serialized tool input. |
| output | string | no | JSON-serialized tool output (truncated to 8KB). |
| outcome | string | yes | Execution outcome. |
| costUsd | number | no | x402 cost in USD if the tool was paid. |
| txSignature | string | no | Solana transaction signature if applicable. |
| latencyMs | number | no | Execution latency in milliseconds. |
Free local tool. Full-text search (FTS5) across tool call history. Find patterns, failures, and successes by natural language query. No x402 charge. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | FTS5 search query (e.g. "swap failure slippage"). |
| toolName | string | no | Filter by tool name. |
| outcome | string | no | Filter by outcome. |
| limit | number | no | Max results. Default 20, max 100. |
| offset | number | no | Pagination offset. |
| sort | string | no | Sort order. Default relevance. |
Free local tool. Creates an LLM-compressed summary memory from tool call patterns. The agent calls this after analyzing search results to persist lessons, patterns, failures, or successes. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer bound
| Parameter | Type | Required | Notes |
|---|---|---|---|
| memoryType | string | yes | Type of memory. |
| category | string | yes | Tool category (e.g. "jupiter", "adrena", "premium"). |
| summary | string | yes | LLM-compressed summary text. Max 4KB. |
| sourceToolCalls | string | no | JSON array of tool_call IDs that were the source. |
| relevance | number | no | Initial relevance score 0-1. Default 0.8. |
| expiresAt | string | no | ISO 8601 expiry. Null = never expires. |
Free local tool. Returns the most relevant memories for a category, ordered by decayed relevance. Use this for prompt injection — the agent gets top N memories for the task at hand. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: ho
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | yes | Tool category to recall memories for. |
| limit | number | no | Max memories. Default 5. |
Free local tool. Removes expired memories and memories with relevance below threshold after decay. Also archives tool call records older than retention period. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders ne
| Parameter | Type | Required | Notes |
|---|---|---|---|
| minRelevance | number | no | Minimum decayed relevance to keep. Default 0.05. |
| archiveDays | number | no | Archive tool calls older than N days. Default 90. |
Free local tool. Saves or updates a strategy JSON in ~/.config/mcp-sap/strategies/. Strategies persist agent learnings (e.g. buyback rules, slippage thresholds, risk limits) across sessions. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer bou
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | yes | Strategy category (defi, trading, meme, payments, premium). |
| name | string | yes | Strategy name (e.g. "volatility-breakout"). |
| config | string | yes | JSON strategy configuration. |
| activate | boolean | no | Whether to activate the strategy immediately. Default true. |
Free local tool. Loads a strategy JSON by category and name. Returns the full strategy config including version and active status. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; va
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | yes | Strategy category. |
| name | string | yes | Strategy name. |
Free local tool. Lists all strategies, optionally filtered by category and active status. No x402 charge. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-moving results must be finalized lo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | no | Optional category filter. |
| activeOnly | boolean | no | Only return active strategies. Default false. |
Free local tool. Activates or deactivates a strategy by category and name. Inactive strategies are skipped during agent execution. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; va
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | yes | Strategy category. |
| name | string | yes | Strategy name. |
| active | boolean | yes | True to activate, false to deactivate. |
Free local tool. Buffers a premium stream event in the local SQLite database for offline consumption. Deduplicates by (streamType, eventId). No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair
| Parameter | Type | Required | Notes |
|---|---|---|---|
| streamType | string | yes | Stream type (e.g. "pyth-price", "meme-alerts", "volatility"). |
| eventId | string | yes | Unique event ID from the provider. |
| eventType | string | yes | Event type (e.g. "price.tick", "volatility.breakout"). |
| payload | string | yes | JSON-serialized event payload. |
Free local tool. Returns unconsumed stream events for a stream type (FIFO order) and marks them consumed. Use this instead of sap_premium_stream_poll for local offline access. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| streamType | string | yes | Stream type to consume. |
| limit | number | no | Max events to consume. Default 20. |
Free local tool. Returns all events (consumed + unconsumed) for a stream type within a time range. Used for backtest and analysis. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; va
| Parameter | Type | Required | Notes |
|---|---|---|---|
| streamType | string | yes | Stream type to replay. |
| since | string | no | ISO 8601 timestamp. Events created after this time. |
| limit | number | no | Max events. Default 100. |
Free local tool. Queries the immutable audit trail for x402 settlements and transaction signatures. Search by tool name, outcome, or time range. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive key
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | FTS5 search query. |
| outcome | string | no | Filter by outcome. |
| limit | number | no | Max results. Default 20. |
Free local tool. Records a manual audit entry in the tool call history. Use this to log custom events (e.g. manual interventions, external transactions, policy decisions). No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toolName | string | yes | Label for the audit entry. |
| input | string | no | JSON details. |
| output | string | no | JSON result. |
| outcome | string | yes | Outcome. |
| txSignature | string | no | Transaction signature if applicable. |
Free local tool. Returns aggregate statistics about the memory database: tool call counts, memory counts, stream buffer counts, outcome breakdown, DB size. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never
No parameter schema on file.
Free local tool. Searches Hermes Agent session history for relevant past conversations. Enables cross-session context recall. If Hermes is not installed, returns empty results. No x402 charge. SAP MCP execution guidance: Intent: read/discovery workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hoste
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Natural language search query. |
| limit | number | no | Max results. Default 5. |
Free local tool. Returns recent Hermes Agent sessions for context injection. Use this at session start to recall what the agent worked on recently. If Hermes is not installed, returns empty results. No x402 charge. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Si
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | number | no | Max sessions. Default 3. |
Free local tool. Loads a saved strategy by category and name, resolves trading parameters, validates against trading policy, and returns either a dry-run simulation or a ready-to-sign transaction. When dryRun is true, returns resolved params only. When dryRun is false, builds a transactionBase64. No x402 charge for this tool itself. SAP MCP execution guidance: Intent: SAP MCP tool workflow. Prici
| Parameter | Type | Required | Notes |
|---|---|---|---|
| category | string | yes | Strategy category (e.g. "trading"). |
| name | string | yes | Strategy name (e.g. "bonk-short-v1"). |
| dryRun | boolean | no | When true, simulate only. When false, build tx. Default true. |
| adjustCollateralUsd | number | no | Override collateral USD. |
| adjustLeverage | number | no | Override leverage. |
Free local tool. Appends a trade entry to the journal. Call after every trade open/close/SL/TP/liquidation for tracking and P&L analysis. No x402 charge. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never
| Parameter | Type | Required | Notes |
|---|---|---|---|
| type | string | yes | Trade event type. |
| market | string | yes | Market symbol. |
| side | string | yes | Position side. |
| collateralUsd | number | yes | Collateral in USD. |
| leverage | number | yes | Leverage multiplier. |
| priceUsd | number | yes | Entry or exit price. |
| stopLossUsd | number | no | Stop loss price. |
| takeProfitUsd | number | no | Take profit price. |
| txSignature | string | no | Transaction signature. |
| positionAddress | string | no | Position PDA address. |
| feesPaidUsd | number | yes | Fees paid in USD. |
| status | string | yes | Position status. |
| pnlUsd | number | no | P&L in USD. |
| notes | string | no | Optional notes. |
Free local tool. Queries the trade journal with filters. Returns matching entries with count and total P&L. No x402 charge. SAP MCP execution guidance: Intent: Solana value-action or trading workflow. Pricing: free; call directly without x402. Routing: free hosted call; call directly and keep it small/exact when possible. Signer boundary: hosted reads/builders never receive keypair bytes; value-m
| Parameter | Type | Required | Notes |
|---|---|---|---|
| market | string | no | Filter by market. |
| type | string | no | Filter by type. |
| status | string | no | Filter by status. |
| from | string | no | Start date ISO 8601. |
| to | string | no | End date ISO 8601. |
| limit | number | no | Max results. Default 100. |
Search the public web through the self-hosted search backend and return ranked evidence with title, URL, snippet, publication date, a server-assigned citationId, and explicit provenance (allowlisted | open-web) plus authority. Use it for current information, news, documentation, and facts that may be newer than model knowledge. Do not use it for Solana prices, on-chain state, wallet balances, or m
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Natural-language search query. |
| sources | string | no | Use 'trusted' to restrict results to the operator allowlist (provenance=allowlisted); defaults to 'all'. |
| recency | string | no | Optional freshness window; omit or use "any" for no time filter. |
| maxResults | number | no | Maximum number of results to return (1-20). |
Fetch up to three public URLs and return their readable text with a deterministic head-and-tail budget (no model summarization), each with provenance, authority, fetchedAt, a content hash, and a citation-ready URL. Use it after web_search when a snippet is not enough, or when the user provides a specific URL. Loopback, private, link-local, carrier-grade NAT, and cloud-metadata targets are refused,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| urls | array | yes | Public URLs to fetch and flatten into text (1-3). |
| charLimit | number | no | Optional per-page character budget (max 20000); the call also shares a total budget. |
Search the SAP MCP tool catalog (420+ tools) by keyword. Returns top-K matching tools with their name, description, and full input schema. Use this to discover tools before calling them via sap_call_tool. Categories: sap_phoenix_ (Phoenix perps), sap_adrena_ (Adrena perps), sap_perp_ (perps risk/signals), sap_steve_launch_ (Steve-native Meteora DBC launches), jupiter_ (swaps), spl_token_ (tokens),
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Natural language search query. Example: "get Phoenix market data" or "place limit order" or "bridge ETH to Solana". |
| category | string | no | Optional category filter (tool name prefix). Example: "sap_phoenix_", "sap_adrena_", "jupiter_", "spl_token_". |
| limit | number | no | Maximum results to return (default 10, max 25). |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install SAP MCP Server or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.9.80.
0.9.80
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish SAP MCP Server can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.