SAP MCP Server

Official268 toolsLive

by OOBE-PROTOCOL · TypeScript

Solana-native MCP gateway for SAP, DeFi tools, SNS identity, and x402 payments.

ai.oobeprotocol.sap.mcp/sap-mcp (SAP MCP Server)

Production-oriented Model Context Protocol (MCP) server that provides a Solana-native gateway for SAP, DeFi tools, SNS identity, and x402 payments. It exposes the same typed tool registry through two MCP launch modes: local stdio and remote streamable HTTP at /mcp. It also includes a setup wizard and profile-managed configuration.

🛠️ Key Features

Typed tool registry exposed via MCP
Two launch modes: local stdio; remote streamable HTTP at /mcp
Professional setup wizard
Profile-managed config under ~/.config/mcp-sap
Optional Bento policy integration
Local and external signing modes
x402 monetization

🚀 Use Cases

Desktop agents and local development (stdio mode)
Hosted customers and orchestrators (remote streamable HTTP at /mcp)

⚡ Developer Benefits

Consistent typed tool registry across launch modes
Config and profiles managed under ~/.config/mcp-sap
Supports both local and external signing modes

⚠️ Limitations

No additional capabilities beyond what is described in the provided excerpt (e.g., no full tool list details) are specified here.

Captured live from the server via tools/list.

sap_register_agent

Register the connected wallet as a SAP agent using SDK AgentModule.register. SAP MCP context: This is the primary on-chain SAP agent registration tool for the connected profile signer. Use agentUri or metadataUri for off-chain metadata, including a Metaplex or DAS-backed identity document when the agent also has NFT/collection metadata. After registration, use sap_publish_tool_by_name for advertised MCP capabilities and AgentKit metaplex-nft_* tools for NFT collection, badge, or metadata workflows.

Parameters9

name	string	optional	Human-readable name for the SAP agent
description	string	optional	Detailed description of the agent's purpose and capabilities
capabilities	array	optional	Array of capability objects or strings identifying what the agent can do (e.g. "jupiter:swap")
pricing	array	optional	Array of pricing tier objects defining per-call costs, rate limits, and settlement terms
protocols	array	optional	Array of protocol identifiers the agent supports (e.g. "jupiter", "drift")
agentId	string	optional	Optional unique agent identifier string
agentUri	string	optional	Optional URI to the agent's off-chain metadata or service endpoint
metadataUri	string	optional	Alias for agentUri — URI to off-chain agent metadata JSON
x402Endpoint	string	optional	Optional x402 payment endpoint URL for HTTP-based agent payments

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable name for the SAP agent"
    },
    "description": {
      "type": "string",
      "description": "Detailed description of the agent's purpose and capabilities"
    },
    "capabilities": {
      "type": "array",
      "description": "Array of capability objects or strings identifying what the agent can do (e.g. \"jupiter:swap\")"
    },
    "pricing": {
      "type": "array",
      "description": "Array of pricing tier objects defining per-call costs, rate limits, and settlement terms"
    },
    "protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Protocols parameter for Register SAP Agent."
      },
      "description": "Array of protocol identifiers the agent supports (e.g. \"jupiter\", \"drift\")"
    },
    "agentId": {
      "type": "string",
      "description": "Optional unique agent identifier string"
    },
    "agentUri": {
      "type": "string",
      "description": "Optional URI to the agent's off-chain metadata or service endpoint"
    },
    "metadataUri": {
      "type": "string",
      "description": "Alias for agentUri — URI to off-chain agent metadata JSON"
    },
    "x402Endpoint": {
      "type": "string",
      "description": "Optional x402 payment endpoint URL for HTTP-based agent payments"
    }
  }
}

sap_update_agent

Update the connected wallet SAP agent using SDK AgentModule.update. SAP MCP context: Use this after sap_register_agent to refresh name, description, capabilities, pricing, supported protocols, x402 endpoint, or metadataUri. For NFT-backed identity changes, update the Metaplex asset first when needed, then point the SAP agent metadataUri at the current metadata document.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": true,
  "description": "Object containing any combination of agent fields to update (name, description, capabilities, pricing, protocols, agentId, agentUri, x402Endpoint)"
}

sap_deactivate_agent

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_reactivate_agent

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_close_agent

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_report_calls

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.

Parameters1

callsServed

number

optional

Number of calls served to report for the agent

Raw schema

{
  "type": "object",
  "properties": {
    "callsServed": {
      "type": "number",
      "description": "Number of calls served to report for the agent"
    }
  }
}

sap_update_reputation_metrics

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.

Parameters2

avgLatencyMs	number	optional	Average response latency in milliseconds to report
uptimePercent	number	optional	Uptime percentage (0–100) to report for the agent

Raw schema

{
  "type": "object",
  "properties": {
    "avgLatencyMs": {
      "type": "number",
      "description": "Average response latency in milliseconds to report"
    },
    "uptimePercent": {
      "type": "number",
      "description": "Uptime percentage (0–100) to report for the agent"
    }
  }
}

sap_get_agent

Fetch agent identity by owner wallet. If omitted, fetches the connected wallet agent. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.

Parameters1

wallet

string

optional

Solana public key of the agent owner wallet (base58). If omitted, uses the connected wallet.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key of the agent owner wallet (base58). If omitted, uses the connected wallet."
    }
  }
}

sap_get_agent_stats

Fetch agent stats by agent PDA. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.

Parameters1

agentPda

string

optional

Agent PDA (base58) to fetch stats for

Raw schema

{
  "type": "object",
  "properties": {
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) to fetch stats for"
    }
  }
}

sap_get_global_state

Fetch the on-chain global registry through SDK AgentModule.fetchGlobalRegistry. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_get_network_overview

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_get_agent_profile

Fetch a hydrated SAP agent profile by owner wallet. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.

Parameters1

wallet

string

optional

Solana public key of the agent owner wallet (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key of the agent owner wallet (base58)"
    }
  }
}

sap_is_agent_active

Check if a wallet owns an active SAP agent. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.

Parameters1

wallet

string

optional

Solana public key of the wallet to check for an active SAP agent (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key of the wallet to check for an active SAP agent (base58)"
    }
  }
}

sap_discover_agents

Discover agents by protocol, capability, or capability list. Unfiltered global listing is not exposed by SDK v0.20. 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.

Parameters5

protocol	string	optional	Protocol identifier to filter agents by (e.g. "jupiter", "drift")
capability	string	optional	Single capability ID to filter agents by (e.g. "jupiter:swap")
capabilities	array	optional	Array of capability IDs to filter agents by (requires at least one)
hydrate	boolean	optional	Whether to include full hydrated agent profiles in results (default: true)
limit	number	optional	Maximum number of agents to return (default: 50)

Raw schema

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol identifier to filter agents by (e.g. \"jupiter\", \"drift\")"
    },
    "capability": {
      "type": "string",
      "description": "Single capability ID to filter agents by (e.g. \"jupiter:swap\")"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Capabilities parameter for Discover SAP Agents."
      },
      "description": "Array of capability IDs to filter agents by (requires at least one)"
    },
    "hydrate": {
      "type": "boolean",
      "description": "Whether to include full hydrated agent profiles in results (default: true)"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of agents to return (default: 50)"
    }
  }
}

sap_list_agents

Compatibility alias for filtered SAP agent discovery. Requires protocol or capability. Use sap_list_all_agents for a global on-chain directory snapshot. 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.

Parameters5

protocol	string	optional	Protocol identifier to filter agents by (e.g. "jupiter", "drift")
capability	string	optional	Single capability ID to filter agents by (e.g. "jupiter:swap")
capabilities	array	optional	Array of capability IDs to filter agents by (requires at least one)
hydrate	boolean	optional	Whether to include full hydrated agent profiles in results (default: true)
limit	number	optional	Maximum number of agents to return (default: 50)

Raw schema

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol identifier to filter agents by (e.g. \"jupiter\", \"drift\")"
    },
    "capability": {
      "type": "string",
      "description": "Single capability ID to filter agents by (e.g. \"jupiter:swap\")"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Capabilities parameter for List SAP Agents."
      },
      "description": "Array of capability IDs to filter agents by (requires at least one)"
    },
    "hydrate": {
      "type": "boolean",
      "description": "Whether to include full hydrated agent profiles in results (default: true)"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of agents to return (default: 50)"
    }
  }
}

sap_list_all_agents

Enumerate SAP AgentAccount PDAs directly from the on-chain program account set. Use this for current global directory requests such as "list all agents in the SAP ecosystem rn". 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.

Parameters6

limit	number	optional	Maximum rows to return. Defaults to 100; hard-capped at 500.
offset	number	optional	Zero-based pagination offset. Defaults to 0.
includeInactive	boolean	optional	Include inactive agents. Defaults to false.
protocol	string	optional	Optional protocol filter matched against agent profile protocols and protocol-index membership.
capability	string	optional	Optional capability ID filter such as jupiter:swap.
includeProtocolIndexes	boolean	optional	Include compact protocol index summaries. Defaults to true.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum rows to return. Defaults to 100; hard-capped at 500."
    },
    "offset": {
      "type": "number",
      "description": "Zero-based pagination offset. Defaults to 0."
    },
    "includeInactive": {
      "type": "boolean",
      "description": "Include inactive agents. Defaults to false."
    },
    "protocol": {
      "type": "string",
      "description": "Optional protocol filter matched against agent profile protocols and protocol-index membership."
    },
    "capability": {
      "type": "string",
      "description": "Optional capability ID filter such as jupiter:swap."
    },
    "includeProtocolIndexes": {
      "type": "boolean",
      "description": "Include compact protocol index summaries. Defaults to true."
    }
  }
}

sap_find_tools_by_category

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.

Parameters3

category	string \| number	optional	Tool category name (e.g. "defi", "infrastructure") or numeric category ID
hydrate	boolean	optional	Whether to include full hydrated tool descriptors in results (default: true)
limit	number	optional	Maximum number of tools to return (default: 50)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": [
        "string",
        "number"
      ],
      "description": "Tool category name (e.g. \"defi\", \"infrastructure\") or numeric category ID"
    },
    "hydrate": {
      "type": "boolean",
      "description": "Whether to include full hydrated tool descriptors in results (default: true)"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of tools to return (default: 50)"
    }
  }
}

sap_get_tool_category_summary

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_fetch_capability_index

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.

Parameters1

capabilityId

string

optional

Capability ID to fetch the index for (e.g. "jupiter:swap")

Raw schema

{
  "type": "object",
  "properties": {
    "capabilityId": {
      "type": "string",
      "description": "Capability ID to fetch the index for (e.g. \"jupiter:swap\")"
    }
  }
}

sap_fetch_protocol_index

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.

Parameters1

protocolId

string

optional

Protocol ID to fetch the index for (e.g. "jupiter", "drift")

Raw schema

{
  "type": "object",
  "properties": {
    "protocolId": {
      "type": "string",
      "description": "Protocol ID to fetch the index for (e.g. \"jupiter\", \"drift\")"
    }
  }
}

sap_fetch_tool_category_index

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.

Parameters1

sap_fetch_tool

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.

Parameters2

agentPda	string	optional	Agent PDA (base58) that owns the tool descriptor
toolName	string	optional	Name of the tool descriptor to fetch

Raw schema

{
  "type": "object",
  "properties": {
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) that owns the tool descriptor"
    },
    "toolName": {
      "type": "string",
      "description": "Name of the tool descriptor to fetch"
    }
  }
}

sap_fetch_feedback

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.

Parameters2

agentPda	string	optional	Agent PDA (base58) to fetch feedback for
reviewer	string	optional	Optional reviewer wallet (base58) to filter feedback by

Raw schema

{
  "type": "object",
  "properties": {
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) to fetch feedback for"
    },
    "reviewer": {
      "type": "string",
      "description": "Optional reviewer wallet (base58) to filter feedback by"
    }
  }
}

sap_fetch_attestation

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.

Parameters2

agentPda	string	optional	Agent PDA (base58) to fetch attestation for
attester	string	optional	Optional attester wallet (base58) to filter attestation by

Raw schema

{
  "type": "object",
  "properties": {
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) to fetch attestation for"
    },
    "attester": {
      "type": "string",
      "description": "Optional attester wallet (base58) to filter attestation by"
    }
  }
}

sap_fetch_escrow

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.

Parameters3

escrowPda	string	optional	Escrow PDA (base58) to fetch directly
agentPda	string	optional	Agent PDA (base58) — used when escrowPda is omitted
depositor	string	optional	Optional depositor wallet (base58) to filter by

Raw schema

{
  "type": "object",
  "properties": {
    "escrowPda": {
      "type": "string",
      "description": "Escrow PDA (base58) to fetch directly"
    },
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) — used when escrowPda is omitted"
    },
    "depositor": {
      "type": "string",
      "description": "Optional depositor wallet (base58) to filter by"
    }
  }
}

sap_fetch_escrow_v2

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.

Parameters4

escrowPda	string	optional	Escrow V2 PDA (base58) to fetch directly
agentPda	string	optional	Agent PDA (base58) — used when escrowPda is omitted
depositor	string	optional	Optional depositor wallet (base58) to filter by
nonce	number	optional	Escrow nonce (default: 0) — used with agentPda and depositor

Raw schema

{
  "type": "object",
  "properties": {
    "escrowPda": {
      "type": "string",
      "description": "Escrow V2 PDA (base58) to fetch directly"
    },
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) — used when escrowPda is omitted"
    },
    "depositor": {
      "type": "string",
      "description": "Optional depositor wallet (base58) to filter by"
    },
    "nonce": {
      "type": "number",
      "description": "Escrow nonce (default: 0) — used with agentPda and depositor"
    }
  }
}

sap_fetch_pending_settlement

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.

Parameters1

pendingPda

string

optional

Pending settlement PDA (base58) to fetch

Raw schema

{
  "type": "object",
  "properties": {
    "pendingPda": {
      "type": "string",
      "description": "Pending settlement PDA (base58) to fetch"
    }
  }
}

sap_fetch_dispute

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.

Parameters1

disputePda

string

optional

Dispute PDA (base58) to fetch

Raw schema

{
  "type": "object",
  "properties": {
    "disputePda": {
      "type": "string",
      "description": "Dispute PDA (base58) to fetch"
    }
  }
}

sap_fetch_vault

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.

Parameters1

agentPda

string

optional

Agent PDA (base58) to fetch the memory vault for

Raw schema

{
  "type": "object",
  "properties": {
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) to fetch the memory vault for"
    }
  }
}

sap_fetch_session

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.

Parameters1

sessionPda

string

optional

Session PDA (base58) to fetch the ledger for

Raw schema

{
  "type": "object",
  "properties": {
    "sessionPda": {
      "type": "string",
      "description": "Session PDA (base58) to fetch the ledger for"
    }
  }
}

sap_fetch_epoch_page

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.

Parameters2

sessionPda	string	optional	Session PDA (base58) to fetch epoch page for
epochIndex	number	optional	Zero-based epoch index to fetch

Raw schema

{
  "type": "object",
  "properties": {
    "sessionPda": {
      "type": "string",
      "description": "Session PDA (base58) to fetch epoch page for"
    },
    "epochIndex": {
      "type": "number",
      "description": "Zero-based epoch index to fetch"
    }
  }
}

sap_fetch_stake

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.

Parameters2

stakePda	string	optional	Stake PDA (base58) to fetch directly
agentPda	string	optional	Agent PDA (base58) — used when stakePda is omitted

Raw schema

{
  "type": "object",
  "properties": {
    "stakePda": {
      "type": "string",
      "description": "Stake PDA (base58) to fetch directly"
    },
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) — used when stakePda is omitted"
    }
  }
}

sap_fetch_subscription

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.

Parameters4

subscriptionPda	string	optional	Subscription PDA (base58) to fetch directly
agentPda	string	optional	Agent PDA (base58) — used when subscriptionPda is omitted
subscriber	string	optional	Optional subscriber wallet (base58) to filter by
subId	number	optional	Subscription ID (default: 0) — used with agentPda and subscriber

Raw schema

{
  "type": "object",
  "properties": {
    "subscriptionPda": {
      "type": "string",
      "description": "Subscription PDA (base58) to fetch directly"
    },
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58) — used when subscriptionPda is omitted"
    },
    "subscriber": {
      "type": "string",
      "description": "Optional subscriber wallet (base58) to filter by"
    },
    "subId": {
      "type": "number",
      "description": "Subscription ID (default: 0) — used with agentPda and subscriber"
    }
  }
}

sap_create_escrow

Create a V1 escrow using SDK EscrowModule.create. 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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58)
pricePerCall	string	optional	Price per call in lamports (as a decimal string)
maxCalls	string	optional	Maximum number of calls the escrow covers (as a decimal string)
initialDeposit	string	optional	Initial deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "pricePerCall": {
      "type": "string",
      "description": "Price per call in lamports (as a decimal string)"
    },
    "maxCalls": {
      "type": "string",
      "description": "Maximum number of calls the escrow covers (as a decimal string)"
    },
    "initialDeposit": {
      "type": "string",
      "description": "Initial deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_deposit_escrow

Deposit funds into a V1 escrow. 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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
amount	string	optional	Deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_settle_escrow

Settle calls against a V1 escrow. 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.

Parameters3

depositorWallet	string	optional	Depositor wallet public key (base58)
callsToSettle	string	optional	Number of calls to settle (as a decimal string)
serviceHash	array	optional	32-byte service hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "callsToSettle": {
      "type": "string",
      "description": "Number of calls to settle (as a decimal string)"
    },
    "serviceHash": {
      "type": "array",
      "description": "32-byte service hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_settle_escrow_batch

Batch settle V1 escrow entries using SDK EscrowModule.settleBatch. 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.

Parameters3

depositorWallet	string	optional	Depositor wallet public key (base58)
settlements	array	optional	Array of settlement objects, each containing callsToSettle (string) and serviceHash (32-byte array)
batchRoot	array	optional	Optional 32-byte Merkle root for batch verification

Raw schema

{
  "type": "object",
  "properties": {
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "settlements": {
      "type": "array",
      "description": "Array of settlement objects, each containing callsToSettle (string) and serviceHash (32-byte array)"
    },
    "batchRoot": {
      "type": "array",
      "description": "Optional 32-byte Merkle root for batch verification"
    }
  }
}

sap_withdraw_escrow

Withdraw funds from a V1 escrow. 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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
amount	string	optional	Withdrawal amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Withdrawal amount in lamports (as a decimal string)"
    }
  }
}

sap_close_escrow

Close an empty V1 escrow. 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.

Parameters1

agentWallet

string

optional

Agent wallet public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    }
  }
}

sap_x402_estimate_cost

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.

Parameters5

agentWallet	string	optional	Agent wallet public key (base58)
calls	number	optional	Number of calls to estimate
pricePerCall	string	optional	Optional base price per call override in token base units
totalCallsBefore	number	optional	Optional cumulative settled calls before this estimate
volumeCurve	array	optional	Optional array of { afterCalls, pricePerCall } pricing breakpoints

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "calls": {
      "type": "number",
      "description": "Number of calls to estimate"
    },
    "pricePerCall": {
      "type": "string",
      "description": "Optional base price per call override in token base units"
    },
    "totalCallsBefore": {
      "type": "number",
      "description": "Optional cumulative settled calls before this estimate"
    },
    "volumeCurve": {
      "type": "array",
      "description": "Optional array of { afterCalls, pricePerCall } pricing breakpoints"
    }
  }
}

sap_x402_calculate_cost

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.

Parameters4

basePrice	string	optional	Base price per call in token base units
calls	number	optional	Number of calls to calculate
totalCallsBefore	number	optional	Cumulative settled calls before this calculation (default: 0)
volumeCurve	array	optional	Array of { afterCalls, pricePerCall } pricing breakpoints

Raw schema

{
  "type": "object",
  "properties": {
    "basePrice": {
      "type": "string",
      "description": "Base price per call in token base units"
    },
    "calls": {
      "type": "number",
      "description": "Number of calls to calculate"
    },
    "totalCallsBefore": {
      "type": "number",
      "description": "Cumulative settled calls before this calculation (default: 0)"
    },
    "volumeCurve": {
      "type": "array",
      "description": "Array of { afterCalls, pricePerCall } pricing breakpoints"
    }
  }
}

sap_x402_prepare_payment

Prepare a V1 x402 payment context using SDK X402Registry.preparePayment. Deprecated by the SDK for production escrow creation; prefer Escrow V2 tools for new 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.

Parameters9

agentWallet	string	optional	Agent wallet public key (base58)
pricePerCall	string	optional	Price per call as a decimal string
deposit	string	optional	Initial deposit amount as a decimal string
maxCalls	string	optional	Optional maximum number of calls covered
expiresAt	string	optional	Optional expiry timestamp in unix seconds
volumeCurve	array	optional	Optional array of { afterCalls, pricePerCall } pricing breakpoints
tokenMint	string	optional	Optional SPL token mint; omit/null for SOL
tokenDecimals	number	optional	Optional token decimals
networkIdentifier	string	optional	Optional x402 network identifier written into headers

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "pricePerCall": {
      "type": "string",
      "description": "Price per call as a decimal string"
    },
    "deposit": {
      "type": "string",
      "description": "Initial deposit amount as a decimal string"
    },
    "maxCalls": {
      "type": "string",
      "description": "Optional maximum number of calls covered"
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional expiry timestamp in unix seconds"
    },
    "volumeCurve": {
      "type": "array",
      "description": "Optional array of { afterCalls, pricePerCall } pricing breakpoints"
    },
    "tokenMint": {
      "type": "string",
      "description": "Optional SPL token mint; omit/null for SOL"
    },
    "tokenDecimals": {
      "type": "number",
      "description": "Optional token decimals"
    },
    "networkIdentifier": {
      "type": "string",
      "description": "Optional x402 network identifier written into headers"
    }
  }
}

sap_x402_build_payment_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.

Parameters9

escrowPda	string	optional	Escrow PDA (base58)
agentPda	string	optional	Agent PDA (base58)
agentWallet	string	optional	Agent wallet public key (base58)
depositorWallet	string	optional	Depositor wallet public key (base58)
pricePerCall	string	optional	Price per call in token base units
maxCalls	string	optional	Max calls as a decimal string
txSignature	string	optional	Escrow creation transaction signature
networkIdentifier	string	optional	x402 network identifier stored in the payment context
network	string	optional	Optional override for X-Payment-Network

Raw schema

{
  "type": "object",
  "properties": {
    "escrowPda": {
      "type": "string",
      "description": "Escrow PDA (base58)"
    },
    "agentPda": {
      "type": "string",
      "description": "Agent PDA (base58)"
    },
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "pricePerCall": {
      "type": "string",
      "description": "Price per call in token base units"
    },
    "maxCalls": {
      "type": "string",
      "description": "Max calls as a decimal string"
    },
    "txSignature": {
      "type": "string",
      "description": "Escrow creation transaction signature"
    },
    "networkIdentifier": {
      "type": "string",
      "description": "x402 network identifier stored in the payment context"
    },
    "network": {
      "type": "string",
      "description": "Optional override for X-Payment-Network"
    }
  }
}

sap_x402_build_headers_from_escrow

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
network	string	optional	Optional network identifier for X-Payment-Network

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "network": {
      "type": "string",
      "description": "Optional network identifier for X-Payment-Network"
    }
  }
}

sap_x402_has_escrow

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
depositor	string	optional	Optional depositor wallet (base58); defaults to caller in SDK

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositor": {
      "type": "string",
      "description": "Optional depositor wallet (base58); defaults to caller in SDK"
    }
  }
}

sap_x402_fetch_escrow

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
depositor	string	optional	Optional depositor wallet (base58); defaults to caller in SDK

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositor": {
      "type": "string",
      "description": "Optional depositor wallet (base58); defaults to caller in SDK"
    }
  }
}

sap_x402_get_balance

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
depositor	string	optional	Optional depositor wallet (base58) to filter balance by

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositor": {
      "type": "string",
      "description": "Optional depositor wallet (base58) to filter balance by"
    }
  }
}

sap_x402_settle

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.

Parameters8

depositorWallet	string	optional	Depositor wallet public key (base58)
callsToSettle	number	optional	Number of calls to settle
serviceData	string	optional	Service data to hash into the settlement proof
priorityFeeMicroLamports	number	optional	Optional priority fee in microlamports per compute unit
computeUnits	number	optional	Optional compute-unit limit
skipPreflight	boolean	optional	Optional skip preflight flag
commitment	string	optional	Optional processed\|confirmed\|finalized commitment
maxRetries	number	optional	Optional RPC retry limit

Raw schema

{
  "type": "object",
  "properties": {
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "callsToSettle": {
      "type": "number",
      "description": "Number of calls to settle"
    },
    "serviceData": {
      "type": "string",
      "description": "Service data to hash into the settlement proof"
    },
    "priorityFeeMicroLamports": {
      "type": "number",
      "description": "Optional priority fee in microlamports per compute unit"
    },
    "computeUnits": {
      "type": "number",
      "description": "Optional compute-unit limit"
    },
    "skipPreflight": {
      "type": "boolean",
      "description": "Optional skip preflight flag"
    },
    "commitment": {
      "type": "string",
      "description": "Optional processed|confirmed|finalized commitment"
    },
    "maxRetries": {
      "type": "number",
      "description": "Optional RPC retry limit"
    }
  }
}

sap_x402_settle_batch

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.

Parameters7

depositorWallet	string	optional	Depositor wallet public key (base58)
entries	array	optional	Array of { calls, serviceData } settlement entries
priorityFeeMicroLamports	number	optional	Optional priority fee in microlamports per compute unit
computeUnits	number	optional	Optional compute-unit limit
skipPreflight	boolean	optional	Optional skip preflight flag
commitment	string	optional	Optional processed\|confirmed\|finalized commitment
maxRetries	number	optional	Optional RPC retry limit

Raw schema

{
  "type": "object",
  "properties": {
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "entries": {
      "type": "array",
      "description": "Array of { calls, serviceData } settlement entries"
    },
    "priorityFeeMicroLamports": {
      "type": "number",
      "description": "Optional priority fee in microlamports per compute unit"
    },
    "computeUnits": {
      "type": "number",
      "description": "Optional compute-unit limit"
    },
    "skipPreflight": {
      "type": "boolean",
      "description": "Optional skip preflight flag"
    },
    "commitment": {
      "type": "string",
      "description": "Optional processed|confirmed|finalized commitment"
    },
    "maxRetries": {
      "type": "number",
      "description": "Optional RPC retry limit"
    }
  }
}

sap_create_escrow_v2

Create a V2 escrow using SDK EscrowV2Module.create. 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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58)
pricePerCall	string	optional	Price per call in lamports (as a decimal string)
maxCalls	string	optional	Maximum number of calls the escrow covers (as a decimal string)
initialDeposit	string	optional	Initial deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "pricePerCall": {
      "type": "string",
      "description": "Price per call in lamports (as a decimal string)"
    },
    "maxCalls": {
      "type": "string",
      "description": "Maximum number of calls the escrow covers (as a decimal string)"
    },
    "initialDeposit": {
      "type": "string",
      "description": "Initial deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_deposit_escrow_v2

Deposit funds into a V2 escrow. 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.

Parameters3

agentWallet	string	optional	Agent wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)
amount	string	optional	Deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    },
    "amount": {
      "type": "string",
      "description": "Deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_settle_escrow_v2

Settle calls against a V2 escrow. 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.

Parameters4

depositorWallet	string	optional	Depositor wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)
callsToSettle	string	optional	Number of calls to settle (as a decimal string)
serviceHash	array	optional	32-byte service hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    },
    "callsToSettle": {
      "type": "string",
      "description": "Number of calls to settle (as a decimal string)"
    },
    "serviceHash": {
      "type": "array",
      "description": "32-byte service hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_next_settlement_index

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.

Parameters3

agentWallet	string	optional	Agent wallet public key (base58)
depositorWallet	string	optional	Depositor wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    }
  }
}

sap_finalize_settlement_v2

Finalize a V2 pending settlement. 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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58)
depositorWallet	string	optional	Depositor wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)
settlementIndex	string	optional	Settlement index to finalize (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "depositorWallet": {
      "type": "string",
      "description": "Depositor wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    },
    "settlementIndex": {
      "type": "string",
      "description": "Settlement index to finalize (as a decimal string)"
    }
  }
}

sap_file_dispute_v2

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.

Parameters5

agentWallet	string	optional	Agent wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)
settlementIndex	string	optional	Settlement index to dispute (as a decimal string)
evidenceHash	array	optional	32-byte evidence hash as a byte array, hex string, or base64 string
disputeType	number	optional	Optional dispute type identifier (numeric)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    },
    "settlementIndex": {
      "type": "string",
      "description": "Settlement index to dispute (as a decimal string)"
    },
    "evidenceHash": {
      "type": "array",
      "description": "32-byte evidence hash as a byte array, hex string, or base64 string"
    },
    "disputeType": {
      "type": "number",
      "description": "Optional dispute type identifier (numeric)"
    }
  }
}

sap_withdraw_escrow_v2

Withdraw funds from a V2 escrow. 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.

Parameters3

agentWallet	string	optional	Agent wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)
amount	string	optional	Withdrawal amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    },
    "amount": {
      "type": "string",
      "description": "Withdrawal amount in lamports (as a decimal string)"
    }
  }
}

sap_close_escrow_v2

Close a V2 escrow. 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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
nonce	string	optional	Escrow nonce (as a decimal string, default: 0)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "nonce": {
      "type": "string",
      "description": "Escrow nonce (as a decimal string, default: 0)"
    }
  }
}

sap_give_feedback

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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58) to give feedback for
score	number	optional	Feedback score (numeric, e.g. 1–5)
tag	string	optional	Optional feedback tag/category (default: "general")
commentHash	array	optional	Optional 32-byte comment hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to give feedback for"
    },
    "score": {
      "type": "number",
      "description": "Feedback score (numeric, e.g. 1–5)"
    },
    "tag": {
      "type": "string",
      "description": "Optional feedback tag/category (default: \"general\")"
    },
    "commentHash": {
      "type": "array",
      "description": "Optional 32-byte comment hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_update_feedback

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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58) to update feedback for
score	number	optional	New feedback score (numeric, e.g. 1–5)
tag	string	optional	Optional new feedback tag/category
commentHash	array	optional	Optional 32-byte comment hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to update feedback for"
    },
    "score": {
      "type": "number",
      "description": "New feedback score (numeric, e.g. 1–5)"
    },
    "tag": {
      "type": "string",
      "description": "Optional new feedback tag/category"
    },
    "commentHash": {
      "type": "array",
      "description": "Optional 32-byte comment hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_revoke_feedback

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.

Parameters1

agentWallet

string

optional

Agent wallet public key (base58) to revoke feedback for

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to revoke feedback for"
    }
  }
}

sap_create_attestation

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.

Parameters4

agentWallet	string	optional	Agent wallet public key (base58) to create attestation for
attestationType	string	optional	Optional attestation type string (default: "generic")
metadataHash	array	optional	32-byte metadata hash as a byte array, hex string, or base64 string
expiresAt	string	optional	Optional expiry timestamp (as a decimal string, 0 = no expiry)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to create attestation for"
    },
    "attestationType": {
      "type": "string",
      "description": "Optional attestation type string (default: \"generic\")"
    },
    "metadataHash": {
      "type": "array",
      "description": "32-byte metadata hash as a byte array, hex string, or base64 string"
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional expiry timestamp (as a decimal string, 0 = no expiry)"
    }
  }
}

sap_revoke_attestation

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.

Parameters1

agentWallet

string

optional

Agent wallet public key (base58) to revoke attestation for

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to revoke attestation for"
    }
  }
}

sap_fairscale_score

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.

Parameters2

agent	string	optional	Agent PDA or wallet (base58) to score
task	string	optional	Optional FairScale task type: one of "defi_execution", "trust_focused", "work_focused", "hiring"

Raw schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "description": "Agent PDA or wallet (base58) to score"
    },
    "task": {
      "type": "string",
      "description": "Optional FairScale task type: one of \"defi_execution\", \"trust_focused\", \"work_focused\", \"hiring\""
    }
  }
}

sap_fairscale_trust_gate

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.

Parameters3

agent	string	optional	Agent PDA or wallet (base58) to evaluate
minScore	number	optional	Optional minimum trust score threshold
requireVerification	boolean	optional	Whether verified status is required to pass the gate (default: false)

Raw schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "description": "Agent PDA or wallet (base58) to evaluate"
    },
    "minScore": {
      "type": "number",
      "description": "Optional minimum trust score threshold"
    },
    "requireVerification": {
      "type": "boolean",
      "description": "Whether verified status is required to pass the gate (default: false)"
    }
  }
}

sap_init_vault

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.

Parameters1

vaultNonce

array

optional

Vault nonce as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "vaultNonce": {
      "type": "array",
      "description": "Vault nonce as a byte array, hex string, or base64 string"
    }
  }
}

sap_open_vault_session

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.

Parameters1

sessionHash

array

optional

32-byte session hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "sessionHash": {
      "type": "array",
      "description": "32-byte session hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_inscribe_memory

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": true,
  "description": "Object containing memory inscription fields: sequence (number), encryptedData (byte array), nonce (byte array), contentHash (32-byte array), and optional totalFragments, fragmentIndex, compression, epochIndex"
}

sap_compact_inscribe_memory

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.

Parameters5

sessionPda	string	optional	Session PDA (base58) for the memory inscription
vaultPda	string	optional	Vault PDA (base58) for the memory inscription
encryptedData	array	optional	Encrypted memory data as a byte array, hex string, or base64 string
nonce	array	optional	Encryption nonce as a byte array, hex string, or base64 string
contentHash	array	optional	32-byte content hash as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "sessionPda": {
      "type": "string",
      "description": "Session PDA (base58) for the memory inscription"
    },
    "vaultPda": {
      "type": "string",
      "description": "Vault PDA (base58) for the memory inscription"
    },
    "encryptedData": {
      "type": "array",
      "description": "Encrypted memory data as a byte array, hex string, or base64 string"
    },
    "nonce": {
      "type": "array",
      "description": "Encryption nonce as a byte array, hex string, or base64 string"
    },
    "contentHash": {
      "type": "array",
      "description": "32-byte content hash as a byte array, hex string, or base64 string"
    }
  }
}

sap_session_start

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.

Parameters2

sessionId	string	optional	High-level session identifier string
vaultNonce	array	optional	Optional vault nonce as a byte array, hex string, or base64 string

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "High-level session identifier string"
    },
    "vaultNonce": {
      "type": "array",
      "description": "Optional vault nonce as a byte array, hex string, or base64 string"
    }
  }
}

sap_session_read_latest

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.

Parameters1

sessionId

string

optional

High-level session identifier string to read latest entries from

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "High-level session identifier string to read latest entries from"
    }
  }
}

sap_session_status

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.

Parameters1

sessionId

string

optional

High-level session identifier string to get status for

Raw schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "High-level session identifier string to get status for"
    }
  }
}

sap_publish_tool_by_name

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.

Parameters10

toolName	string	optional	Name of the tool to publish
protocolId	string	optional	Protocol ID the tool belongs to (e.g. "jupiter")
description	string	optional	Human-readable description of the tool
inputSchemaJson	string	optional	JSON string of the tool input schema
outputSchemaJson	string	optional	JSON string of the tool output schema
httpMethod	number	optional	HTTP method code (e.g. 0=GET, 1=POST)
category	number	optional	Numeric tool category ID
paramsCount	number	optional	Total number of parameters the tool accepts
requiredParams	number	optional	Number of required parameters
isCompound	boolean	optional	Whether the tool is a compound tool (default: false)

Raw schema

{
  "type": "object",
  "properties": {
    "toolName": {
      "type": "string",
      "description": "Name of the tool to publish"
    },
    "protocolId": {
      "type": "string",
      "description": "Protocol ID the tool belongs to (e.g. \"jupiter\")"
    },
    "description": {
      "type": "string",
      "description": "Human-readable description of the tool"
    },
    "inputSchemaJson": {
      "type": "string",
      "description": "JSON string of the tool input schema"
    },
    "outputSchemaJson": {
      "type": "string",
      "description": "JSON string of the tool output schema"
    },
    "httpMethod": {
      "type": "number",
      "description": "HTTP method code (e.g. 0=GET, 1=POST)"
    },
    "category": {
      "type": "number",
      "description": "Numeric tool category ID"
    },
    "paramsCount": {
      "type": "number",
      "description": "Total number of parameters the tool accepts"
    },
    "requiredParams": {
      "type": "number",
      "description": "Number of required parameters"
    },
    "isCompound": {
      "type": "boolean",
      "description": "Whether the tool is a compound tool (default: false)"
    }
  }
}

sap_update_tool

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "toolName": {
    "type": "string",
    "description": "Name of the tool to update"
  },
  "additionalProperties": true,
  "description": "Object containing optional update fields: descriptionHash, inputSchemaHash, outputSchemaHash (32-byte arrays), httpMethod, category, paramsCount, requiredParams (numbers)"
}

sap_deactivate_tool

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.

Parameters1

toolName

string

optional

Name of the tool descriptor to deactivate

Raw schema

{
  "type": "object",
  "properties": {
    "toolName": {
      "type": "string",
      "description": "Name of the tool descriptor to deactivate"
    }
  }
}

sap_reactivate_tool

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.

Parameters1

toolName

string

optional

Name of the tool descriptor to reactivate

Raw schema

{
  "type": "object",
  "properties": {
    "toolName": {
      "type": "string",
      "description": "Name of the tool descriptor to reactivate"
    }
  }
}

sap_report_tool_invocations

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.

Parameters2

toolName	string	optional	Name of the tool descriptor to report invocations for
invocations	number	optional	Number of invocations to report

Raw schema

{
  "type": "object",
  "properties": {
    "toolName": {
      "type": "string",
      "description": "Name of the tool descriptor to report invocations for"
    },
    "invocations": {
      "type": "number",
      "description": "Number of invocations to report"
    }
  }
}

sap_init_stake

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58) to initialize stake for
initialDeposit	string	optional	Initial stake deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to initialize stake for"
    },
    "initialDeposit": {
      "type": "string",
      "description": "Initial stake deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_deposit_stake

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
amount	string	optional	Additional stake deposit amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Additional stake deposit amount in lamports (as a decimal string)"
    }
  }
}

sap_request_unstake

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
amount	string	optional	Unstake request amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Unstake request amount in lamports (as a decimal string)"
    }
  }
}

sap_complete_unstake

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.

Parameters1

agentWallet

string

optional

Agent wallet public key (base58) to complete unstaking for

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to complete unstaking for"
    }
  }
}

sap_create_subscription

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.

Parameters5

agentWallet	string	optional	Agent wallet public key (base58) to create subscription for
subId	string	optional	Subscription ID (as a decimal string, default: 0)
pricePerInterval	string	optional	Price per billing interval in lamports (as a decimal string)
billingInterval	number	optional	Billing interval in seconds between charges
initialFund	string	optional	Initial fund amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58) to create subscription for"
    },
    "subId": {
      "type": "string",
      "description": "Subscription ID (as a decimal string, default: 0)"
    },
    "pricePerInterval": {
      "type": "string",
      "description": "Price per billing interval in lamports (as a decimal string)"
    },
    "billingInterval": {
      "type": "number",
      "description": "Billing interval in seconds between charges"
    },
    "initialFund": {
      "type": "string",
      "description": "Initial fund amount in lamports (as a decimal string)"
    }
  }
}

sap_fund_subscription

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.

Parameters3

agentWallet	string	optional	Agent wallet public key (base58)
subId	string	optional	Subscription ID (as a decimal string, default: 0)
amount	string	optional	Funding amount in lamports (as a decimal string)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "subId": {
      "type": "string",
      "description": "Subscription ID (as a decimal string, default: 0)"
    },
    "amount": {
      "type": "string",
      "description": "Funding amount in lamports (as a decimal string)"
    }
  }
}

sap_cancel_subscription

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.

Parameters2

agentWallet	string	optional	Agent wallet public key (base58)
subId	string	optional	Subscription ID (as a decimal string, default: 0)

Raw schema

{
  "type": "object",
  "properties": {
    "agentWallet": {
      "type": "string",
      "description": "Agent wallet public key (base58)"
    },
    "subId": {
      "type": "string",
      "description": "Subscription ID (as a decimal string, default: 0)"
    }
  }
}

sap_sns_check_domain

Check whether a .sol domain is available for registration using the SAP SDK SnsModule.

Parameters1

domain

string

optional

The .sol domain name to check for availability (with or without .sol suffix)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to check for availability (with or without .sol suffix)"
    }
  }
}

sap_sns_batch_check_domains

Check availability for multiple .sol domains (up to 25) using the SAP SDK SnsModule.

Parameters1

domains

array

optional

Array of .sol domain names to batch-check for availability (1-25 domains)

Raw schema

{
  "type": "object",
  "properties": {
    "domains": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A .sol domain name to check (with or without .sol suffix)"
      },
      "description": "Array of .sol domain names to batch-check for availability (1-25 domains)"
    }
  }
}

sap_sns_resolve_domain

Resolve a .sol domain to SAP agent identity, wallet, metadata, and SNS records using the SAP SDK SnsModule.

Parameters1

domain

string

optional

The .sol domain name to resolve to SAP agent identity and SNS records

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to resolve to SAP agent identity and SNS records"
    }
  }
}

sap_sns_validate_records

Validate SNS records for SAP agent compatibility (checks SOL, Pic, TXT records on-chain).

Parameters1

domain

string

optional

The .sol domain name whose SNS records should be validated for SAP agent compatibility

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name whose SNS records should be validated for SAP agent compatibility"
    }
  }
}

sap_sns_get_domain_pda

Derive the SNS domain PDA for a .sol domain using the SAP SDK SnsModule.

Parameters1

domain

string

optional

The .sol domain name to derive the SNS domain PDA for

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to derive the SNS domain PDA for"
    }
  }
}

sap_sns_get_record_pda

Derive the SNS record PDA for a domain and record type using the SAP SDK SnsModule.

Parameters2

domain	string	optional	The .sol domain name to derive the record PDA for
recordType	string	optional	The SNS record type for the PDA derivation (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to derive the record PDA for"
    },
    "recordType": {
      "type": "string",
      "description": "The SNS record type for the PDA derivation (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.)"
    }
  }
}

sap_sns_register_agent_domain

Register a .sol domain for the configured local SAP agent wallet using the SAP SDK SnsModule. Builds, signs, and submits the full registration transaction with USDC payment in one call. Domain registration fees are paid in USDC plus SOL for rent and transaction fees. The SOL record is NOT set during registration (it requires a separate Ed25519 signature) — set it after using sap_sns_build_manage_record_transaction.

Parameters10

domain	string	optional	The .sol domain name to register for the SAP agent (with or without .sol suffix)
agentWallet	string	optional	The Solana public key (base58) of the SAP agent wallet that will own the domain
pic	string	optional	Profile picture URL for the SNS Pic record (required if not provided in records.Pic)
records	object	optional	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	optional	Optional structured SAP metadata to embed in the domain TXT record (capabilities, protocols, endpoints, etc.)
capabilities	array	optional	Optional list of SAP capability IDs to advertise in the domain TXT record
protocols	array	optional	Optional list of protocol IDs the agent supports
setAsPrimary	boolean	optional	Whether to set this domain as the agent primary .sol domain
durationYears	number	optional	Registration duration in years (default: 1)
space	number	optional	Storage space in bytes for the domain name account (default: 600)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to register for the SAP agent (with or without .sol suffix)"
    },
    "agentWallet": {
      "type": "string",
      "description": "The Solana public key (base58) of the SAP agent wallet that will own the domain"
    },
    "pic": {
      "type": "string",
      "description": "Profile picture URL for the SNS Pic record (required if not provided in records.Pic)"
    },
    "records": {
      "type": "object",
      "description": "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": {
      "type": "object",
      "description": "Optional structured SAP metadata to embed in the domain TXT record (capabilities, protocols, endpoints, etc.)"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A SAP capability identifier (e.g. \"jupiter:swap\")"
      },
      "description": "Optional list of SAP capability IDs to advertise in the domain TXT record"
    },
    "protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "A protocol identifier (e.g. \"sap\", \"mcp\")"
      },
      "description": "Optional list of protocol IDs the agent supports"
    },
    "setAsPrimary": {
      "type": "boolean",
      "description": "Whether to set this domain as the agent primary .sol domain"
    },
    "durationYears": {
      "type": "number",
      "description": "Registration duration in years (default: 1)"
    },
    "space": {
      "type": "number",
      "description": "Storage space in bytes for the domain name account (default: 600)"
    }
  }
}

sap_sns_get_domain_records

Fetch all configured SNS records for a .sol domain using the Bonfida SDK. Returns a key-value map of all records.

Parameters1

domain

string

optional

The .sol domain name to fetch all configured SNS records for

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to fetch all configured SNS records for"
    }
  }
}

sap_sns_get_record

Fetch a single SNS record value for a .sol domain using the Bonfida SDK.

Parameters2

domain	string	optional	The .sol domain name to fetch a record from
recordType	string	optional	The SNS record type to fetch (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to fetch a record from"
    },
    "recordType": {
      "type": "string",
      "description": "The SNS record type to fetch (e.g. SOL, TXT, Url, IPFS, ETH, BTC, etc.)"
    }
  }
}

sap_sns_resolve_wallet

Resolve a .sol domain to its owner wallet public key using the Bonfida SDK.

Parameters1

domain

string

optional

The .sol domain name to resolve to its owner wallet public key

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to resolve to its owner wallet public key"
    }
  }
}

sap_sns_check_ownership

Check whether a wallet owns a .sol domain using the Bonfida SDK.

Parameters2

domain	string	optional	The .sol domain name to check ownership of
owner	string	optional	The Solana public key (base58) of the wallet to verify as the domain owner

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to check ownership of"
    },
    "owner": {
      "type": "string",
      "description": "The Solana public key (base58) of the wallet to verify as the domain owner"
    }
  }
}

sap_sns_build_manage_record_transaction

Build an unsigned SNS record create/update/delete transaction using the Bonfida SDK. The returned transaction must be signed with sap_sign_transaction before submission. Use null value to delete a record. Note: SOL record is not supported — it requires a separate Ed25519 signature flow.

Parameters4

domain	string	optional	The .sol domain name whose record should be created, updated, or deleted
recordType	string	optional	The SNS record type to manage (e.g. TXT, Url, IPFS, ETH, BTC, etc.)
value	string \| null	optional	The new record value as a string, or null to delete the record
owner	string	optional	The Solana public key (base58) of the domain owner authorizing the record change

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name whose record should be created, updated, or deleted"
    },
    "recordType": {
      "type": "string",
      "description": "The SNS record type to manage (e.g. TXT, Url, IPFS, ETH, BTC, etc.)"
    },
    "value": {
      "type": [
        "string",
        "null"
      ],
      "description": "The new record value as a string, or null to delete the record"
    },
    "owner": {
      "type": "string",
      "description": "The Solana public key (base58) of the domain owner authorizing the record change"
    }
  }
}

sap_sns_build_set_primary_domain_transaction

Build an unsigned transaction to set a .sol domain as primary for the owner using the Bonfida SDK. The returned transaction must be signed with sap_sign_transaction before submission.

Parameters2

domain	string	optional	The .sol domain name to set as primary for the owner
owner	string	optional	The Solana public key (base58) of the domain owner setting their primary domain

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The .sol domain name to set as primary for the owner"
    },
    "owner": {
      "type": "string",
      "description": "The Solana public key (base58) of the domain owner setting their primary domain"
    }
  }
}

sap_network_stats

Fetch real SAP network statistics using synapse-sap-sdk DiscoveryRegistry and GlobalRegistry.

Parameters1

detailed

boolean

optional

Include both discovery overview and raw global registry state.

Raw schema

{
  "type": "object",
  "properties": {
    "detailed": {
      "type": "boolean",
      "description": "Include both discovery overview and raw global registry state.",
      "default": false
    }
  }
}

sol_get_balance

Fetch the SOL balance for a wallet or account using the configured Solana RPC endpoint.

Parameters3

address	string	optional	Wallet or account public key in base58
pubkey	string	optional	Alias for address
commitment	string	optional	Optional commitment override

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Wallet or account public key in base58"
    },
    "pubkey": {
      "type": "string",
      "description": "Alias for address"
    },
    "commitment": {
      "type": "string",
      "enum": [
        "processed",
        "confirmed",
        "finalized"
      ],
      "description": "Optional commitment override"
    }
  }
}

spl-token_deployToken

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 operations are part of the agent service lifecycle.

Parameters10

owner	string	required	Token owner / mint authority wallet
name	string	required	Token name (stored in Metaplex metadata)
symbol	string	required	Token symbol (e.g. "MYTKN")
decimals	number	optional	Token decimals (default: 9)
initialSupply	string	optional	Raw token amount (smallest unit, no decimals)
uri	string	optional	URI to off-chain metadata JSON (image, description, etc.)
isMutable	boolean	optional	Whether metadata is mutable (default: true)
freezeAuthority	string	optional	Solana public key (base58)
mintAuthority	string	optional	Solana public key (base58)
sellerFeeBasisPoints	number	optional	Royalty fee in bps (for fungible with metadata)

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Token owner / mint authority wallet"
    },
    "name": {
      "type": "string",
      "description": "Token name (stored in Metaplex metadata)"
    },
    "symbol": {
      "type": "string",
      "description": "Token symbol (e.g. \"MYTKN\")"
    },
    "decimals": {
      "type": "number",
      "description": "Token decimals (default: 9)"
    },
    "initialSupply": {
      "type": "string",
      "description": "Raw token amount (smallest unit, no decimals)"
    },
    "uri": {
      "type": "string",
      "description": "URI to off-chain metadata JSON (image, description, etc.)"
    },
    "isMutable": {
      "type": "boolean",
      "description": "Whether metadata is mutable (default: true)"
    },
    "freezeAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mintAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "sellerFeeBasisPoints": {
      "type": "number",
      "description": "Royalty fee in bps (for fungible with metadata)"
    }
  },
  "required": [
    "owner",
    "name",
    "symbol"
  ],
  "additionalProperties": false
}

spl-token_transfer

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 agent service lifecycle.

Parameters6

from	string	required	Sender wallet address
to	string	required	Recipient wallet address
mint	string	required	Token mint address
amount	string	required	Amount to transfer (raw, smallest unit)
createAta	boolean	optional	Create recipient ATA if needed (default: true)
memo	string	optional	Optional memo to attach to the transaction

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Sender wallet address"
    },
    "to": {
      "type": "string",
      "description": "Recipient wallet address"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address"
    },
    "amount": {
      "type": "string",
      "description": "Amount to transfer (raw, smallest unit)"
    },
    "createAta": {
      "type": "boolean",
      "description": "Create recipient ATA if needed (default: true)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach to the transaction"
    }
  },
  "required": [
    "from",
    "to",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

spl-token_transferSol

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 lifecycle.

Parameters4

from	string	required	Sender wallet address
to	string	required	Recipient wallet address
amount	string	required	Amount in lamports (1 SOL = 1_000_000_000 lamports)
memo	string	optional	Optional memo to attach

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Sender wallet address"
    },
    "to": {
      "type": "string",
      "description": "Recipient wallet address"
    },
    "amount": {
      "type": "string",
      "description": "Amount in lamports (1 SOL = 1_000_000_000 lamports)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo to attach"
    }
  },
  "required": [
    "from",
    "to",
    "amount"
  ],
  "additionalProperties": false
}

spl-token_getBalance

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 part of the agent service lifecycle.

Parameters2

wallet	string	required	Wallet address to check
mint	string	optional	Token mint address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address to check"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

spl-token_getTokenAccounts

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 service lifecycle.

Parameters2

wallet	string	required	Wallet to query all token accounts for
showZeroBalance	boolean	optional	Include zero-balance accounts

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet to query all token accounts for"
    },
    "showZeroBalance": {
      "type": "boolean",
      "description": "Include zero-balance accounts"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

spl-token_mintTo

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 agent service lifecycle.

Parameters4

mint	string	required	Token mint address
mintAuthority	string	required	Mint authority wallet
destination	string	required	Wallet to receive minted tokens
amount	string	required	Amount to mint (raw, smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address"
    },
    "mintAuthority": {
      "type": "string",
      "description": "Mint authority wallet"
    },
    "destination": {
      "type": "string",
      "description": "Wallet to receive minted tokens"
    },
    "amount": {
      "type": "string",
      "description": "Amount to mint (raw, smallest unit)"
    }
  },
  "required": [
    "mint",
    "mintAuthority",
    "destination",
    "amount"
  ],
  "additionalProperties": false
}

spl-token_burn

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.

Parameters3

mint	string	required	Token mint address (base58)
owner	string	required	Token account owner
amount	string	required	Amount to burn

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "owner": {
      "type": "string",
      "description": "Token account owner"
    },
    "amount": {
      "type": "string",
      "description": "Amount to burn"
    }
  },
  "required": [
    "mint",
    "owner",
    "amount"
  ],
  "additionalProperties": false
}

spl-token_freezeAccount

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 agent service lifecycle.

Parameters3

mint	string	required	Token mint address (base58)
account	string	required	Token account to freeze
freezeAuthority	string	required	Freeze authority wallet

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "account": {
      "type": "string",
      "description": "Token account to freeze"
    },
    "freezeAuthority": {
      "type": "string",
      "description": "Freeze authority wallet"
    }
  },
  "required": [
    "mint",
    "account",
    "freezeAuthority"
  ],
  "additionalProperties": false
}

spl-token_thawAccount

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.

Parameters3

mint	string	required	Token mint address (base58)
account	string	required	Token account to thaw
freezeAuthority	string	required	Freeze authority wallet

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "account": {
      "type": "string",
      "description": "Token account to thaw"
    },
    "freezeAuthority": {
      "type": "string",
      "description": "Freeze authority wallet"
    }
  },
  "required": [
    "mint",
    "account",
    "freezeAuthority"
  ],
  "additionalProperties": false
}

spl-token_closeAccount

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.

Parameters3

account	string	required	Token account to close
owner	string	required	Token account owner
destination	string	optional	Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "Token account to close"
    },
    "owner": {
      "type": "string",
      "description": "Token account owner"
    },
    "destination": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "account",
    "owner"
  ],
  "additionalProperties": false
}

spl-token_rugCheck

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 operations are part of the agent service lifecycle.

Parameters1

mint

string

required

Token mint to analyze

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint to analyze"
    }
  },
  "required": [
    "mint"
  ],
  "additionalProperties": false
}

staking_stakeSOL

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.

Parameters3

wallet	string	required	Wallet to stake from
amount	string	required	Amount in lamports to stake
validator	string	optional	Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet to stake from"
    },
    "amount": {
      "type": "string",
      "description": "Amount in lamports to stake"
    },
    "validator": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "wallet",
    "amount"
  ],
  "additionalProperties": false
}

staking_unstakeSOL

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.

Parameters2

wallet	string	required	Solana public key (base58)
stakeAccount	string	required	Stake account to deactivate and withdraw

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "stakeAccount": {
      "type": "string",
      "description": "Stake account to deactivate and withdraw"
    }
  },
  "required": [
    "wallet",
    "stakeAccount"
  ],
  "additionalProperties": false
}

staking_getStakeAccounts

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.

Parameters1

wallet

string

required

Wallet to query stake accounts for

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet to query stake accounts for"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

staking_stakeJupSOL

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.

Parameters2

wallet	string	required	Solana public key (base58)
amount	string	required	Amount in lamports to stake for jupSOL

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Amount in lamports to stake for jupSOL"
    }
  },
  "required": [
    "wallet",
    "amount"
  ],
  "additionalProperties": false
}

staking_unstakeJupSOL

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.

Parameters2

wallet	string	required	Solana public key (base58)
amount	string	required	Amount of jupSOL to unstake

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Amount of jupSOL to unstake"
    }
  },
  "required": [
    "wallet",
    "amount"
  ],
  "additionalProperties": false
}

staking_stakeSolayer

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.

Parameters2

wallet	string	required	Solana public key (base58)
amount	string	required	Amount in lamports to stake for sSOL

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Amount in lamports to stake for sSOL"
    }
  },
  "required": [
    "wallet",
    "amount"
  ],
  "additionalProperties": false
}

staking_unstakeSolayer

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.

Parameters2

wallet	string	required	Solana public key (base58)
amount	string	required	Amount of sSOL to unstake

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Amount of sSOL to unstake"
    }
  },
  "required": [
    "wallet",
    "amount"
  ],
  "additionalProperties": false
}

bridging_bridgeWormhole

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 submission. If the bridge capability belongs to a registered SAP agent, advertise it with sap_publish_tool_by_name and include bridge capability IDs in sap_register_agent or sap_update_agent.

Parameters7

sourceChain	string	required	Source chain identifier (e.g. "solana", "ethereum", "base", "polygon")
destinationChain	string	required	Destination chain identifier
token	string	required	Token address on source chain
amount	string	required	Amount to bridge (raw, smallest unit)
sender	string	required	Sender wallet on source chain
recipient	string	required	Recipient address on destination chain
relayerFee	string	optional	Raw token amount (smallest unit, no decimals)

Raw schema

{
  "type": "object",
  "properties": {
    "sourceChain": {
      "type": "string",
      "description": "Source chain identifier (e.g. \"solana\", \"ethereum\", \"base\", \"polygon\")"
    },
    "destinationChain": {
      "type": "string",
      "description": "Destination chain identifier"
    },
    "token": {
      "type": "string",
      "description": "Token address on source chain"
    },
    "amount": {
      "type": "string",
      "description": "Amount to bridge (raw, smallest unit)"
    },
    "sender": {
      "type": "string",
      "description": "Sender wallet on source chain"
    },
    "recipient": {
      "type": "string",
      "description": "Recipient address on destination chain"
    },
    "relayerFee": {
      "type": "string",
      "description": "Raw token amount (smallest unit, no decimals)"
    }
  },
  "required": [
    "sourceChain",
    "destinationChain",
    "token",
    "amount",
    "sender",
    "recipient"
  ],
  "additionalProperties": false
}

bridging_bridgeWormholeStatus

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.

Parameters2

sequence	string	required	Wormhole sequence number from bridgeWormhole response
sourceChain	string	required	Source Chain parameter for Bridging Bridge Wormhole Status.

Raw schema

{
  "type": "object",
  "properties": {
    "sequence": {
      "type": "string",
      "description": "Wormhole sequence number from bridgeWormhole response"
    },
    "sourceChain": {
      "type": "string",
      "description": "Source Chain parameter for Bridging Bridge Wormhole Status."
    }
  },
  "required": [
    "sequence",
    "sourceChain"
  ],
  "additionalProperties": false
}

bridging_bridgeDeBridge

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 matching status tool after submission. If the bridge capability belongs to a registered SAP agent, advertise it with sap_publish_tool_by_name and include bridge capability IDs in sap_register_agent or sap_update_agent.

Parameters8

sourceChain	number	required	Source chain ID (e.g. 7565164 for Solana)
destinationChain	number	required	Destination chain ID
tokenIn	string	required	Token address on source chain
tokenOut	string	required	Token address on destination chain (use "0x0" for native)
amount	string	required	Amount to bridge (raw)
sender	string	required	Sender address
recipient	string	required	Recipient address on destination chain
slippageBps	number	optional	Slippage tolerance in bps

Raw schema

{
  "type": "object",
  "properties": {
    "sourceChain": {
      "type": "number",
      "description": "Source chain ID (e.g. 7565164 for Solana)"
    },
    "destinationChain": {
      "type": "number",
      "description": "Destination chain ID"
    },
    "tokenIn": {
      "type": "string",
      "description": "Token address on source chain"
    },
    "tokenOut": {
      "type": "string",
      "description": "Token address on destination chain (use \"0x0\" for native)"
    },
    "amount": {
      "type": "string",
      "description": "Amount to bridge (raw)"
    },
    "sender": {
      "type": "string",
      "description": "Sender address"
    },
    "recipient": {
      "type": "string",
      "description": "Recipient address on destination chain"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage tolerance in bps"
    }
  },
  "required": [
    "sourceChain",
    "destinationChain",
    "tokenIn",
    "tokenOut",
    "amount",
    "sender",
    "recipient"
  ],
  "additionalProperties": false
}

bridging_bridgeDeBridgeStatus

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.

Parameters1

orderId

string

required

deBridge DLN order ID

Raw schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "deBridge DLN order ID"
    }
  },
  "required": [
    "orderId"
  ],
  "additionalProperties": false
}

metaplex-nft_deployCollection

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 agent identity, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters8

authority	string	required	Collection authority wallet
name	string	required	Collection name
symbol	string	required	Collection symbol
uri	string	required	URI to collection metadata JSON
sellerFeeBasisPoints	number	optional	Royalty fee in bps (500 = 5%)
isMutable	boolean	optional	Is Mutable parameter for Metaplex-nft Deploy Collection.
maxSupply	number	optional	Max NFTs in collection (0 = unlimited)
creators	array	optional	Creator list with revenue shares (must sum to 100)

Raw schema

{
  "type": "object",
  "properties": {
    "authority": {
      "type": "string",
      "description": "Collection authority wallet"
    },
    "name": {
      "type": "string",
      "description": "Collection name"
    },
    "symbol": {
      "type": "string",
      "description": "Collection symbol"
    },
    "uri": {
      "type": "string",
      "description": "URI to collection metadata JSON"
    },
    "sellerFeeBasisPoints": {
      "type": "number",
      "description": "Royalty fee in bps (500 = 5%)"
    },
    "isMutable": {
      "type": "boolean",
      "description": "Is Mutable parameter for Metaplex-nft Deploy Collection."
    },
    "maxSupply": {
      "type": "number",
      "description": "Max NFTs in collection (0 = unlimited)"
    },
    "creators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Solana public key (base58)"
          },
          "share": {
            "type": "number",
            "description": "Revenue share percentage"
          },
          "verified": {
            "type": "boolean",
            "description": "Verified parameter for Metaplex-nft Deploy Collection."
          }
        },
        "required": [
          "address",
          "share"
        ],
        "additionalProperties": false,
        "description": "Creators parameter for Metaplex-nft Deploy Collection."
      },
      "description": "Creator list with revenue shares (must sum to 100)"
    }
  },
  "required": [
    "authority",
    "name",
    "symbol",
    "uri"
  ],
  "additionalProperties": false
}

metaplex-nft_mintNFT

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 identity, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters11

authority	string	required	Mint authority wallet
collection	string	optional	NFT mint address (base58)
name	string	required	NFT name
symbol	string	optional	NFT symbol
uri	string	required	URI to NFT metadata JSON (image, attributes, etc.)
sellerFeeBasisPoints	number	optional	Seller Fee Basis Points parameter for Metaplex-nft Mint N F T.
isMutable	boolean	optional	Is Mutable parameter for Metaplex-nft Mint N F T.
creators	array	optional	Creators parameter for Metaplex-nft Mint N F T.
recipient	string	optional	Solana public key (base58)
isCompressed	boolean	optional	Mint as compressed NFT (cNFT) for lower cost
merkleTree	string	optional	Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "authority": {
      "type": "string",
      "description": "Mint authority wallet"
    },
    "collection": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "name": {
      "type": "string",
      "description": "NFT name"
    },
    "symbol": {
      "type": "string",
      "description": "NFT symbol"
    },
    "uri": {
      "type": "string",
      "description": "URI to NFT metadata JSON (image, attributes, etc.)"
    },
    "sellerFeeBasisPoints": {
      "type": "number",
      "description": "Seller Fee Basis Points parameter for Metaplex-nft Mint N F T."
    },
    "isMutable": {
      "type": "boolean",
      "description": "Is Mutable parameter for Metaplex-nft Mint N F T."
    },
    "creators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Solana public key (base58)"
          },
          "share": {
            "type": "number",
            "description": "Share parameter for Metaplex-nft Mint N F T."
          },
          "verified": {
            "type": "boolean",
            "description": "Verified parameter for Metaplex-nft Mint N F T."
          }
        },
        "required": [
          "address",
          "share"
        ],
        "additionalProperties": false,
        "description": "Creators parameter for Metaplex-nft Mint N F T."
      },
      "description": "Creators parameter for Metaplex-nft Mint N F T."
    },
    "recipient": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "isCompressed": {
      "type": "boolean",
      "description": "Mint as compressed NFT (cNFT) for lower cost"
    },
    "merkleTree": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "authority",
    "name",
    "uri"
  ],
  "additionalProperties": false
}

metaplex-nft_updateMetadata

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters10

mint	string	required	NFT mint address
updateAuthority	string	required	Current update authority
name	string	optional	New name
symbol	string	optional	New symbol
uri	string	optional	New metadata URI
sellerFeeBasisPoints	number	optional	Seller Fee Basis Points parameter for Metaplex-nft Update Metadata.
creators	array	optional	Creators parameter for Metaplex-nft Update Metadata.
isMutable	boolean	optional	Is Mutable parameter for Metaplex-nft Update Metadata.
primarySaleHappened	boolean	optional	Primary Sale Happened parameter for Metaplex-nft Update Metadata.
newUpdateAuthority	string	optional	Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address"
    },
    "updateAuthority": {
      "type": "string",
      "description": "Current update authority"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "symbol": {
      "type": "string",
      "description": "New symbol"
    },
    "uri": {
      "type": "string",
      "description": "New metadata URI"
    },
    "sellerFeeBasisPoints": {
      "type": "number",
      "description": "Seller Fee Basis Points parameter for Metaplex-nft Update Metadata."
    },
    "creators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Solana public key (base58)"
          },
          "share": {
            "type": "number",
            "description": "Share parameter for Metaplex-nft Update Metadata."
          },
          "verified": {
            "type": "boolean",
            "description": "Verified parameter for Metaplex-nft Update Metadata."
          }
        },
        "required": [
          "address",
          "share"
        ],
        "additionalProperties": false,
        "description": "Creators parameter for Metaplex-nft Update Metadata."
      },
      "description": "Creators parameter for Metaplex-nft Update Metadata."
    },
    "isMutable": {
      "type": "boolean",
      "description": "Is Mutable parameter for Metaplex-nft Update Metadata."
    },
    "primarySaleHappened": {
      "type": "boolean",
      "description": "Primary Sale Happened parameter for Metaplex-nft Update Metadata."
    },
    "newUpdateAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "mint",
    "updateAuthority"
  ],
  "additionalProperties": false
}

metaplex-nft_verifyCreator

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters2

mint	string	required	NFT mint address (base58)
creator	string	required	Creator wallet to verify

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "creator": {
      "type": "string",
      "description": "Creator wallet to verify"
    }
  },
  "required": [
    "mint",
    "creator"
  ],
  "additionalProperties": false
}

metaplex-nft_verifyCollection

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters3

mint	string	required	NFT mint to verify
collection	string	required	Collection mint
collectionAuthority	string	required	Collection authority wallet

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint to verify"
    },
    "collection": {
      "type": "string",
      "description": "Collection mint"
    },
    "collectionAuthority": {
      "type": "string",
      "description": "Collection authority wallet"
    }
  },
  "required": [
    "mint",
    "collection",
    "collectionAuthority"
  ],
  "additionalProperties": false
}

metaplex-nft_setAndVerifyCollection

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters4

mint	string	required	NFT mint address (base58)
collection	string	required	NFT mint address (base58)
collectionAuthority	string	required	Solana public key (base58)
updateAuthority	string	required	NFT update authority

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "collection": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "collectionAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "updateAuthority": {
      "type": "string",
      "description": "NFT update authority"
    }
  },
  "required": [
    "mint",
    "collection",
    "collectionAuthority",
    "updateAuthority"
  ],
  "additionalProperties": false
}

metaplex-nft_delegateAuthority

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 identity, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters4

mint	string	required	NFT mint address (base58)
currentAuthority	string	required	Solana public key (base58)
newAuthority	string	required	Solana public key (base58)
authorityType	string	required	Type of authority to delegate

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "currentAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "newAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "authorityType": {
      "type": "string",
      "enum": [
        "update",
        "mint",
        "freeze",
        "collection"
      ],
      "description": "Type of authority to delegate"
    }
  },
  "required": [
    "mint",
    "currentAuthority",
    "newAuthority",
    "authorityType"
  ],
  "additionalProperties": false
}

metaplex-nft_revokeAuthority

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters3

mint	string	required	NFT mint address (base58)
authority	string	required	Current authority holder
authorityType	string	required	Authority Type parameter for Metaplex-nft Revoke Authority.

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "authority": {
      "type": "string",
      "description": "Current authority holder"
    },
    "authorityType": {
      "type": "string",
      "enum": [
        "update",
        "mint",
        "freeze",
        "collection"
      ],
      "description": "Authority Type parameter for Metaplex-nft Revoke Authority."
    }
  },
  "required": [
    "mint",
    "authority",
    "authorityType"
  ],
  "additionalProperties": false
}

metaplex-nft_configureRoyalties

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, keep sap_register_agent as the SAP on-chain registration step and use agentUri or metadataUri to point at off-chain or NFT-backed metadata. Use these Metaplex tools when the agent also needs an NFT collection, badge, or verifiable media asset.

Parameters4

mint	string	required	NFT mint address (base58)
updateAuthority	string	required	Solana public key (base58)
sellerFeeBasisPoints	number	required	Royalty fee in bps
creators	array	required	Creator list with revenue shares (must sum to 100)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "updateAuthority": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "sellerFeeBasisPoints": {
      "type": "number",
      "description": "Royalty fee in bps"
    },
    "creators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Solana public key (base58)"
          },
          "share": {
            "type": "number",
            "description": "Share parameter for Metaplex-nft Configure Royalties."
          }
        },
        "required": [
          "address",
          "share"
        ],
        "additionalProperties": false,
        "description": "Creators parameter for Metaplex-nft Configure Royalties."
      },
      "description": "Creator list with revenue shares (must sum to 100)"
    }
  },
  "required": [
    "mint",
    "updateAuthority",
    "sellerFeeBasisPoints",
    "creators"
  ],
  "additionalProperties": false
}

3land_createCollection

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 service catalog.

Parameters7

owner	string	required	Collection owner wallet
name	string	required	Collection name
symbol	string	required	Collection symbol
description	string	optional	Collection description
image	string	required	Collection cover image URL
royaltyBps	number	optional	Royalty Bps parameter for 3land Create Collection.
creators	array	optional	Creators parameter for 3land Create Collection.

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Collection owner wallet"
    },
    "name": {
      "type": "string",
      "description": "Collection name"
    },
    "symbol": {
      "type": "string",
      "description": "Collection symbol"
    },
    "description": {
      "type": "string",
      "description": "Collection description"
    },
    "image": {
      "type": "string",
      "description": "Collection cover image URL"
    },
    "royaltyBps": {
      "type": "number",
      "description": "Royalty Bps parameter for 3land Create Collection."
    },
    "creators": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "Solana public key (base58)"
          },
          "share": {
            "type": "number",
            "description": "Share parameter for 3land Create Collection."
          }
        },
        "required": [
          "address",
          "share"
        ],
        "additionalProperties": false,
        "description": "Creators parameter for 3land Create Collection."
      },
      "description": "Creators parameter for 3land Create Collection."
    }
  },
  "required": [
    "owner",
    "name",
    "symbol",
    "image"
  ],
  "additionalProperties": false
}

3land_mintAndList

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 identity or service catalog.

Parameters9

owner	string	required	Solana public key (base58)
collection	string	required	3.Land collection ID
name	string	required	Name name or domain value used by 3land Mint And List.
description	string	optional	Description parameter for 3land Mint And List.
image	string	required	NFT image URL
attributes	array	optional	Attributes parameter for 3land Mint And List.
price	string	required	Listing price in token amount
priceMint	string	optional	NFT mint address (base58)
supply	number	optional	Edition supply

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "collection": {
      "type": "string",
      "description": "3.Land collection ID"
    },
    "name": {
      "type": "string",
      "description": "Name name or domain value used by 3land Mint And List."
    },
    "description": {
      "type": "string",
      "description": "Description parameter for 3land Mint And List."
    },
    "image": {
      "type": "string",
      "description": "NFT image URL"
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "trait_type": {
            "type": "string",
            "description": "Trait Type parameter for 3land Mint And List."
          },
          "value": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              }
            ],
            "description": "Value parameter for 3land Mint And List."
          }
        },
        "required": [
          "trait_type",
          "value"
        ],
        "additionalProperties": false,
        "description": "Attributes parameter for 3land Mint And List."
      },
      "description": "Attributes parameter for 3land Mint And List."
    },
    "price": {
      "type": "string",
      "description": "Listing price in token amount"
    },
    "priceMint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "supply": {
      "type": "number",
      "description": "Edition supply"
    }
  },
  "required": [
    "owner",
    "collection",
    "name",
    "image",
    "price"
  ],
  "additionalProperties": false
}

3land_listForSale

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 service catalog.

Parameters5

seller	string	required	Solana public key (base58)
mint	string	required	NFT mint to list
price	string	required	Listing price (in specified token)
priceMint	string	optional	NFT mint address (base58)
expiry	string	optional	ISO 8601 listing expiry timestamp

Raw schema

{
  "type": "object",
  "properties": {
    "seller": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "NFT mint to list"
    },
    "price": {
      "type": "string",
      "description": "Listing price (in specified token)"
    },
    "priceMint": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "expiry": {
      "type": "string",
      "description": "ISO 8601 listing expiry timestamp"
    }
  },
  "required": [
    "seller",
    "mint",
    "price"
  ],
  "additionalProperties": false
}

3land_cancelListing

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 catalog.

Parameters2

seller	string	required	Solana public key (base58)
listingId	string	required	3.Land listing ID to cancel

Raw schema

{
  "type": "object",
  "properties": {
    "seller": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "listingId": {
      "type": "string",
      "description": "3.Land listing ID to cancel"
    }
  },
  "required": [
    "seller",
    "listingId"
  ],
  "additionalProperties": false
}

3land_buyNFT

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 catalog.

Parameters2

buyer	string	required	Solana public key (base58)
listingId	string	required	3.Land listing ID

Raw schema

{
  "type": "object",
  "properties": {
    "buyer": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "listingId": {
      "type": "string",
      "description": "3.Land listing ID"
    }
  },
  "required": [
    "buyer",
    "listingId"
  ],
  "additionalProperties": false
}

das_getAsset

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.

Parameters1

string

required

Asset mint address

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Asset mint address"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

das_getAssetsByOwner

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.

Parameters6

ownerAddress	string	required	Solana public key (base58)
page	number	optional	Page pagination control for Das Get Assets By Owner.
limit	number	optional	Limit controlling the maximum number of results returned by Das Get Assets By Owner.
sortBy	string	optional	Sort By parameter for Das Get Assets By Owner.
before	string	optional	Before parameter for Das Get Assets By Owner.
after	string	optional	After parameter for Das Get Assets By Owner.

Raw schema

{
  "type": "object",
  "properties": {
    "ownerAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Das Get Assets By Owner."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Das Get Assets By Owner."
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "created",
        "updated",
        "recent_action"
      ],
      "description": "Sort By parameter for Das Get Assets By Owner."
    },
    "before": {
      "type": "string",
      "description": "Before parameter for Das Get Assets By Owner."
    },
    "after": {
      "type": "string",
      "description": "After parameter for Das Get Assets By Owner."
    }
  },
  "required": [
    "ownerAddress"
  ],
  "additionalProperties": false
}

das_getAssetsByCreator

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.

Parameters4

creatorAddress	string	required	Solana public key (base58)
onlyVerified	boolean	optional	Only Verified parameter for Das Get Assets By Creator.
page	number	optional	Page pagination control for Das Get Assets By Creator.
limit	number	optional	Limit controlling the maximum number of results returned by Das Get Assets By Creator.

Raw schema

{
  "type": "object",
  "properties": {
    "creatorAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "onlyVerified": {
      "type": "boolean",
      "description": "Only Verified parameter for Das Get Assets By Creator."
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Das Get Assets By Creator."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Das Get Assets By Creator."
    }
  },
  "required": [
    "creatorAddress"
  ],
  "additionalProperties": false
}

das_getAssetsByCollection

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.

Parameters3

collectionAddress	string	required	NFT mint address (base58)
page	number	optional	Page pagination control for Das Get Assets By Collection.
limit	number	optional	Limit controlling the maximum number of results returned by Das Get Assets By Collection.

Raw schema

{
  "type": "object",
  "properties": {
    "collectionAddress": {
      "type": "string",
      "description": "NFT mint address (base58)"
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Das Get Assets By Collection."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Das Get Assets By Collection."
    }
  },
  "required": [
    "collectionAddress"
  ],
  "additionalProperties": false
}

das_searchAssets

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.

Parameters9

ownerAddress	string	optional	Solana public key (base58)
creatorAddress	string	optional	Solana public key (base58)
grouping	any	optional	Grouping key-value pair (e.g. ["collection", "mint_address"])
compressed	boolean	optional	Compressed parameter for Das Search Assets.
frozen	boolean	optional	Frozen parameter for Das Search Assets.
burnt	boolean	optional	Burnt parameter for Das Search Assets.
jsonUri	string	optional	Json URI parameter for Das Search Assets.
page	number	optional	Page pagination control for Das Search Assets.
limit	number	optional	Limit controlling the maximum number of results returned by Das Search Assets.

Raw schema

{
  "type": "object",
  "properties": {
    "ownerAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "creatorAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "grouping": {
      "description": "Grouping key-value pair (e.g. [\"collection\", \"mint_address\"])"
    },
    "compressed": {
      "type": "boolean",
      "description": "Compressed parameter for Das Search Assets."
    },
    "frozen": {
      "type": "boolean",
      "description": "Frozen parameter for Das Search Assets."
    },
    "burnt": {
      "type": "boolean",
      "description": "Burnt parameter for Das Search Assets."
    },
    "jsonUri": {
      "type": "string",
      "description": "Json URI parameter for Das Search Assets."
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Das Search Assets."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Das Search Assets."
    }
  },
  "additionalProperties": false
}

pump_launchToken

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_register_agent, sap_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.

Parameters9

deployer	string	required	Deployer wallet
name	string	required	Token name
symbol	string	required	Token ticker
description	string	optional	Description parameter for Pump Launch Token.
image	string	optional	Token logo URL
twitter	string	optional	Twitter/X handle
telegram	string	optional	Telegram group link
website	string	optional	Website URL
initialBuyAmount	string	optional	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "deployer": {
      "type": "string",
      "description": "Deployer wallet"
    },
    "name": {
      "type": "string",
      "description": "Token name"
    },
    "symbol": {
      "type": "string",
      "description": "Token ticker"
    },
    "description": {
      "type": "string",
      "description": "Description parameter for Pump Launch Token."
    },
    "image": {
      "type": "string",
      "description": "Token logo URL"
    },
    "twitter": {
      "type": "string",
      "description": "Twitter/X handle"
    },
    "telegram": {
      "type": "string",
      "description": "Telegram group link"
    },
    "website": {
      "type": "string",
      "description": "Website URL"
    },
    "initialBuyAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "deployer",
    "name",
    "symbol"
  ],
  "additionalProperties": false
}

pump_trade

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_register_agent, sap_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.

Parameters5

wallet	string	required	Solana public key (base58)
mint	string	required	Pump.fun token mint
action	string	required	Trade direction
amount	string	required	Amount in SOL (buy) or tokens (sell)
slippageBps	number	optional	Slippage Bps pagination control for Pump Trade.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Pump.fun token mint"
    },
    "action": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "description": "Trade direction"
    },
    "amount": {
      "type": "string",
      "description": "Amount in SOL (buy) or tokens (sell)"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage Bps pagination control for Pump Trade."
    }
  },
  "required": [
    "wallet",
    "mint",
    "action",
    "amount"
  ],
  "additionalProperties": false
}

raydium-pools_createCPMM

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_register_agent, sap_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.

Parameters6

creator	string	required	Solana public key (base58)
mintA	string	required	Token A mint
mintB	string	required	Token B mint
amountA	string	required	Initial liquidity for token A
amountB	string	required	Initial liquidity for token B
startTime	number	optional	Pool start time (Unix timestamp)

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mintA": {
      "type": "string",
      "description": "Token A mint"
    },
    "mintB": {
      "type": "string",
      "description": "Token B mint"
    },
    "amountA": {
      "type": "string",
      "description": "Initial liquidity for token A"
    },
    "amountB": {
      "type": "string",
      "description": "Initial liquidity for token B"
    },
    "startTime": {
      "type": "number",
      "description": "Pool start time (Unix timestamp)"
    }
  },
  "required": [
    "creator",
    "mintA",
    "mintB",
    "amountA",
    "amountB"
  ],
  "additionalProperties": false
}

raydium-pools_createCLMM

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_register_agent, sap_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.

Parameters10

creator	string	required	Solana public key (base58)
mintA	string	required	Token mint address (base58)
mintB	string	required	Token mint address (base58)
initialPrice	number	required	Initial price of token A in terms of token B
tickSpacing	number	required	Tick spacing (defines fee tier: 1=0.01%, 10=0.05%, 60=0.3%, 200=1%)
amountA	string	required	Initial liquidity for token A
amountB	string	required	Initial liquidity for token B
priceLower	number	required	Lower price bound for liquidity range
priceUpper	number	required	Upper price bound for liquidity range
startTime	number	optional	Start Time parameter for Raydium-pools Create C L M M.

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mintA": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "mintB": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "initialPrice": {
      "type": "number",
      "description": "Initial price of token A in terms of token B"
    },
    "tickSpacing": {
      "type": "number",
      "description": "Tick spacing (defines fee tier: 1=0.01%, 10=0.05%, 60=0.3%, 200=1%)"
    },
    "amountA": {
      "type": "string",
      "description": "Initial liquidity for token A"
    },
    "amountB": {
      "type": "string",
      "description": "Initial liquidity for token B"
    },
    "priceLower": {
      "type": "number",
      "description": "Lower price bound for liquidity range"
    },
    "priceUpper": {
      "type": "number",
      "description": "Upper price bound for liquidity range"
    },
    "startTime": {
      "type": "number",
      "description": "Start Time parameter for Raydium-pools Create C L M M."
    }
  },
  "required": [
    "creator",
    "mintA",
    "mintB",
    "initialPrice",
    "tickSpacing",
    "amountA",
    "amountB",
    "priceLower",
    "priceUpper"
  ],
  "additionalProperties": false
}

raydium-pools_createAMMv4

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_register_agent, sap_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.

Parameters5

creator	string	required	Solana public key (base58)
marketId	string	required	Openbook market ID
baseAmount	string	required	Raw token amount (smallest unit)
quoteAmount	string	required	Raw token amount (smallest unit)
startTime	number	optional	Start Time parameter for Raydium-pools Create A M Mv4.

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketId": {
      "type": "string",
      "description": "Openbook market ID"
    },
    "baseAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "quoteAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "startTime": {
      "type": "number",
      "description": "Start Time parameter for Raydium-pools Create A M Mv4."
    }
  },
  "required": [
    "creator",
    "marketId",
    "baseAmount",
    "quoteAmount"
  ],
  "additionalProperties": false
}

raydium-pools_addLiquidity

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_register_agent, sap_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.

Parameters7

wallet	string	required	Solana public key (base58)
poolId	string	required	Raydium pool ID
amountA	string	optional	Raw token amount (smallest unit)
amountB	string	optional	Raw token amount (smallest unit)
priceLower	number	optional	Lower price for CLMM range
priceUpper	number	optional	Upper price for CLMM range
fixedSide	string	optional	Fixed side for single-sided liquidity

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolId": {
      "type": "string",
      "description": "Raydium pool ID"
    },
    "amountA": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "amountB": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "priceLower": {
      "type": "number",
      "description": "Lower price for CLMM range"
    },
    "priceUpper": {
      "type": "number",
      "description": "Upper price for CLMM range"
    },
    "fixedSide": {
      "type": "string",
      "enum": [
        "a",
        "b"
      ],
      "description": "Fixed side for single-sided liquidity"
    }
  },
  "required": [
    "wallet",
    "poolId"
  ],
  "additionalProperties": false
}

raydium-pools_removeLiquidity

Remove liquidity from a Raydium pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters5

wallet	string	required	Solana public key (base58)
poolId	string	required	Solana public key (base58)
lpAmount	string	optional	Raw token amount (smallest unit)
positionNft	string	optional	Token mint address (base58)
percentage	number	optional	Percentage of liquidity to remove

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "lpAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "positionNft": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "percentage": {
      "type": "number",
      "description": "Percentage of liquidity to remove"
    }
  },
  "required": [
    "wallet",
    "poolId"
  ],
  "additionalProperties": false
}

orca_getWhirlpool

Get Orca Whirlpool pool information. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters1

poolAddress

string

required

Whirlpool pool address

Raw schema

{
  "type": "object",
  "properties": {
    "poolAddress": {
      "type": "string",
      "description": "Whirlpool pool address"
    }
  },
  "required": [
    "poolAddress"
  ],
  "additionalProperties": false
}

orca_swap

Swap tokens on an Orca Whirlpool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters6

wallet	string	required	Solana public key (base58)
poolAddress	string	required	Solana public key (base58)
inputMint	string	required	Token mint address (base58)
amount	string	required	Raw token amount (smallest unit)
slippageBps	number	optional	Slippage Bps pagination control for Orca Swap.
isExactInput	boolean	optional	Is Exact Input parameter for Orca Swap.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage Bps pagination control for Orca Swap."
    },
    "isExactInput": {
      "type": "boolean",
      "description": "Is Exact Input parameter for Orca Swap."
    }
  },
  "required": [
    "wallet",
    "poolAddress",
    "inputMint",
    "amount"
  ],
  "additionalProperties": false
}

orca_openPosition

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_register_agent, sap_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.

Parameters6

wallet	string	required	Solana public key (base58)
poolAddress	string	required	Solana public key (base58)
priceLower	number	required	Price Lower parameter for Orca Open Position.
priceUpper	number	required	Price Upper parameter for Orca Open Position.
amountA	string	optional	Raw token amount (smallest unit)
amountB	string	optional	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "priceLower": {
      "type": "number",
      "description": "Price Lower parameter for Orca Open Position."
    },
    "priceUpper": {
      "type": "number",
      "description": "Price Upper parameter for Orca Open Position."
    },
    "amountA": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "amountB": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "poolAddress",
    "priceLower",
    "priceUpper"
  ],
  "additionalProperties": false
}

orca_closePosition

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_register_agent, sap_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.

Parameters2

wallet	string	required	Solana public key (base58)
positionMint	string	required	Token mint address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    }
  },
  "required": [
    "wallet",
    "positionMint"
  ],
  "additionalProperties": false
}

orca_collectFees

Collect accumulated fees from a Whirlpool position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters2

wallet	string	required	Solana public key (base58)
positionMint	string	required	Token mint address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    }
  },
  "required": [
    "wallet",
    "positionMint"
  ],
  "additionalProperties": false
}

manifest_createMarket

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_register_agent, sap_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.

Parameters3

creator	string	required	Solana public key (base58)
baseMint	string	required	Base token mint
quoteMint	string	required	Quote token mint

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "baseMint": {
      "type": "string",
      "description": "Base token mint"
    },
    "quoteMint": {
      "type": "string",
      "description": "Quote token mint"
    }
  },
  "required": [
    "creator",
    "baseMint",
    "quoteMint"
  ],
  "additionalProperties": false
}

manifest_placeLimitOrder

Place a limit order on a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters6

wallet	string	required	Solana public key (base58)
marketId	string	required	Solana public key (base58)
side	string	required	Side parameter for Manifest Place Limit Order.
price	number	required	Limit price
size	string	required	Order size in base tokens
orderType	string	optional	Order Type parameter for Manifest Place Limit Order.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "description": "Side parameter for Manifest Place Limit Order."
    },
    "price": {
      "type": "number",
      "description": "Limit price"
    },
    "size": {
      "type": "string",
      "description": "Order size in base tokens"
    },
    "orderType": {
      "type": "string",
      "enum": [
        "limit",
        "postOnly",
        "ioc"
      ],
      "description": "Order Type parameter for Manifest Place Limit Order."
    }
  },
  "required": [
    "wallet",
    "marketId",
    "side",
    "price",
    "size"
  ],
  "additionalProperties": false
}

manifest_cancelOrder

Cancel a limit order on a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
marketId	string	required	Solana public key (base58)
orderId	string	required	Order ID parameter for Manifest Cancel Order.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "orderId": {
      "type": "string",
      "description": "Order ID parameter for Manifest Cancel Order."
    }
  },
  "required": [
    "wallet",
    "marketId",
    "orderId"
  ],
  "additionalProperties": false
}

manifest_getOrderbook

Get the current orderbook for a Manifest market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters2

marketId	string	required	Solana public key (base58)
depth	number	optional	Depth parameter for Manifest Get Orderbook.

Raw schema

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "depth": {
      "type": "number",
      "description": "Depth parameter for Manifest Get Orderbook."
    }
  },
  "required": [
    "marketId"
  ],
  "additionalProperties": false
}

meteora_createDynamicPool

Create a Meteora Dynamic AMM pool. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters9

creator	string	required	Solana public key (base58)
mintA	string	required	Token mint address (base58)
mintB	string	required	Token mint address (base58)
amountA	string	required	Raw token amount (smallest unit)
amountB	string	required	Raw token amount (smallest unit)
tradeFeeNumerator	number	optional	Trade fee numerator (default pool fee)
tradeFeeDenominator	number	optional	Trade Fee Denominator parameter for Meteora Create Dynamic Pool.
activationType	string	optional	Activation Type parameter for Meteora Create Dynamic Pool.
activationPoint	number	optional	Activation slot/timestamp

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mintA": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "mintB": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amountA": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "amountB": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "tradeFeeNumerator": {
      "type": "number",
      "description": "Trade fee numerator (default pool fee)"
    },
    "tradeFeeDenominator": {
      "type": "number",
      "description": "Trade Fee Denominator parameter for Meteora Create Dynamic Pool."
    },
    "activationType": {
      "type": "string",
      "enum": [
        "slot",
        "timestamp"
      ],
      "description": "Activation Type parameter for Meteora Create Dynamic Pool."
    },
    "activationPoint": {
      "type": "number",
      "description": "Activation slot/timestamp"
    }
  },
  "required": [
    "creator",
    "mintA",
    "mintB",
    "amountA",
    "amountB"
  ],
  "additionalProperties": false
}

meteora_createDLMMPool

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_register_agent, sap_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.

Parameters11

creator	string	required	Solana public key (base58)
mintX	string	required	Token X mint
mintY	string	required	Token Y mint
binStep	number	required	Bin step size (defines fee tier and price granularity)
initialPrice	number	required	Initial Price parameter for Meteora Create D L M M Pool.
amountX	string	optional	Raw token amount (smallest unit)
amountY	string	optional	Raw token amount (smallest unit)
priceRoundingUp	boolean	optional	Price Rounding Up parameter for Meteora Create D L M M Pool.
feeBps	number	optional	Fee Bps parameter for Meteora Create D L M M Pool.
activationType	string	optional	Activation Type parameter for Meteora Create D L M M Pool.
activationPoint	number	optional	Activation Point parameter for Meteora Create D L M M Pool.

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mintX": {
      "type": "string",
      "description": "Token X mint"
    },
    "mintY": {
      "type": "string",
      "description": "Token Y mint"
    },
    "binStep": {
      "type": "number",
      "description": "Bin step size (defines fee tier and price granularity)"
    },
    "initialPrice": {
      "type": "number",
      "description": "Initial Price parameter for Meteora Create D L M M Pool."
    },
    "amountX": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "amountY": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "priceRoundingUp": {
      "type": "boolean",
      "description": "Price Rounding Up parameter for Meteora Create D L M M Pool."
    },
    "feeBps": {
      "type": "number",
      "description": "Fee Bps parameter for Meteora Create D L M M Pool."
    },
    "activationType": {
      "type": "string",
      "enum": [
        "slot",
        "timestamp"
      ],
      "description": "Activation Type parameter for Meteora Create D L M M Pool."
    },
    "activationPoint": {
      "type": "number",
      "description": "Activation Point parameter for Meteora Create D L M M Pool."
    }
  },
  "required": [
    "creator",
    "mintX",
    "mintY",
    "binStep",
    "initialPrice"
  ],
  "additionalProperties": false
}

meteora_addDLMMLiquidity

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_register_agent, sap_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.

Parameters7

wallet	string	required	Solana public key (base58)
poolAddress	string	required	Solana public key (base58)
amountX	string	required	Raw token amount (smallest unit)
amountY	string	required	Raw token amount (smallest unit)
strategy	string	optional	Liquidity distribution strategy
minBinId	number	optional	Min Bin ID parameter for Meteora Add D L M M Liquidity.
maxBinId	number	optional	Max Bin ID parameter for Meteora Add D L M M Liquidity.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amountX": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "amountY": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "strategy": {
      "type": "string",
      "enum": [
        "spot",
        "curve",
        "bid-ask"
      ],
      "description": "Liquidity distribution strategy"
    },
    "minBinId": {
      "type": "number",
      "description": "Min Bin ID parameter for Meteora Add D L M M Liquidity."
    },
    "maxBinId": {
      "type": "number",
      "description": "Max Bin ID parameter for Meteora Add D L M M Liquidity."
    }
  },
  "required": [
    "wallet",
    "poolAddress",
    "amountX",
    "amountY"
  ],
  "additionalProperties": false
}

meteora_removeDLMMLiquidity

Remove liquidity from a Meteora DLMM position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
positionAddress	string	required	Solana public key (base58)
percentage	number	optional	Percentage parameter for Meteora Remove D L M M Liquidity.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "percentage": {
      "type": "number",
      "description": "Percentage parameter for Meteora Remove D L M M Liquidity."
    }
  },
  "required": [
    "wallet",
    "positionAddress"
  ],
  "additionalProperties": false
}

meteora_createAlphaVault

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_register_agent, sap_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.

Parameters6

creator	string	required	Solana public key (base58)
poolAddress	string	required	Solana public key (base58)
depositMint	string	required	Token mint accepted for deposits
maxDeposit	string	required	Maximum deposit cap
vestingDuration	number	required	Vesting duration in seconds
startTime	number	optional	Vault start time (Unix timestamp)

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "poolAddress": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "depositMint": {
      "type": "string",
      "description": "Token mint accepted for deposits"
    },
    "maxDeposit": {
      "type": "string",
      "description": "Maximum deposit cap"
    },
    "vestingDuration": {
      "type": "number",
      "description": "Vesting duration in seconds"
    },
    "startTime": {
      "type": "number",
      "description": "Vault start time (Unix timestamp)"
    }
  },
  "required": [
    "creator",
    "poolAddress",
    "depositMint",
    "maxDeposit",
    "vestingDuration"
  ],
  "additionalProperties": false
}

openbook_createMarket

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_register_agent, sap_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.

Parameters5

creator	string	required	Solana public key (base58)
baseMint	string	required	Token mint address (base58)
quoteMint	string	required	Token mint address (base58)
lotSize	number	required	Minimum order size
tickSize	number	required	Minimum price increment

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "baseMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "quoteMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "lotSize": {
      "type": "number",
      "description": "Minimum order size"
    },
    "tickSize": {
      "type": "number",
      "description": "Minimum price increment"
    }
  },
  "required": [
    "creator",
    "baseMint",
    "quoteMint",
    "lotSize",
    "tickSize"
  ],
  "additionalProperties": false
}

openbook_placeOrder

Place an order on an Openbook market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters6

wallet	string	required	Solana public key (base58)
marketId	string	required	Solana public key (base58)
side	string	required	Side parameter for Openbook Place Order.
price	number	required	Price parameter for Openbook Place Order.
size	string	required	Raw token amount (smallest unit)
orderType	string	optional	Order Type parameter for Openbook Place Order.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "description": "Side parameter for Openbook Place Order."
    },
    "price": {
      "type": "number",
      "description": "Price parameter for Openbook Place Order."
    },
    "size": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "orderType": {
      "type": "string",
      "enum": [
        "limit",
        "ioc",
        "postOnly"
      ],
      "description": "Order Type parameter for Openbook Place Order."
    }
  },
  "required": [
    "wallet",
    "marketId",
    "side",
    "price",
    "size"
  ],
  "additionalProperties": false
}

openbook_cancelOrder

Cancel an open order on an Openbook market. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
marketId	string	required	Solana public key (base58)
orderId	string	required	Order ID parameter for Openbook Cancel Order.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketId": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "orderId": {
      "type": "string",
      "description": "Order ID parameter for Openbook Cancel Order."
    }
  },
  "required": [
    "wallet",
    "marketId",
    "orderId"
  ],
  "additionalProperties": false
}

drift_deposit

Deposit tokens into a Drift account for trading or lending. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters4

wallet	string	required	Solana public key (base58)
mint	string	required	Token to deposit (e.g. USDC, SOL)
amount	string	required	Raw token amount (smallest unit)
subAccountId	number	optional	Sub Account ID parameter for Drift Deposit.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token to deposit (e.g. USDC, SOL)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Deposit."
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

drift_withdraw

Withdraw tokens from a Drift account. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters4

wallet	string	required	Solana public key (base58)
mint	string	required	Token mint address (base58)
amount	string	required	Raw token amount (smallest unit)
subAccountId	number	optional	Sub Account ID parameter for Drift Withdraw.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Withdraw."
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

drift_openPerpPosition

Open a perpetual futures position on Drift. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters9

wallet	string	required	Solana public key (base58)
marketIndex	number	required	Drift perp market index (0=SOL-PERP, 1=BTC-PERP, etc.)
direction	string	required	Direction parameter for Drift Open Perp Position.
size	string	required	Position size in base token units
leverage	number	optional	Leverage multiplier (max 20x)
orderType	string	optional	Order Type parameter for Drift Open Perp Position.
price	number	optional	Limit price (required for limit orders)
reduceOnly	boolean	optional	Reduce Only parameter for Drift Open Perp Position.
subAccountId	number	optional	Sub Account ID parameter for Drift Open Perp Position.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketIndex": {
      "type": "number",
      "description": "Drift perp market index (0=SOL-PERP, 1=BTC-PERP, etc.)"
    },
    "direction": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ],
      "description": "Direction parameter for Drift Open Perp Position."
    },
    "size": {
      "type": "string",
      "description": "Position size in base token units"
    },
    "leverage": {
      "type": "number",
      "description": "Leverage multiplier (max 20x)"
    },
    "orderType": {
      "type": "string",
      "enum": [
        "market",
        "limit"
      ],
      "description": "Order Type parameter for Drift Open Perp Position."
    },
    "price": {
      "type": "number",
      "description": "Limit price (required for limit orders)"
    },
    "reduceOnly": {
      "type": "boolean",
      "description": "Reduce Only parameter for Drift Open Perp Position."
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Open Perp Position."
    }
  },
  "required": [
    "wallet",
    "marketIndex",
    "direction",
    "size"
  ],
  "additionalProperties": false
}

drift_closePerpPosition

Close a perpetual position on Drift. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
marketIndex	number	required	Market Index parameter for Drift Close Perp Position.
subAccountId	number	optional	Sub Account ID parameter for Drift Close Perp Position.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "marketIndex": {
      "type": "number",
      "description": "Market Index parameter for Drift Close Perp Position."
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Close Perp Position."
    }
  },
  "required": [
    "wallet",
    "marketIndex"
  ],
  "additionalProperties": false
}

drift_getPositions

Get all open positions and account info for a Drift account. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters2

wallet	string	required	Solana public key (base58)
subAccountId	number	optional	Sub Account ID parameter for Drift Get Positions.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Get Positions."
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

drift_lend

Lend tokens on Drift to earn interest. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters4

wallet	string	required	Solana public key (base58)
mint	string	required	Token mint address (base58)
amount	string	required	Raw token amount (smallest unit)
subAccountId	number	optional	Sub Account ID parameter for Drift Lend.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Lend."
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

drift_borrow

Borrow tokens on Drift against deposited collateral. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters4

wallet	string	required	Solana public key (base58)
mint	string	required	Token mint address (base58)
amount	string	required	Raw token amount (smallest unit)
subAccountId	number	optional	Sub Account ID parameter for Drift Borrow.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "subAccountId": {
      "type": "number",
      "description": "Sub Account ID parameter for Drift Borrow."
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

adrena_openPosition

Open a leveraged perpetual position on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters8

wallet	string	required	Solana public key (base58)
market	string	required	Market symbol (e.g. "SOL", "BTC", "ETH")
collateralMint	string	required	Collateral token mint (e.g. USDC, SOL)
collateralAmount	string	required	Raw token amount (smallest unit)
side	string	required	Side parameter for Adrena Open Position.
leverage	number	required	Leverage multiplier
stopLoss	number	optional	Stop loss price
takeProfit	number	optional	Take profit price

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "market": {
      "type": "string",
      "description": "Market symbol (e.g. \"SOL\", \"BTC\", \"ETH\")"
    },
    "collateralMint": {
      "type": "string",
      "description": "Collateral token mint (e.g. USDC, SOL)"
    },
    "collateralAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    },
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ],
      "description": "Side parameter for Adrena Open Position."
    },
    "leverage": {
      "type": "number",
      "description": "Leverage multiplier"
    },
    "stopLoss": {
      "type": "number",
      "description": "Stop loss price"
    },
    "takeProfit": {
      "type": "number",
      "description": "Take profit price"
    }
  },
  "required": [
    "wallet",
    "market",
    "collateralMint",
    "collateralAmount",
    "side",
    "leverage"
  ],
  "additionalProperties": false
}

adrena_closePosition

Close a perpetual position on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters2

wallet	string	required	Solana public key (base58)
positionKey	string	required	Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionKey": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "wallet",
    "positionKey"
  ],
  "additionalProperties": false
}

adrena_addCollateral

Add collateral to an existing Adrena position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
positionKey	string	required	Solana public key (base58)
amount	string	required	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionKey": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "positionKey",
    "amount"
  ],
  "additionalProperties": false
}

adrena_removeCollateral

Remove collateral from an Adrena position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
positionKey	string	required	Solana public key (base58)
amount	string	required	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "positionKey": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "positionKey",
    "amount"
  ],
  "additionalProperties": false
}

adrena_getPositions

Get all open positions on Adrena Protocol. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters1

wallet

string

required

Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

lulo_deposit

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_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
mint	string	required	Token to deposit (e.g. USDC)
amount	string	required	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token to deposit (e.g. USDC)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

lulo_withdraw

Withdraw from Lulo lending position. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters3

wallet	string	required	Solana public key (base58)
mint	string	required	Token mint address (base58)
amount	string	required	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "mint",
    "amount"
  ],
  "additionalProperties": false
}

lulo_getBestRates

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_register_agent, sap_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.

Parameters1

mint

string

optional

Token mint address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    }
  },
  "additionalProperties": false
}

lulo_getPositions

Get all Lulo lending positions for a wallet. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters1

wallet

string

required

Solana public key (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

jito_sendBundle

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_register_agent, sap_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.

Parameters2

transactions	array	required	Array of base64-encoded signed transactions (max 5)
tipLamports	string	optional	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "transactions": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Base64-encoded serialized transaction"
      },
      "description": "Array of base64-encoded signed transactions (max 5)"
    },
    "tipLamports": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "transactions"
  ],
  "additionalProperties": false
}

jito_getBundleStatus

Check the status of a submitted Jito bundle. SAP MCP context: This Synapse AgentKit tool is served beside the sap_* SDK tools. Use sap_register_agent, sap_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.

Parameters1

bundleId

string

required

Bundle ID parameter for Jito Get Bundle Status.

Raw schema

{
  "type": "object",
  "properties": {
    "bundleId": {
      "type": "string",
      "description": "Bundle ID parameter for Jito Get Bundle Status."
    }
  },
  "required": [
    "bundleId"
  ],
  "additionalProperties": false
}

jito_getTipEstimate

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_register_agent, sap_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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

sns_resolveDomain

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.

Parameters1

domain

string

required

Full domain name (e.g. "myname.sol")

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Full domain name (e.g. \"myname.sol\")"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

sns_reverseLookup

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.

Parameters1

wallet

string

required

Wallet address to reverse-lookup

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address to reverse-lookup"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

alldomains_registerDomain

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.

Parameters3

wallet	string	required	Solana public key (base58)
domain	string	required	Full domain (e.g. "myname.abc", "trader.bonk")
tld	string	optional	TLD if not included in domain string

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "domain": {
      "type": "string",
      "description": "Full domain (e.g. \"myname.abc\", \"trader.bonk\")"
    },
    "tld": {
      "type": "string",
      "description": "TLD if not included in domain string"
    }
  },
  "required": [
    "wallet",
    "domain"
  ],
  "additionalProperties": false
}

alldomains_resolveDomain

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.

Parameters1

domain

string

required

Full domain to resolve

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Full domain to resolve"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

alldomains_getOwnedDomains

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.

Parameters2

wallet	string	required	Solana public key (base58)
tld	string	optional	Filter by TLD

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "tld": {
      "type": "string",
      "description": "Filter by TLD"
    }
  },
  "required": [
    "wallet"
  ],
  "additionalProperties": false
}

pyth_getPrice

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.

Parameters1

priceId

string

required

Pyth price feed ID (hex) or symbol (e.g. "SOL/USD")

Raw schema

{
  "type": "object",
  "properties": {
    "priceId": {
      "type": "string",
      "description": "Pyth price feed ID (hex) or symbol (e.g. \"SOL/USD\")"
    }
  },
  "required": [
    "priceId"
  ],
  "additionalProperties": false
}

pyth_getPriceHistory

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.

Parameters2

priceId	string	required	Price ID parameter for Pyth Get Price History.
period	string	optional	Period parameter for Pyth Get Price History.

Raw schema

{
  "type": "object",
  "properties": {
    "priceId": {
      "type": "string",
      "description": "Price ID parameter for Pyth Get Price History."
    },
    "period": {
      "type": "string",
      "enum": [
        "1h",
        "4h",
        "1d",
        "7d",
        "30d"
      ],
      "description": "Period parameter for Pyth Get Price History."
    }
  },
  "required": [
    "priceId"
  ],
  "additionalProperties": false
}

pyth_listPriceFeeds

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.

Parameters2

query	string	optional	Search filter (e.g. "SOL", "BTC")
assetType	string	optional	Asset Type parameter for Pyth List Price Feeds.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search filter (e.g. \"SOL\", \"BTC\")"
    },
    "assetType": {
      "type": "string",
      "enum": [
        "crypto",
        "equity",
        "fx",
        "metal",
        "rates"
      ],
      "description": "Asset Type parameter for Pyth List Price Feeds."
    }
  },
  "additionalProperties": false
}

coingecko_getTokenPrice

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.

Parameters5

tokenId	string	required	CoinGecko token ID or contract address
vsCurrency	string	optional	Vs Currency parameter for Coingecko Get Token Price.
includeMarketCap	boolean	optional	Include Market Cap parameter for Coingecko Get Token Price.
include24hChange	boolean	optional	Include24h Change parameter for Coingecko Get Token Price.
include24hVolume	boolean	optional	Include24h Volume parameter for Coingecko Get Token Price.

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "string",
      "description": "CoinGecko token ID or contract address"
    },
    "vsCurrency": {
      "type": "string",
      "description": "Vs Currency parameter for Coingecko Get Token Price."
    },
    "includeMarketCap": {
      "type": "boolean",
      "description": "Include Market Cap parameter for Coingecko Get Token Price."
    },
    "include24hChange": {
      "type": "boolean",
      "description": "Include24h Change parameter for Coingecko Get Token Price."
    },
    "include24hVolume": {
      "type": "boolean",
      "description": "Include24h Volume parameter for Coingecko Get Token Price."
    }
  },
  "required": [
    "tokenId"
  ],
  "additionalProperties": false
}

coingecko_getTrending

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

coingecko_getTopGainersLosers

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.

Parameters2

vsCurrency	string	optional	Vs Currency parameter for Coingecko Get Top Gainers Losers.
duration	string	optional	Duration parameter for Coingecko Get Top Gainers Losers.

Raw schema

{
  "type": "object",
  "properties": {
    "vsCurrency": {
      "type": "string",
      "description": "Vs Currency parameter for Coingecko Get Top Gainers Losers."
    },
    "duration": {
      "type": "string",
      "enum": [
        "1h",
        "24h",
        "7d",
        "14d",
        "30d",
        "1y"
      ],
      "description": "Duration parameter for Coingecko Get Top Gainers Losers."
    }
  },
  "additionalProperties": false
}

coingecko_getTokenInfo

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.

Parameters1

tokenId

string

required

CoinGecko token ID

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "string",
      "description": "CoinGecko token ID"
    }
  },
  "required": [
    "tokenId"
  ],
  "additionalProperties": false
}

coingecko_getPoolsByToken

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.

Parameters3

network	string	optional	Network Solana network or cluster selector for Coingecko Get Pools By Token.
tokenAddress	string	required	Token contract/mint address
page	number	optional	Page pagination control for Coingecko Get Pools By Token.

Raw schema

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "description": "Network Solana network or cluster selector for Coingecko Get Pools By Token."
    },
    "tokenAddress": {
      "type": "string",
      "description": "Token contract/mint address"
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Coingecko Get Pools By Token."
    }
  },
  "required": [
    "tokenAddress"
  ],
  "additionalProperties": false
}

coingecko_getOHLCV

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.

Parameters3

tokenId	string	required	Token ID mint, symbol, or token identifier used by Coingecko Get O H L C V.
vsCurrency	string	optional	Vs Currency parameter for Coingecko Get O H L C V.
days	string	optional	Days parameter for Coingecko Get O H L C V.

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "string",
      "description": "Token ID mint, symbol, or token identifier used by Coingecko Get O H L C V."
    },
    "vsCurrency": {
      "type": "string",
      "description": "Vs Currency parameter for Coingecko Get O H L C V."
    },
    "days": {
      "type": "string",
      "enum": [
        "1",
        "7",
        "14",
        "30",
        "90",
        "180",
        "365",
        "max"
      ],
      "description": "Days parameter for Coingecko Get O H L C V."
    }
  },
  "required": [
    "tokenId"
  ],
  "additionalProperties": false
}

gibwork_createBounty

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.

Parameters7

creator	string	required	Solana public key (base58)
title	string	required	Bounty title
description	string	required	Detailed bounty description
rewardMint	string	optional	Token mint address (base58)
rewardAmount	string	required	Reward amount
tags	array	optional	Tags parameter for Gibwork Create Bounty.
deadline	number	optional	Deadline (Unix timestamp)

Raw schema

{
  "type": "object",
  "properties": {
    "creator": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "title": {
      "type": "string",
      "description": "Bounty title"
    },
    "description": {
      "type": "string",
      "description": "Detailed bounty description"
    },
    "rewardMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "rewardAmount": {
      "type": "string",
      "description": "Reward amount"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Tags parameter for Gibwork Create Bounty."
      },
      "description": "Tags parameter for Gibwork Create Bounty."
    },
    "deadline": {
      "type": "number",
      "description": "Deadline (Unix timestamp)"
    }
  },
  "required": [
    "creator",
    "title",
    "description",
    "rewardAmount"
  ],
  "additionalProperties": false
}

gibwork_listBounties

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.

Parameters3

status	string	optional	Status parameter for Gibwork List Bounties.
tags	array	optional	Tags parameter for Gibwork List Bounties.
limit	number	optional	Limit controlling the maximum number of results returned by Gibwork List Bounties.

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "open",
        "in_progress",
        "completed",
        "cancelled"
      ],
      "description": "Status parameter for Gibwork List Bounties."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Tags parameter for Gibwork List Bounties."
      },
      "description": "Tags parameter for Gibwork List Bounties."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Gibwork List Bounties."
    }
  },
  "additionalProperties": false
}

gibwork_submitWork

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.

Parameters4

wallet	string	required	Solana public key (base58)
bountyId	string	required	Bounty ID parameter for Gibwork Submit Work.
submissionUrl	string	required	URL to the completed work (PR, doc, etc.)
notes	string	optional	Notes parameter for Gibwork Submit Work.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "bountyId": {
      "type": "string",
      "description": "Bounty ID parameter for Gibwork Submit Work."
    },
    "submissionUrl": {
      "type": "string",
      "description": "URL to the completed work (PR, doc, etc.)"
    },
    "notes": {
      "type": "string",
      "description": "Notes parameter for Gibwork Submit Work."
    }
  },
  "required": [
    "wallet",
    "bountyId",
    "submissionUrl"
  ],
  "additionalProperties": false
}

send-arcade_listGames

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.

Parameters1

status

string

optional

Status parameter for Send-arcade List Games.

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "active",
        "upcoming",
        "ended"
      ],
      "description": "Status parameter for Send-arcade List Games."
    }
  },
  "additionalProperties": false
}

send-arcade_playGame

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.

Parameters3

wallet	string	required	Solana public key (base58)
gameId	string	required	Game ID parameter for Send-arcade Play Game.
betAmount	string	optional	Raw token amount (smallest unit)

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Solana public key (base58)"
    },
    "gameId": {
      "type": "string",
      "description": "Game ID parameter for Send-arcade Play Game."
    },
    "betAmount": {
      "type": "string",
      "description": "Raw token amount (smallest unit)"
    }
  },
  "required": [
    "wallet",
    "gameId"
  ],
  "additionalProperties": false
}

blinks_getAction

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.

Parameters1

actionUrl

string

required

Solana Action URL (https endpoint implementing the Actions spec)

Raw schema

{
  "type": "object",
  "properties": {
    "actionUrl": {
      "type": "string",
      "description": "Solana Action URL (https endpoint implementing the Actions spec)"
    }
  },
  "required": [
    "actionUrl"
  ],
  "additionalProperties": false
}

blinks_executeAction

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 transaction tools.

Parameters3

actionUrl	string	required	Action endpoint URL (from getAction links)
wallet	string	required	User wallet to sign the transaction
params	object	optional	Key-value parameters to fill Action template variables

Raw schema

{
  "type": "object",
  "properties": {
    "actionUrl": {
      "type": "string",
      "description": "Action endpoint URL (from getAction links)"
    },
    "wallet": {
      "type": "string",
      "description": "User wallet to sign the transaction"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Key-value parameters to fill Action template variables"
    }
  },
  "required": [
    "actionUrl",
    "wallet"
  ],
  "additionalProperties": false
}

blinks_confirmAction

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.

Parameters2

actionUrl	string	required	Action URL parameter for Blinks Confirm Action.
signature	string	required	Transaction signature after signing and submitting

Raw schema

{
  "type": "object",
  "properties": {
    "actionUrl": {
      "type": "string",
      "description": "Action URL parameter for Blinks Confirm Action."
    },
    "signature": {
      "type": "string",
      "description": "Transaction signature after signing and submitting"
    }
  },
  "required": [
    "actionUrl",
    "signature"
  ],
  "additionalProperties": false
}

blinks_resolveBlinkUrl

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.

Parameters1

blinkUrl

string

required

Blink URL (e.g. https://dial.to/?action=solana-action:...)

Raw schema

{
  "type": "object",
  "properties": {
    "blinkUrl": {
      "type": "string",
      "description": "Blink URL (e.g. https://dial.to/?action=solana-action:...)"
    }
  },
  "required": [
    "blinkUrl"
  ],
  "additionalProperties": false
}

blinks_validateActionsJson

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.

Parameters1

domain

string

required

Domain to check for actions.json (e.g. "jupiter.exchange")

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to check for actions.json (e.g. \"jupiter.exchange\")"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

blinks_buildActionUrl

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.

Parameters3

baseUrl	string	required	Action API endpoint
params	object	optional	Template parameters to encode
blinkProvider	string	optional	Optionally wrap in a Blink provider URL

Raw schema

{
  "type": "object",
  "properties": {
    "baseUrl": {
      "type": "string",
      "description": "Action API endpoint"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Template parameters to encode"
    },
    "blinkProvider": {
      "type": "string",
      "enum": [
        "dial.to",
        "phantom",
        "backpack",
        "none"
      ],
      "description": "Optionally wrap in a Blink provider URL"
    }
  },
  "required": [
    "baseUrl"
  ],
  "additionalProperties": false
}

jupiter_getOrder

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.

Parameters7

inputMint	string	required	Token mint address (base58)
outputMint	string	required	Token mint address (base58)
amount	string	required	Raw token amount as string (no decimals)
taker	string	required	Taker (sender) wallet address
slippageBps	number	optional	Slippage tolerance in bps (e.g. 50 = 0.5%)
referralAccount	string	optional	Solana wallet public key (base58)
referralFeeBps	number	optional	Referral fee in bps

Raw schema

{
  "type": "object",
  "properties": {
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "outputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount as string (no decimals)"
    },
    "taker": {
      "type": "string",
      "description": "Taker (sender) wallet address"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage tolerance in bps (e.g. 50 = 0.5%)"
    },
    "referralAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "referralFeeBps": {
      "type": "number",
      "description": "Referral fee in bps"
    }
  },
  "required": [
    "inputMint",
    "outputMint",
    "amount",
    "taker"
  ],
  "additionalProperties": false
}

jupiter_executeOrder

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.

Parameters2

signedTransaction	string	required	Base64-encoded signed transaction
requestId	string	required	requestId from getOrder response

Raw schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "requestId": {
      "type": "string",
      "description": "requestId from getOrder response"
    }
  },
  "required": [
    "signedTransaction",
    "requestId"
  ],
  "additionalProperties": false
}

jupiter_getHoldings

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.

Parameters1

tokenAccountAddresses

array

required

Array of token account addresses to query balances for

Raw schema

{
  "type": "object",
  "properties": {
    "tokenAccountAddresses": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Solana wallet public key (base58)"
      },
      "description": "Array of token account addresses to query balances for"
    }
  },
  "required": [
    "tokenAccountAddresses"
  ],
  "additionalProperties": false
}

jupiter_shield

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.

Parameters1

mints

array

required

Token mints to check

Raw schema

{
  "type": "object",
  "properties": {
    "mints": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Token mint address (base58)"
      },
      "description": "Token mints to check"
    }
  },
  "required": [
    "mints"
  ],
  "additionalProperties": false
}

jupiter_searchTokens

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.

Parameters1

query

string

required

Search by token symbol, name, or mint address

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search by token symbol, name, or mint address"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

jupiter_getQuote

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.

Parameters11

inputMint	string	required	Token mint address (base58)
outputMint	string	required	Token mint address (base58)
amount	string	required	Raw token amount as string (no decimals)
slippageBps	number	optional	Slippage tolerance in bps (e.g. 50 = 0.5%)
swapMode	string	optional	Swap Mode parameter for Jupiter Get Quote.
onlyDirectRoutes	boolean	optional	Restrict to single-hop routes
asLegacyTransaction	boolean	optional	Return a legacy transaction
maxAccounts	number	optional	Max accounts in transaction (default 64)
platformFeeBps	number	optional	Platform fee in bps
restrictIntermediateTokens	boolean	optional	Restrict Intermediate Tokens mint, symbol, or token identifier used by Jupiter Get Quote.
dynamicSlippage	boolean	optional	Dynamic Slippage pagination control for Jupiter Get Quote.

Raw schema

{
  "type": "object",
  "properties": {
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "outputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount as string (no decimals)"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage tolerance in bps (e.g. 50 = 0.5%)"
    },
    "swapMode": {
      "type": "string",
      "enum": [
        "ExactIn",
        "ExactOut"
      ],
      "description": "Swap Mode parameter for Jupiter Get Quote."
    },
    "onlyDirectRoutes": {
      "type": "boolean",
      "description": "Restrict to single-hop routes"
    },
    "asLegacyTransaction": {
      "type": "boolean",
      "description": "Return a legacy transaction"
    },
    "maxAccounts": {
      "type": "number",
      "description": "Max accounts in transaction (default 64)"
    },
    "platformFeeBps": {
      "type": "number",
      "description": "Platform fee in bps"
    },
    "restrictIntermediateTokens": {
      "type": "boolean",
      "description": "Restrict Intermediate Tokens mint, symbol, or token identifier used by Jupiter Get Quote."
    },
    "dynamicSlippage": {
      "type": "boolean",
      "description": "Dynamic Slippage pagination control for Jupiter Get Quote."
    }
  },
  "required": [
    "inputMint",
    "outputMint",
    "amount"
  ],
  "additionalProperties": false
}

jupiter_swap

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.

Parameters12

userPublicKey	string	required	Solana wallet public key (base58)
wrapAndUnwrapSol	boolean	optional	Auto wrap/unwrap SOL (default true)
useSharedAccounts	boolean	optional	Use Shared Accounts parameter for Jupiter Swap.
feeAccount	string	optional	Solana wallet public key (base58)
computeUnitPriceMicroLamports	number	optional	Priority fee in µ-lamports/CU
asLegacyTransaction	boolean	optional	As Legacy Transaction transaction payload used by Jupiter Swap.
useTokenLedger	boolean	optional	Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap.
destinationTokenAccount	string	optional	Solana wallet public key (base58)
dynamicComputeUnitLimit	boolean	optional	Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap.
skipUserAccountsRpcCalls	boolean	optional	Skip User Accounts RPC Calls endpoint or RPC selector used by Jupiter Swap.
dynamicSlippage	boolean	optional	Dynamic Slippage pagination control for Jupiter Swap.
quoteResponse	object	required	The full quoteResponse object from getQuote

Raw schema

{
  "type": "object",
  "properties": {
    "userPublicKey": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "wrapAndUnwrapSol": {
      "type": "boolean",
      "description": "Auto wrap/unwrap SOL (default true)"
    },
    "useSharedAccounts": {
      "type": "boolean",
      "description": "Use Shared Accounts parameter for Jupiter Swap."
    },
    "feeAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "computeUnitPriceMicroLamports": {
      "type": "number",
      "description": "Priority fee in µ-lamports/CU"
    },
    "asLegacyTransaction": {
      "type": "boolean",
      "description": "As Legacy Transaction transaction payload used by Jupiter Swap."
    },
    "useTokenLedger": {
      "type": "boolean",
      "description": "Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap."
    },
    "destinationTokenAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "dynamicComputeUnitLimit": {
      "type": "boolean",
      "description": "Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap."
    },
    "skipUserAccountsRpcCalls": {
      "type": "boolean",
      "description": "Skip User Accounts RPC Calls endpoint or RPC selector used by Jupiter Swap."
    },
    "dynamicSlippage": {
      "type": "boolean",
      "description": "Dynamic Slippage pagination control for Jupiter Swap."
    },
    "quoteResponse": {
      "type": "object",
      "additionalProperties": {},
      "description": "The full quoteResponse object from getQuote"
    }
  },
  "required": [
    "userPublicKey",
    "quoteResponse"
  ],
  "additionalProperties": false
}

jupiter_swapInstructions

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.

Parameters10

userPublicKey	string	required	Solana wallet public key (base58)
wrapAndUnwrapSol	boolean	optional	Wrap And Unwrap Sol parameter for Jupiter Swap Instructions.
useSharedAccounts	boolean	optional	Use Shared Accounts parameter for Jupiter Swap Instructions.
feeAccount	string	optional	Solana wallet public key (base58)
computeUnitPriceMicroLamports	number	optional	Compute Unit Price Micro Lamports value to use for Jupiter Swap Instructions.
asLegacyTransaction	boolean	optional	As Legacy Transaction transaction payload used by Jupiter Swap Instructions.
useTokenLedger	boolean	optional	Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap Instructions.
destinationTokenAccount	string	optional	Solana wallet public key (base58)
dynamicComputeUnitLimit	boolean	optional	Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap Instructions.
quoteResponse	object	required	The full quoteResponse object from getQuote

Raw schema

{
  "type": "object",
  "properties": {
    "userPublicKey": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "wrapAndUnwrapSol": {
      "type": "boolean",
      "description": "Wrap And Unwrap Sol parameter for Jupiter Swap Instructions."
    },
    "useSharedAccounts": {
      "type": "boolean",
      "description": "Use Shared Accounts parameter for Jupiter Swap Instructions."
    },
    "feeAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "computeUnitPriceMicroLamports": {
      "type": "number",
      "description": "Compute Unit Price Micro Lamports value to use for Jupiter Swap Instructions."
    },
    "asLegacyTransaction": {
      "type": "boolean",
      "description": "As Legacy Transaction transaction payload used by Jupiter Swap Instructions."
    },
    "useTokenLedger": {
      "type": "boolean",
      "description": "Use Token Ledger mint, symbol, or token identifier used by Jupiter Swap Instructions."
    },
    "destinationTokenAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "dynamicComputeUnitLimit": {
      "type": "boolean",
      "description": "Dynamic Compute Unit Limit controlling the maximum number of results returned by Jupiter Swap Instructions."
    },
    "quoteResponse": {
      "type": "object",
      "additionalProperties": {},
      "description": "The full quoteResponse object from getQuote"
    }
  },
  "required": [
    "userPublicKey",
    "quoteResponse"
  ],
  "additionalProperties": false
}

jupiter_programLabels

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

jupiter_getPrice

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.

Parameters3

ids	array	required	Token mints to price
vsToken	string	optional	Token mint address (base58)
showExtraInfo	boolean	optional	Include confidence, depth, timestamps

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Token mint address (base58)"
      },
      "description": "Token mints to price"
    },
    "vsToken": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "showExtraInfo": {
      "type": "boolean",
      "description": "Include confidence, depth, timestamps"
    }
  },
  "required": [
    "ids"
  ],
  "additionalProperties": false
}

jupiter_getTokenList

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.

Parameters1

query

string

optional

Tag to filter by — "verified" or "lst"

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "enum": [
        "verified",
        "lst"
      ],
      "description": "Tag to filter by — \"verified\" or \"lst\""
    }
  },
  "additionalProperties": false
}

jupiter_getTokenInfo

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.

Parameters1

query

string

required

Search by mint address, symbol, or name. Comma-separate for multiple (max 100)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search by mint address, symbol, or name. Comma-separate for multiple (max 100)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

jupiter_createLimitOrder

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.

Parameters9

maker	string	required	Wallet address of the order creator
payer	string	required	Wallet paying for transaction fees
inputMint	string	required	Input token mint
outputMint	string	required	Output token mint
makingAmount	string	required	Amount of input token to sell
takingAmount	string	required	Amount of output token to receive
expiredAt	string	optional	ISO 8601 expiry timestamp
feeBps	number	optional	Referral fee in bps
computeUnitPrice	string	optional	Priority fee (µ-lamports/CU)

Raw schema

{
  "type": "object",
  "properties": {
    "maker": {
      "type": "string",
      "description": "Wallet address of the order creator"
    },
    "payer": {
      "type": "string",
      "description": "Wallet paying for transaction fees"
    },
    "inputMint": {
      "type": "string",
      "description": "Input token mint"
    },
    "outputMint": {
      "type": "string",
      "description": "Output token mint"
    },
    "makingAmount": {
      "type": "string",
      "description": "Amount of input token to sell"
    },
    "takingAmount": {
      "type": "string",
      "description": "Amount of output token to receive"
    },
    "expiredAt": {
      "type": "string",
      "description": "ISO 8601 expiry timestamp"
    },
    "feeBps": {
      "type": "number",
      "description": "Referral fee in bps"
    },
    "computeUnitPrice": {
      "type": "string",
      "description": "Priority fee (µ-lamports/CU)"
    }
  },
  "required": [
    "maker",
    "payer",
    "inputMint",
    "outputMint",
    "makingAmount",
    "takingAmount"
  ],
  "additionalProperties": false
}

jupiter_executeTrigger

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.

Parameters2

signedTransaction	string	required	Base64-encoded signed transaction
requestId	string	required	Request ID from createLimitOrder response

Raw schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "requestId": {
      "type": "string",
      "description": "Request ID from createLimitOrder response"
    }
  },
  "required": [
    "signedTransaction",
    "requestId"
  ],
  "additionalProperties": false
}

jupiter_cancelLimitOrder

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.

Parameters3

maker	string	required	Solana wallet public key (base58)
order	string	required	Order public key to cancel
computeUnitPrice	string	optional	Compute Unit Price parameter for Jupiter Cancel Limit Order.

Raw schema

{
  "type": "object",
  "properties": {
    "maker": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "order": {
      "type": "string",
      "description": "Order public key to cancel"
    },
    "computeUnitPrice": {
      "type": "string",
      "description": "Compute Unit Price parameter for Jupiter Cancel Limit Order."
    }
  },
  "required": [
    "maker",
    "order"
  ],
  "additionalProperties": false
}

jupiter_cancelLimitOrders

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.

Parameters3

maker	string	required	Solana wallet public key (base58)
orders	array	required	Array of order public keys to cancel
computeUnitPrice	string	optional	Compute Unit Price parameter for Jupiter Cancel Limit Orders.

Raw schema

{
  "type": "object",
  "properties": {
    "maker": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "orders": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Orders parameter for Jupiter Cancel Limit Orders."
      },
      "description": "Array of order public keys to cancel"
    },
    "computeUnitPrice": {
      "type": "string",
      "description": "Compute Unit Price parameter for Jupiter Cancel Limit Orders."
    }
  },
  "required": [
    "maker",
    "orders"
  ],
  "additionalProperties": false
}

jupiter_getLimitOrders

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.

Parameters6

wallet	string	required	Wallet address to query
orderStatus	string	required	Filter by order status: "active" for open orders, "history" for filled/cancelled
inputMint	string	optional	Token mint address (base58)
outputMint	string	optional	Token mint address (base58)
page	number	optional	Page pagination control for Jupiter Get Limit Orders.
limit	number	optional	Limit controlling the maximum number of results returned by Jupiter Get Limit Orders.

Raw schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address to query"
    },
    "orderStatus": {
      "type": "string",
      "enum": [
        "active",
        "history"
      ],
      "description": "Filter by order status: \"active\" for open orders, \"history\" for filled/cancelled"
    },
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "outputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Jupiter Get Limit Orders."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Jupiter Get Limit Orders."
    }
  },
  "required": [
    "wallet",
    "orderStatus"
  ],
  "additionalProperties": false
}

jupiter_createDCA

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.

Parameters10

payer	string	required	Wallet paying for the DCA setup
user	string	required	Wallet executing the DCA
inputMint	string	required	Token mint address (base58)
outputMint	string	required	Token mint address (base58)
totalInAmount	string	required	Total amount of input token to DCA
frequency	string	required	DCA interval
numberOfOrders	number	required	Total number of orders to split into
minOutAmountPerOrder	string	optional	Raw token amount as string (no decimals)
maxOutAmountPerOrder	string	optional	Raw token amount as string (no decimals)
startAt	string	optional	ISO 8601 start timestamp (default: now)

Raw schema

{
  "type": "object",
  "properties": {
    "payer": {
      "type": "string",
      "description": "Wallet paying for the DCA setup"
    },
    "user": {
      "type": "string",
      "description": "Wallet executing the DCA"
    },
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "outputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "totalInAmount": {
      "type": "string",
      "description": "Total amount of input token to DCA"
    },
    "frequency": {
      "type": "string",
      "enum": [
        "hourly",
        "daily",
        "weekly",
        "monthly",
        "yearly"
      ],
      "description": "DCA interval"
    },
    "numberOfOrders": {
      "type": "number",
      "description": "Total number of orders to split into"
    },
    "minOutAmountPerOrder": {
      "type": "string",
      "description": "Raw token amount as string (no decimals)"
    },
    "maxOutAmountPerOrder": {
      "type": "string",
      "description": "Raw token amount as string (no decimals)"
    },
    "startAt": {
      "type": "string",
      "description": "ISO 8601 start timestamp (default: now)"
    }
  },
  "required": [
    "payer",
    "user",
    "inputMint",
    "outputMint",
    "totalInAmount",
    "frequency",
    "numberOfOrders"
  ],
  "additionalProperties": false
}

jupiter_executeDCA

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.

Parameters2

signedTransaction	string	required	Base64-encoded signed transaction
requestId	string	required	Request ID from createDCA response

Raw schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Base64-encoded signed transaction"
    },
    "requestId": {
      "type": "string",
      "description": "Request ID from createDCA response"
    }
  },
  "required": [
    "signedTransaction",
    "requestId"
  ],
  "additionalProperties": false
}

jupiter_cancelDCA

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.

Parameters4

user	string	required	Wallet that owns the DCA order
order	string	required	DCA order public key to cancel
recurringType	string	required	Recurring order type — "time" for time-based DCA, "price" for price-triggered
computeUnitPrice	string	optional	Compute Unit Price parameter for Jupiter Cancel D C A.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Wallet that owns the DCA order"
    },
    "order": {
      "type": "string",
      "description": "DCA order public key to cancel"
    },
    "recurringType": {
      "type": "string",
      "enum": [
        "time",
        "price"
      ],
      "description": "Recurring order type — \"time\" for time-based DCA, \"price\" for price-triggered"
    },
    "computeUnitPrice": {
      "type": "string",
      "description": "Compute Unit Price parameter for Jupiter Cancel D C A."
    }
  },
  "required": [
    "user",
    "order",
    "recurringType"
  ],
  "additionalProperties": false
}

jupiter_getDCAOrders

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.

Parameters8

user	string	required	Wallet address to query (sent as "user" query param to Jupiter)
recurringType	string	required	Recurring order type — "time" for time-based DCA, "price" for price-triggered, "all" for both
orderStatus	string	required	Filter by order status: "active" for running orders, "history" for completed/cancelled
includeFailedTx	boolean	optional	Include failed transactions in results (default: false)
inputMint	string	optional	Token mint address (base58)
outputMint	string	optional	Token mint address (base58)
page	number	optional	Page pagination control for Jupiter Get D C A Orders.
limit	number	optional	Limit controlling the maximum number of results returned by Jupiter Get D C A Orders.

Raw schema

{
  "type": "object",
  "properties": {
    "user": {
      "type": "string",
      "description": "Wallet address to query (sent as \"user\" query param to Jupiter)"
    },
    "recurringType": {
      "type": "string",
      "enum": [
        "time",
        "price",
        "all"
      ],
      "description": "Recurring order type — \"time\" for time-based DCA, \"price\" for price-triggered, \"all\" for both"
    },
    "orderStatus": {
      "type": "string",
      "enum": [
        "active",
        "history"
      ],
      "description": "Filter by order status: \"active\" for running orders, \"history\" for completed/cancelled"
    },
    "includeFailedTx": {
      "type": "boolean",
      "description": "Include failed transactions in results (default: false)"
    },
    "inputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "outputMint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "page": {
      "type": "number",
      "description": "Page pagination control for Jupiter Get D C A Orders."
    },
    "limit": {
      "type": "number",
      "description": "Limit controlling the maximum number of results returned by Jupiter Get D C A Orders."
    }
  },
  "required": [
    "user",
    "recurringType",
    "orderStatus"
  ],
  "additionalProperties": false
}

jupiter_smartSwap

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: 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.

Parameters17

inputMint	string	required	Source token mint address
outputMint	string	required	Destination token mint address
amount	string	required	Raw token amount to swap (in smallest unit, no decimals)
userPublicKey	string	required	Wallet public key that will sign the transaction
slippageBps	number	optional	Slippage tolerance in bps (e.g. 50 = 0.5%)
swapMode	string	optional	Swap mode (default: ExactIn)
onlyDirectRoutes	boolean	optional	Restrict to single-hop routes for lower latency
dynamicSlippage	boolean	optional	Enable dynamic slippage for better execution
asLegacyTransaction	boolean	optional	Return a legacy transaction instead of v0
wrapAndUnwrapSol	boolean	optional	Auto wrap/unwrap SOL (default: true)
destinationTokenAccount	string	optional	Solana wallet public key (base58)
computeUnitPriceMicroLamports	number	optional	Priority fee in micro-lamports per compute unit
dynamicComputeUnitLimit	boolean	optional	Use dynamic compute unit limit based on simulation
maxAccounts	number	optional	Max accounts in transaction (default: 64)
platformFeeBps	number	optional	Platform fee in bps for referral revenue
feeAccount	string	optional	Solana wallet public key (base58)
restrictIntermediateTokens	boolean	optional	Restrict intermediate tokens to reduce risk

Raw schema

{
  "type": "object",
  "properties": {
    "inputMint": {
      "type": "string",
      "description": "Source token mint address"
    },
    "outputMint": {
      "type": "string",
      "description": "Destination token mint address"
    },
    "amount": {
      "type": "string",
      "description": "Raw token amount to swap (in smallest unit, no decimals)"
    },
    "userPublicKey": {
      "type": "string",
      "description": "Wallet public key that will sign the transaction"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage tolerance in bps (e.g. 50 = 0.5%)"
    },
    "swapMode": {
      "type": "string",
      "enum": [
        "ExactIn",
        "ExactOut"
      ],
      "description": "Swap mode (default: ExactIn)"
    },
    "onlyDirectRoutes": {
      "type": "boolean",
      "description": "Restrict to single-hop routes for lower latency"
    },
    "dynamicSlippage": {
      "type": "boolean",
      "description": "Enable dynamic slippage for better execution"
    },
    "asLegacyTransaction": {
      "type": "boolean",
      "description": "Return a legacy transaction instead of v0"
    },
    "wrapAndUnwrapSol": {
      "type": "boolean",
      "description": "Auto wrap/unwrap SOL (default: true)"
    },
    "destinationTokenAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "computeUnitPriceMicroLamports": {
      "type": "number",
      "description": "Priority fee in micro-lamports per compute unit"
    },
    "dynamicComputeUnitLimit": {
      "type": "boolean",
      "description": "Use dynamic compute unit limit based on simulation"
    },
    "maxAccounts": {
      "type": "number",
      "description": "Max accounts in transaction (default: 64)"
    },
    "platformFeeBps": {
      "type": "number",
      "description": "Platform fee in bps for referral revenue"
    },
    "feeAccount": {
      "type": "string",
      "description": "Solana wallet public key (base58)"
    },
    "restrictIntermediateTokens": {
      "type": "boolean",
      "description": "Restrict intermediate tokens to reduce risk"
    }
  },
  "required": [
    "inputMint",
    "outputMint",
    "amount",
    "userPublicKey"
  ],
  "additionalProperties": false
}

sap_decode_transaction

Decode a serialized Solana transaction and return stable transaction metadata.

Parameters2

transaction	string	optional	Serialized transaction
encoding	string	optional	Input encoding

Raw schema

{
  "type": "object",
  "properties": {
    "transaction": {
      "type": "string",
      "description": "Serialized transaction"
    },
    "encoding": {
      "type": "string",
      "enum": [
        "base64",
        "base58"
      ],
      "description": "Input encoding"
    }
  }
}

sap_preview_transaction

Preview a Solana transaction before signing or submission.

Parameters2

transaction	string	optional	Serialized transaction
encoding	string	optional	Input encoding

Raw schema

{
  "type": "object",
  "properties": {
    "transaction": {
      "type": "string",
      "description": "Serialized transaction"
    },
    "encoding": {
      "type": "string",
      "enum": [
        "base64",
        "base58"
      ],
      "description": "Input encoding"
    }
  }
}

sap_sign_transaction

Sign a serialized Solana transaction with the configured SAP MCP signer.

Parameters2

transaction	string	optional	Unsigned or partially signed transaction
encoding	string	optional	Input encoding

Raw schema

{
  "type": "object",
  "properties": {
    "transaction": {
      "type": "string",
      "description": "Unsigned or partially signed transaction"
    },
    "encoding": {
      "type": "string",
      "enum": [
        "base64",
        "base58"
      ],
      "description": "Input encoding"
    }
  }
}

sap_submit_signed_transaction

Submit a signed Solana transaction through the configured RPC endpoint.

Parameters4

signedTransaction	string	optional	Signed serialized transaction
encoding	string	optional	Input encoding
skipPreflight	boolean	optional	Skip RPC preflight checks
maxRetries	number	optional	Maximum RPC send retries

Raw schema

{
  "type": "object",
  "properties": {
    "signedTransaction": {
      "type": "string",
      "description": "Signed serialized transaction"
    },
    "encoding": {
      "type": "string",
      "enum": [
        "base64",
        "base58"
      ],
      "description": "Input encoding"
    },
    "skipPreflight": {
      "type": "boolean",
      "description": "Skip RPC preflight checks"
    },
    "maxRetries": {
      "type": "number",
      "description": "Maximum RPC send retries"
    }
  }
}

sap_chat_derive_room

Derive a deterministic SAP chat room/session ID. Group and public room IDs are active; DM derivation is reserved for future native support.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Derive Room."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_chat_start_room

Start an on-chain SAP chat room by creating the backing vault, session, and ledger if needed.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Start Room."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_chat_send_message

Send a chunked SAP chat message to a room. Public messages store UTF-8 text; private messages store caller-provided ciphertext bytes.

Parameters13

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Required thematic group topic when deriving or writing to topic-scoped groups.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.
content	string	optional	Plain UTF-8 message content for public messages.
payloadBase64	string	optional	Base64 payload. Required for private/ciphertext messages.
visibility	string	optional	Message visibility. Defaults to public.
contentType	string	optional	MIME content type. Defaults to text/plain for public messages.
replyTo	string	optional	Optional parent message ID.
policy	object	optional	Optional compact group policy reference or policy hash. Full policy bodies should live off-chain and be linked by hash.
links	array	optional	Optional signed link references. Each link must include url and may include kind, label, sha256.
metadata	object	optional	Optional JSON metadata. Keep small; large metadata should be stored off-chain and hashed.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Required thematic group topic when deriving or writing to topic-scoped groups."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Send Message."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    },
    "content": {
      "type": "string",
      "description": "Plain UTF-8 message content for public messages."
    },
    "payloadBase64": {
      "type": "string",
      "description": "Base64 payload. Required for private/ciphertext messages."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "Message visibility. Defaults to public."
    },
    "contentType": {
      "type": "string",
      "description": "MIME content type. Defaults to text/plain for public messages."
    },
    "replyTo": {
      "type": "string",
      "description": "Optional parent message ID."
    },
    "policy": {
      "type": "object",
      "description": "Optional compact group policy reference or policy hash. Full policy bodies should live off-chain and be linked by hash."
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "Links parameter for SAP Chat Send Message."
      },
      "description": "Optional signed link references. Each link must include url and may include kind, label, sha256."
    },
    "metadata": {
      "type": "object",
      "description": "Optional JSON metadata. Keep small; large metadata should be stored off-chain and hashed."
    }
  }
}

sap_chat_publish_manifest

Publish a signed thematic room/group manifest for discovery indexers, policy-aware agents, and chat clients.

Parameters10

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.
description	string	optional	Short public room/group description.
tags	array	optional	Small topic tags used by discovery, for example openbook, markets, sol-usdc.
policy	object	optional	Compact group policy or content-addressed policy reference.
links	array	optional	Optional signed room links for docs, market references, IPFS manifests, or execution receipts.
metadata	object	optional	Optional compact manifest metadata.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Publish Manifest."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    },
    "description": {
      "type": "string",
      "description": "Short public room/group description."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Tags parameter for SAP Chat Publish Manifest."
      },
      "description": "Small topic tags used by discovery, for example openbook, markets, sol-usdc."
    },
    "policy": {
      "type": "object",
      "description": "Compact group policy or content-addressed policy reference."
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "Links parameter for SAP Chat Publish Manifest."
      },
      "description": "Optional signed room links for docs, market references, IPFS manifests, or execution receipts."
    },
    "metadata": {
      "type": "object",
      "description": "Optional compact manifest metadata."
    }
  }
}

sap_chat_read_latest

Read latest SAP chat messages from the room ring buffer.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Read Latest."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_chat_read_all

Read all SAP chat messages from sealed ledger pages plus the latest ring buffer.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Read All."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_chat_status

Get backing SAP memory session status for a chat room.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Status."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_chat_seal_room

Seal the current chat ring buffer into an immutable SAP ledger page for permanent history.

Parameters5

roomKind	string	optional	Chat room kind: dm, group, or room.
roomId	string	optional	Optional explicit room ID. If omitted, one is derived deterministically.
roomName	string	optional	Human-readable room name for public thematic rooms.
topic	string	optional	Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery.
participants	array	optional	Participant agent/wallet identifiers for DM or group rooms.

Raw schema

{
  "type": "object",
  "properties": {
    "roomKind": {
      "type": "string",
      "enum": [
        "dm",
        "group",
        "room"
      ],
      "description": "Chat room kind: dm, group, or room."
    },
    "roomId": {
      "type": "string",
      "description": "Optional explicit room ID. If omitted, one is derived deterministically."
    },
    "roomName": {
      "type": "string",
      "description": "Human-readable room name for public thematic rooms."
    },
    "topic": {
      "type": "string",
      "description": "Thematic topic, for example openbook:sol-usdc:market-makers or sap:registry:discovery."
    },
    "participants": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Participants parameter for SAP Chat Seal Room."
      },
      "description": "Participant agent/wallet identifiers for DM or group rooms."
    }
  }
}

sap_profile_current

Return the currently loaded SAP MCP profile and redacted signer/config metadata.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_profile_list

List available SAP MCP profiles with redacted signer metadata and no wallet paths.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

sap_profile_public_key

Return the configured public agent key for a profile without reading or exposing keypair bytes.

Parameters1

profileName

string

optional

Profile name. Defaults to the loaded profile.

Raw schema

{
  "type": "object",
  "properties": {
    "profileName": {
      "type": "string",
      "description": "Profile name. Defaults to the loaded profile."
    }
  }
}

sap_profile_switch

Switch the live SAP MCP runtime to another existing profile and reload client, signer, connection, and policy.

Parameters2

profileName	string	optional	Existing profile name to load.
confirm	boolean	optional	Must be true because switching profile can change signer, network, and policy.

Raw schema

{
  "type": "object",
  "properties": {
    "profileName": {
      "type": "string",
      "description": "Existing profile name to load."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true because switching profile can change signer, network, and policy."
    }
  }
}

sap_skills_list

List bundled SAP MCP skills and their files.

Parameters1

skills

array

optional

Skills parameter for List SAP MCP Skills.

Raw schema

{
  "type": "object",
  "properties": {
    "skills": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Skills parameter for List SAP MCP Skills."
      },
      "description": "Skills parameter for List SAP MCP Skills."
    }
  }
}

sap_skills_bundle

Return bundled SAP MCP skills as JSON so an agent can load or write them itself.

Parameters2

skills	array	optional	Skills parameter for Bundle SAP MCP Skills.
includeContents	boolean	optional	Include Contents parameter for Bundle SAP MCP Skills.

Raw schema

{
  "type": "object",
  "properties": {
    "skills": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Skills parameter for Bundle SAP MCP Skills."
      },
      "description": "Skills parameter for Bundle SAP MCP Skills."
    },
    "includeContents": {
      "type": "boolean",
      "description": "Include Contents parameter for Bundle SAP MCP Skills."
    }
  }
}

sap_skills_install

Install bundled SAP MCP skills into a local agent skill directory. Requires confirm: true.

Parameters4

agent	string	optional	Agent parameter for Install SAP MCP Skills.
targetDir	string	optional	Target Dir parameter for Install SAP MCP Skills.
skills	array	optional	Skills parameter for Install SAP MCP Skills.
confirm	boolean	optional	Confirm confirmation flag required before Install SAP MCP Skills performs a local write.

Raw schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "enum": [
        "claude",
        "codex",
        "hermes",
        "openclaw",
        "custom"
      ],
      "description": "Agent parameter for Install SAP MCP Skills."
    },
    "targetDir": {
      "type": "string",
      "description": "Target Dir parameter for Install SAP MCP Skills."
    },
    "skills": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Skills parameter for Install SAP MCP Skills."
      },
      "description": "Skills parameter for Install SAP MCP Skills."
    },
    "confirm": {
      "type": "boolean",
      "description": "Confirm confirmation flag required before Install SAP MCP Skills performs a local write."
    }
  }
}

magicblock_getRoutes

List available Ephemeral Rollup nodes from the Magic Router (identity, FQDN, fee, block time, country). Price: $0.01.

Parameters1

endpoint

string

optional

MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  }
}

magicblock_getIdentity

Get the identity and FQDN of the current ER Validator node. Price: $0.01.

Parameters1

endpoint

string

optional

MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  }
}

magicblock_getDelegationStatus

Check whether a Solana account is delegated to an Ephemeral Rollup. Returns authority, owner, delegation slot, and lamports. Price: $0.01.

Parameters2

account	string	required	Account pubkey to check delegation status for
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "Account pubkey to check delegation status for"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "account"
  ]
}

magicblock_getAccountInfo

Fetch account information (data, lamports, owner, executable, space) via the Magic Router. Price: $0.01.

Parameters3

account	string	required	Account pubkey to fetch info for
encoding	string	optional	Encoding for account data
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "Account pubkey to fetch info for"
    },
    "encoding": {
      "type": "string",
      "enum": [
        "base64",
        "base64+zstd"
      ],
      "description": "Encoding for account data"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "account"
  ]
}

magicblock_getBlockhashForAccounts

Get a blockhash and last valid block height for a batch of account addresses (max 100). Price: $0.01.

Parameters2

accounts	array	required	Array of account addresses (max 100)
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "accounts": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Account pubkey"
      },
      "description": "Array of account addresses (max 100)"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "accounts"
  ]
}

magicblock_getSignatureStatuses

Check the confirmation status (processed/confirmed/finalized) of one or more transaction signatures. Price: $0.01.

Parameters2

signatures	array	required	Array of transaction signatures
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "signatures": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Transaction signature (base58)"
      },
      "description": "Array of transaction signatures"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "signatures"
  ]
}

magicblock_health

Check the health status of the MagicBlock Private Payments API. Price: $0.01.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

magicblock_challenge

Generate a challenge string for the wallet to sign (step 1 of the PER auth flow). Price: $0.01.

Parameters3

pubkey	string	required	Wallet pubkey that will sign the challenge
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
mock	boolean	optional	Use a mock challenge for testing (default false)

Raw schema

{
  "type": "object",
  "properties": {
    "pubkey": {
      "type": "string",
      "description": "Wallet pubkey that will sign the challenge"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "mock": {
      "type": "boolean",
      "description": "Use a mock challenge for testing (default false)"
    }
  },
  "required": [
    "pubkey"
  ]
}

magicblock_login

Exchange a signed challenge for a bearer token (step 2 of PER auth flow). The token is used for private-balance and private transfers. Price: $0.01.

Parameters5

pubkey	string	required	Wallet pubkey that signed the challenge
challenge	string	required	Challenge string from magicblock_challenge
signature	string	required	Wallet signature over the challenge string
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
mock	boolean	optional	Use mock login flow (default false)

Raw schema

{
  "type": "object",
  "properties": {
    "pubkey": {
      "type": "string",
      "description": "Wallet pubkey that signed the challenge"
    },
    "challenge": {
      "type": "string",
      "description": "Challenge string from magicblock_challenge"
    },
    "signature": {
      "type": "string",
      "description": "Wallet signature over the challenge string"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "mock": {
      "type": "boolean",
      "description": "Use mock login flow (default false)"
    }
  },
  "required": [
    "pubkey",
    "challenge",
    "signature"
  ]
}

magicblock_balance

Read the base-chain SPL token balance for an address (public, no auth required). Price: $0.01.

Parameters3

address	string	required	Owner wallet pubkey
mint	string	required	SPL mint pubkey
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Owner wallet pubkey"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint pubkey"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    }
  },
  "required": [
    "address",
    "mint"
  ]
}

magicblock_privateBalance

Read the ephemeral-rollup SPL token balance for an address (requires bearer token from login). Price: $0.01.

Parameters4

address	string	required	Owner wallet pubkey
mint	string	required	SPL mint pubkey
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
authToken	string	required	Bearer token from magicblock_login (required for private reads)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Owner wallet pubkey"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint pubkey"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "authToken": {
      "type": "string",
      "description": "Bearer token from magicblock_login (required for private reads)"
    }
  },
  "required": [
    "address",
    "mint",
    "authToken"
  ]
}

magicblock_deposit

Build an unsigned transaction to deposit SPL tokens from Solana into an Ephemeral Rollup. Sign with sap_sign_transaction and submit to the RPC indicated by sendTo. Price: $0.05.

Parameters9

owner	string	required	Wallet pubkey that owns the tokens and will sign
amount	number	required	Base-unit amount to deposit (integer, minimum 1)
mint	string	optional	SPL mint. Defaults to USDC (mainnet) or devnet USDC
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
validator	string	optional	Optional ER validator pubkey. Defaults to the selected ephemeral RPC identity.
initIfMissing	boolean	optional	Initialize the transfer queue if missing (default true)
initVaultIfMissing	boolean	optional	Initialize the vault if missing (default true)
initAtasIfMissing	boolean	optional	Initialize associated token accounts if missing (default true)
idempotent	boolean	optional	Use idempotent variants for preparatory init instructions (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Wallet pubkey that owns the tokens and will sign"
    },
    "amount": {
      "type": "number",
      "description": "Base-unit amount to deposit (integer, minimum 1)"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint. Defaults to USDC (mainnet) or devnet USDC"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "validator": {
      "type": "string",
      "description": "Optional ER validator pubkey. Defaults to the selected ephemeral RPC identity."
    },
    "initIfMissing": {
      "type": "boolean",
      "description": "Initialize the transfer queue if missing (default true)"
    },
    "initVaultIfMissing": {
      "type": "boolean",
      "description": "Initialize the vault if missing (default true)"
    },
    "initAtasIfMissing": {
      "type": "boolean",
      "description": "Initialize associated token accounts if missing (default true)"
    },
    "idempotent": {
      "type": "boolean",
      "description": "Use idempotent variants for preparatory init instructions (default true)"
    }
  },
  "required": [
    "owner",
    "amount"
  ]
}

magicblock_transfer

Build an unsigned SPL token transfer (public or private) through an Ephemeral Rollup. Supports base/ephemeral source and destination, delayed settlement, split transfers, and gasless mode. Price: $0.05.

Parameters20

from	string	required	Sender wallet pubkey
to	string	required	Recipient wallet pubkey
mint	string	required	SPL mint pubkey
amount	number	required	Base-unit amount to transfer (integer, minimum 1)
visibility	string	required	'public' = transparent SPL transfer, 'private' = routed through Private ER with delayed+split settlement
fromBalance	string	required	Where the sender's balance is held
toBalance	string	required	Where the recipient should receive funds
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
validator	string	optional	Optional ER validator pubkey
authToken	string	optional	Bearer token from login (required for private transfers)
initIfMissing	boolean	optional	Initialize transfer queue if missing (default true)
initAtasIfMissing	boolean	optional	Initialize recipient ATA if missing (default true)
initVaultIfMissing	boolean	optional	Initialize vault if missing (default false)
memo	string	optional	Optional memo appended to the transaction
minDelayMs	string	optional	Private only. Earliest (ms) the queued transfer may settle. Default '0'
maxDelayMs	string	optional	Private only. Latest (ms) the queued transfer may settle (<= 600000)
clientRefId	string	optional	Private only. Encrypted client reference ID for payment confirmation
split	number	optional	Private only. Number of queue entries to split across (1-15, default 1)
gasless	boolean	optional	When true, uses configured sponsor as fee payer (default false)
legacy	boolean	optional	Skip lookup-table compilation, return a legacy transaction (default false)

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Sender wallet pubkey"
    },
    "to": {
      "type": "string",
      "description": "Recipient wallet pubkey"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint pubkey"
    },
    "amount": {
      "type": "number",
      "description": "Base-unit amount to transfer (integer, minimum 1)"
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "'public' = transparent SPL transfer, 'private' = routed through Private ER with delayed+split settlement"
    },
    "fromBalance": {
      "type": "string",
      "enum": [
        "base",
        "ephemeral"
      ],
      "description": "Where the sender's balance is held"
    },
    "toBalance": {
      "type": "string",
      "enum": [
        "base",
        "ephemeral"
      ],
      "description": "Where the recipient should receive funds"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "validator": {
      "type": "string",
      "description": "Optional ER validator pubkey"
    },
    "authToken": {
      "type": "string",
      "description": "Bearer token from login (required for private transfers)"
    },
    "initIfMissing": {
      "type": "boolean",
      "description": "Initialize transfer queue if missing (default true)"
    },
    "initAtasIfMissing": {
      "type": "boolean",
      "description": "Initialize recipient ATA if missing (default true)"
    },
    "initVaultIfMissing": {
      "type": "boolean",
      "description": "Initialize vault if missing (default false)"
    },
    "memo": {
      "type": "string",
      "description": "Optional memo appended to the transaction"
    },
    "minDelayMs": {
      "type": "string",
      "description": "Private only. Earliest (ms) the queued transfer may settle. Default '0'"
    },
    "maxDelayMs": {
      "type": "string",
      "description": "Private only. Latest (ms) the queued transfer may settle (<= 600000)"
    },
    "clientRefId": {
      "type": "string",
      "description": "Private only. Encrypted client reference ID for payment confirmation"
    },
    "split": {
      "type": "number",
      "description": "Private only. Number of queue entries to split across (1-15, default 1)"
    },
    "gasless": {
      "type": "boolean",
      "description": "When true, uses configured sponsor as fee payer (default false)"
    },
    "legacy": {
      "type": "boolean",
      "description": "Skip lookup-table compilation, return a legacy transaction (default false)"
    }
  },
  "required": [
    "from",
    "to",
    "mint",
    "amount",
    "visibility",
    "fromBalance",
    "toBalance"
  ]
}

magicblock_withdraw

Build an unsigned transaction to withdraw SPL tokens from an Ephemeral Rollup back to Solana. Price: $0.05.

Parameters9

owner	string	required	Wallet pubkey that owns the tokens and will sign
mint	string	required	SPL mint on Solana
amount	number	required	Base-unit amount to withdraw (integer, minimum 1)
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
validator	string	optional	Optional ER validator pubkey
initIfMissing	boolean	optional	Initialize transfer queue if missing (default true)
initAtasIfMissing	boolean	optional	Initialize ATAs if missing (default true)
escrowIndex	number	optional	Optional escrow index for the withdrawal
idempotent	boolean	optional	Use idempotent variants for preparatory init instructions (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Wallet pubkey that owns the tokens and will sign"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint on Solana"
    },
    "amount": {
      "type": "number",
      "description": "Base-unit amount to withdraw (integer, minimum 1)"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "validator": {
      "type": "string",
      "description": "Optional ER validator pubkey"
    },
    "initIfMissing": {
      "type": "boolean",
      "description": "Initialize transfer queue if missing (default true)"
    },
    "initAtasIfMissing": {
      "type": "boolean",
      "description": "Initialize ATAs if missing (default true)"
    },
    "escrowIndex": {
      "type": "number",
      "description": "Optional escrow index for the withdrawal"
    },
    "idempotent": {
      "type": "boolean",
      "description": "Use idempotent variants for preparatory init instructions (default true)"
    }
  },
  "required": [
    "owner",
    "mint",
    "amount"
  ]
}

magicblock_swapQuote

Get a swap quote between two SPL mints (proxies Triton Metis swap API). Pass the result into magicblock_swap. Price: $0.01.

Parameters9

inputMint	string	required	Input token mint address
outputMint	string	required	Output token mint address
amount	string	required	Raw amount to swap (unsigned integer string, e.g. '1000000')
slippageBps	number	optional	Slippage threshold in basis points (e.g. 50 = 0.5%)
swapMode	string	optional	Swap mode: fixed input or fixed output amount
onlyDirectRoutes	boolean	optional	Limit routing to a single hop (default false)
restrictIntermediateTokens	boolean	optional	Restrict intermediate tokens to a more stable set (default false)
platformFeeBps	number	optional	Optional platform fee in basis points
maxAccounts	number	optional	Approximate maximum account budget for the route (default 64)

Raw schema

{
  "type": "object",
  "properties": {
    "inputMint": {
      "type": "string",
      "description": "Input token mint address"
    },
    "outputMint": {
      "type": "string",
      "description": "Output token mint address"
    },
    "amount": {
      "type": "string",
      "description": "Raw amount to swap (unsigned integer string, e.g. '1000000')"
    },
    "slippageBps": {
      "type": "number",
      "description": "Slippage threshold in basis points (e.g. 50 = 0.5%)"
    },
    "swapMode": {
      "type": "string",
      "enum": [
        "ExactIn",
        "ExactOut"
      ],
      "description": "Swap mode: fixed input or fixed output amount"
    },
    "onlyDirectRoutes": {
      "type": "boolean",
      "description": "Limit routing to a single hop (default false)"
    },
    "restrictIntermediateTokens": {
      "type": "boolean",
      "description": "Restrict intermediate tokens to a more stable set (default false)"
    },
    "platformFeeBps": {
      "type": "number",
      "description": "Optional platform fee in basis points"
    },
    "maxAccounts": {
      "type": "number",
      "description": "Approximate maximum account budget for the route (default 64)"
    }
  },
  "required": [
    "inputMint",
    "outputMint",
    "amount"
  ]
}

magicblock_swap

Build an unsigned swap transaction from a quote. 'public' mode passes through Jupiter, 'private' mode routes output through a scheduled private transfer with delay and split. Price: $0.05.

Parameters11

userPublicKey	string	required	Wallet that will sign the swap transaction
quoteResponse	object	required	Quote response object from magicblock_swapQuote (pass as-is)
visibility	string	optional	'public' = transparent Jupiter pass-through, 'private' = output routed through scheduled private transfer
destination	string	optional	Final private-transfer recipient (required when visibility='private')
minDelayMs	string	optional	Private only. Earliest (ms) the queued transfer may settle
maxDelayMs	string	optional	Private only. Latest (ms) the queued transfer may settle (<= 600000)
split	number	optional	Private only. Number of queue entries to split across (1-14)
clientRefId	string	optional	Private only. Optional u64 client correlation ID
validator	string	optional	Optional validator pubkey for the transfer-queue PDA
wrapAndUnwrapSol	boolean	optional	Auto wrap/unwrap native SOL when needed (default true)
asLegacyTransaction	boolean	optional	Build a legacy transaction (not allowed when visibility=private, default false)

Raw schema

{
  "type": "object",
  "properties": {
    "userPublicKey": {
      "type": "string",
      "description": "Wallet that will sign the swap transaction"
    },
    "quoteResponse": {
      "type": "object",
      "properties": {},
      "description": "Quote response object from magicblock_swapQuote (pass as-is)"
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "private"
      ],
      "description": "'public' = transparent Jupiter pass-through, 'private' = output routed through scheduled private transfer"
    },
    "destination": {
      "type": "string",
      "description": "Final private-transfer recipient (required when visibility='private')"
    },
    "minDelayMs": {
      "type": "string",
      "description": "Private only. Earliest (ms) the queued transfer may settle"
    },
    "maxDelayMs": {
      "type": "string",
      "description": "Private only. Latest (ms) the queued transfer may settle (<= 600000)"
    },
    "split": {
      "type": "number",
      "description": "Private only. Number of queue entries to split across (1-14)"
    },
    "clientRefId": {
      "type": "string",
      "description": "Private only. Optional u64 client correlation ID"
    },
    "validator": {
      "type": "string",
      "description": "Optional validator pubkey for the transfer-queue PDA"
    },
    "wrapAndUnwrapSol": {
      "type": "boolean",
      "description": "Auto wrap/unwrap native SOL when needed (default true)"
    },
    "asLegacyTransaction": {
      "type": "boolean",
      "description": "Build a legacy transaction (not allowed when visibility=private, default false)"
    }
  },
  "required": [
    "userPublicKey",
    "quoteResponse"
  ]
}

magicblock_initializeMint

Build an unsigned transaction that initializes a validator-scoped transfer queue for a mint. Price: $0.05.

Parameters4

owner	string	required	Wallet pubkey that will sign the transaction
mint	string	required	SPL mint to initialize a transfer queue for
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
validator	string	optional	Optional ER validator pubkey

Raw schema

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Wallet pubkey that will sign the transaction"
    },
    "mint": {
      "type": "string",
      "description": "SPL mint to initialize a transfer queue for"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "validator": {
      "type": "string",
      "description": "Optional ER validator pubkey"
    }
  },
  "required": [
    "owner",
    "mint"
  ]
}

magicblock_isMintInitialized

Check whether a mint has a validator-scoped transfer queue on the ephemeral RPC. Price: $0.01.

Parameters3

mint	string	required	SPL mint to check
cluster	string	optional	Cluster: 'mainnet', 'devnet', or custom RPC URL
validator	string	optional	Optional ER validator pubkey

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "SPL mint to check"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster: 'mainnet', 'devnet', or custom RPC URL"
    },
    "validator": {
      "type": "string",
      "description": "Optional ER validator pubkey"
    }
  },
  "required": [
    "mint"
  ]
}

magicblock_requestRandomness

Request provably fair on-chain randomness from the MagicBlock VRF oracle (Vrf1RNUjXmQGjmQrQLvJHs9SNkvDJEsRVFPkfSQUwGz). Builds an unsigned transaction that invokes request_randomness on the VRF program. The caller must sign with sap_sign_transaction and submit to Solana. The oracle queue defaults to the base-layer queue (Cuj97ggrhhidhbu39TijNVqE74xvKJ69gDervRUXAxGh); set ephemeral=true to use the ER queue for delegated programs. Price: $0.05.

Parameters7

payer	string	required	Wallet pubkey that will pay for the request and sign the transaction
callbackProgramId	string	required	Program ID of the callback program (the program that will consume the randomness)
callbackDiscriminator	string	required	Base58 or hex discriminator for the callback instruction in your program
callerSeed	string	required	Seed string for the VRF request — committed before randomness is produced. The seed is hashed to 32 bytes.
callbackAccounts	array	required	Accounts to pass to the callback instruction
ephemeral	boolean	optional	Use the Ephemeral Rollup oracle queue instead of the base-layer queue (default false)
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "payer": {
      "type": "string",
      "description": "Wallet pubkey that will pay for the request and sign the transaction"
    },
    "callbackProgramId": {
      "type": "string",
      "description": "Program ID of the callback program (the program that will consume the randomness)"
    },
    "callbackDiscriminator": {
      "type": "string",
      "description": "Base58 or hex discriminator for the callback instruction in your program"
    },
    "callerSeed": {
      "type": "string",
      "description": "Seed string for the VRF request — committed before randomness is produced. The seed is hashed to 32 bytes."
    },
    "callbackAccounts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pubkey": {
            "type": "string",
            "description": "Account pubkey"
          },
          "isSigner": {
            "type": "boolean",
            "description": "Whether the account is a signer"
          },
          "isWritable": {
            "type": "boolean",
            "description": "Whether the account is writable"
          }
        },
        "description": "Callback account metadata"
      },
      "description": "Accounts to pass to the callback instruction"
    },
    "ephemeral": {
      "type": "boolean",
      "description": "Use the Ephemeral Rollup oracle queue instead of the base-layer queue (default false)"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "payer",
    "callbackProgramId",
    "callbackDiscriminator",
    "callerSeed",
    "callbackAccounts"
  ]
}

magicblock_getRandomnessResult

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. Price: $0.01.

Parameters2

requestKey	string	required	VRF request PDA key from magicblock_requestRandomness
endpoint	string	optional	MagicBlock Router endpoint: 'mainnet' or 'devnet'

Raw schema

{
  "type": "object",
  "properties": {
    "requestKey": {
      "type": "string",
      "description": "VRF request PDA key from magicblock_requestRandomness"
    },
    "endpoint": {
      "type": "string",
      "enum": [
        "mainnet",
        "devnet"
      ],
      "description": "MagicBlock Router endpoint: 'mainnet' or 'devnet'"
    }
  },
  "required": [
    "requestKey"
  ]
}

README.md16 KBView on GitHub

SAP MCP Server

Production-oriented Model Context Protocol server for OOBE Synapse Agent Protocol, Solana, Synapse AgentKit, SNS, and monetized hosted agent workflows.

SAP MCP exposes the same typed tool registry through two supported MCP launch modes:

Local stdio for desktop agents and local development.
Remote Streamable HTTP at /mcp for hosted customers and orchestrators.

It also includes a professional setup wizard, profile-managed config under ~/.config/mcp-sap, optional Bento policy integration, local and external signing modes, x402 monetization, a self-hosted OOBE facilitator, pay.sh provider YAML generation, and an A2A-compatible discovery card.

User-facing setup docs live in USER_DOCS/. Operator and engineering docs live in docs/.

1. Status

Area	Current behavior
Package version	`0.9.85`
MCP transport	stdio locally, Streamable HTTP remotely
Remote access	Bearerless public mode for hosted agents; API key or JWT for private modes
Config directory	`~/.config/mcp-sap` only
Agent wallet	Dedicated wallet path under `~/.config/mcp-sap/keypairs/` by default
Solana CLI keypair	Never modified by the wizard
Policy	Local policy by default, optional Bento or hybrid policy
Monetization	Optional remote-only x402/pay.sh payment flow with per-tool pricing
Signing	Local dedicated wallet or external signer, depending on profile mode
Discovery	A2A-compatible card at `/.well-known/agent-card.json`

2. Install

Prerequisites:

bash

node --version   # >= 22.12.0
corepack enable
corepack prepare pnpm@11.7.0 --activate
pnpm --version   # 11.7.0

From source:

bash

pnpm install
pnpm run build

Do not use npm install for source deployments. This repository is locked and verified with pnpm.

From the published package:

bash

npm install -g @oobe-protocol-labs/sap-mcp-server

3. Quick Start

Create or select a profile:

bash

npx sap-mcp-config wizard

Repair hosted SAP MCP runtime entries without recreating the profile:

bash

npx sap-mcp-config repair

After connecting hosted SAP MCP in an agent runtime, start the agent context with one short message:

text

Start SAP MCP.

The agent should call the free sap_agent_start tool or sap-agent-start prompt, load sap_skills_bundle, and use the local sap_payments bridge for paid/write hosted calls.

Inspect the active profile:

bash

npx sap-mcp-config show
npx sap-mcp-config doctor
npx sap-mcp-config pubkey
npx sap-mcp-config profiles

Start local stdio MCP:

bash

sap-mcp-server

or from source:

bash

node dist/cli.js

Hosted customers connect their agents to https://mcp.sap.oobeprotocol.ai/mcp, but signing remains user-controlled. The recommended setup for most users is the wizard-managed pair of MCP entries:

sap: hosted Streamable HTTP SAP MCP at https://mcp.sap.oobeprotocol.ai/mcp;
sap_payments: local non-custodial payment bridge for x402/pay.sh paid/write calls.

Any user who wants to pay x402/pay.sh charges, register or operate a SAP identity, or execute value-moving Solana/SAP tools should run the wizard first and keep the dedicated wallet under ~/.config/mcp-sap/keypairs/ or behind an external signer. Read-only hosted discovery can use the remote URL without a local signer.

4. Local Client Config

For local agents, let SAP MCP follow the active profile manager instead of hard-coding wallet paths or stale RPC overrides:

json

{
  "mcpServers": {
    "sap": {
      "command": "sap-mcp-server",
      "env": {
        "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
        "SAP_LOG_LEVEL": "info"
      }
    }
  }
}

Codex uses TOML rather than the JSON mcpServers shape. For hosted remote MCP, add this to ~/.codex/config.toml and restart Codex:

toml

[mcp_servers.sap]
url = "https://mcp.sap.oobeprotocol.ai/mcp"

For paid/write hosted tools, add the local non-custodial payment bridge as well:

toml

[mcp_servers.sap_payments]
command = "npx"
args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.85", "sap-mcp-server"]
startup_timeout_sec = 300
tool_timeout_sec = 300

[mcp_servers.sap_payments.env]
SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"
SAP_MCP_PAYMENTS_BRIDGE_ONLY = "true"
SAP_ALLOWED_TOOLS = "all"
SAP_LOG_LEVEL = "info"

On Windows, use command = "npx.cmd". The wizard can write this automatically.

Codex supports Streamable HTTP MCP servers with URL-based entries in config.toml. Use local stdio through npx only when you specifically want Codex to launch the local SAP MCP process:

toml

[mcp_servers.sap]
command = "npx"
args = ["--yes", "--package", "@oobe-protocol-labs/sap-mcp-server@0.9.85", "sap-mcp-server"]

[mcp_servers.sap.env]
SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE = "false"
SAP_LOG_LEVEL = "info"

On Windows, use command = "npx.cmd".

See 04. Local Stdio MCP Runbook.

5. Remote Server

Remote deployments expose MCP over Streamable HTTP:

bash

node dist/remote/server.js

Production environment values should come from a private secret store or private deployment file, not from public docs. Public hosted agent-facing deployments can use SAP_MCP_AUTH_TYPE=none when x402, rate limits, and policy are enabled. API key or JWT auth remains available for private beta, enterprise, and admin deployments.

Remote endpoints:

text

GET     /
GET     /docs
GET     /server.json
GET     /favicon.png
GET     /favicon.ico
GET     /health
GET     /openapi.json
GET     /.well-known/x402
GET     /pay/provider.yml
GET     /.well-known/agent-card.json
GET     /.well-known/sap-mcp-wizard.json
GET     /.well-known/sap-mcp-tool-catalog.json
GET     /tool-catalog.json
GET     /wizard/install.sh
POST    /mcp
GET     /mcp
DELETE  /mcp

GET / is a public, share-safe landing page with Open Graph/Twitter metadata. It exposes only public server information; keypair bytes, private wallet paths, RPC query secrets, and VPS-local paths must never appear there.

GET /docs serves the public documentation site for install, start, configuration, hosted remote MCP, x402/pay.sh payments, and MCP client setup.

Marketplace listings such as Smithery can use smithery.config.schema.json to explain the hosted setup path. The schema intentionally asks for no secrets: SAP MCP hosted reads work remotely, while paid/write calls use the wizard-managed local sap_payments bridge, local profile policy, and user-controlled signer.

See 05. Hosted Streamable HTTP Deployment and 07. HTTP Endpoints, MCP Clients, And Smoke Tests.

6. Monetization

Hosted HTTP deployments can require payment for paid tools/call requests while leaving local stdio and base MCP protocol calls free.

Initial model:

Tier	Examples	Price
Free	`tools/list`, `prompts/list`, `resources/list`, bootstrap/status/repair, cost estimation, local payment bridge control, SOL/SPL/x402 balance readiness, single-asset price snapshots, memory/audit, transaction preview/finalize helpers	Free
Micro read	exact agent/profile reads, compact directory pages, SNS availability, escrow state, lightweight trader context	`$0.001`
Premium read	broad discovery, enriched holdings/DAS, token lists, quotes/routes, history/OHLCV, analytics, larger pages	`$0.002`
Builder or batch	complex builders, SNS/domain batch checks, unsigned transaction builders, routing preparation	`$0.006`, batch = sum of paid calls
Value action	selected value-linked operations	fixed `$0.06` standard, `$0.035` selected heavy paths, plus optional bps

Enable x402:

bash

SAP_MCP_MONETIZATION_ENABLED=true
SAP_MCP_MONETIZATION_PROVIDER=x402
SAP_MCP_MONETIZATION_PAY_TO=YOUR_SOLANA_USDC_RECIPIENT
SAP_MCP_X402_FACILITATOR_URL=YOUR_PRIVATE_OR_HOSTED_FACILITATOR_URL

Initialize and run the OOBE facilitator:

bash

npx sap-mcp-facilitator init
npx sap-mcp-facilitator start

Generate a pay.sh provider YAML:

The hosted public catalog is available at https://mcp.sap.oobeprotocol.ai/pay/provider.yml. It is secret-free and intended for pay.sh catalog/proxy discovery.

bash

npx sap-mcp-pay-sh-spec \
  --out sap-mcp-pay-sh.yml \
  --upstream-url https://mcp.sap.oobeprotocol.ai \
  --network mainnet \
  --recipient YOUR_SOLANA_USDC_RECIPIENT

See 06. x402/pay.sh Monetization Settlement.

For local agent runtimes that cannot replay x402 challenges natively, install the wizard's local sap_payments bridge and call sap_payments_call_paid_tool. The legacy CLI helper is still available for terminal use:

bash

npm exec --yes --package @oobe-protocol-labs/sap-mcp-server -- sap-mcp-x402-paid-call \
  --tool sap_list_all_agents \
  --arguments '{"limit":5}' \
  --max-usd 0.02 \
  --confirm

The helper signs payment payloads with the user's local SAP MCP profile and never sends keypair bytes to the hosted server.

7. Commands

bash

pnpm run typecheck
pnpm run lint
pnpm test -- --run
pnpm run build
pnpm run verify:release

Installed binaries:

Command	Purpose
`sap-mcp-server`	Local stdio MCP server and CLI entry point
`sap-mcp-remote`	Remote MCP server with bearerless, API key, and JWT modes
`sap-mcp-config`	Config CLI, profile manager, approval workflow, and wizard
`sap-mcp-wizard`	TUI configuration wizard
`sap-signing-proxy`	Local signing proxy
`sap-mcp-facilitator`	Self-hosted x402 SVM facilitator
`sap-mcp-pay-sh-spec`	pay.sh provider YAML generator
`sap-mcp-x402-paid-call`	Legacy terminal/custom-wrapper fallback for hosted x402 paid MCP tools

8. Documentation

Start with 00. Engineering Documentation Index.

Document	Purpose
01. Product Scope Deployment Model	Product model, users, public/private repo guidance, and wizard distribution.
02. Runtime Architecture Trust Boundaries	Runtime modules, local flow, remote flow, signing, payments, and trust boundaries.
03. Profile Config Wizard Injection	Profile manager, wizard, wallet isolation, client injection, and config CLI.
04. Local Stdio MCP Runbook	Local setup for Claude, Hermes, Codex, OpenClaw, and development agents.
05. Hosted Streamable HTTP Deployment	Hosted deployment, reverse proxy, PM2, and customer onboarding.
06. x402/pay.sh Monetization Settlement	Pricing, x402 gate, pay.sh provider YAML, facilitator signer, and settlement.
07. HTTP Endpoints, MCP Clients, And Smoke Tests	HTTP endpoints, headers, smoke tests, and client examples.
08. Security Policy Signing Runbook	Key material rules, signer modes, Bento policy, and transaction safety.
09. Tool Skill Routing Agent Operations	Tool families, SDK doc pointers, skills, and agent behavior.
10. Release Operations PM2 Runbook	Quality gates, PM2, secrets, release packaging, and changelog discipline.
11. Engineering Quality Audit Report	Current engineering scorecard, release gates, quality rules, and residual risks.
12. Signed Agent Chat Protocol	Signed thematic group chat, room manifests, retrieval, link sharing, privacy boundaries, and SDK roadmap.
13. Bounty Program Technical Spec	Partner bounty scope, judging criteria, and technical requirements.
14. Desktop Wizard Release Artifacts	Native wizard packaging, signing, checksums, and release artifacts.
15. Demo Dashboard Screenshare Runbook	Demo flow for hosted landing page, dashboard, wizard, and payment surfaces.
16. Agent Identity Registry Pipeline	Registry source truth, enrichment, validation, and display pipeline.
18. Premium Plugin Runtime Contracts	Premium plugin manifest contracts, provider readiness, streams, and webhooks.
19. Agentic Standards Interoperability	MCP, A2A, marketplace, x402/pay.sh, and runtime alignment.
20. Engineering Operating Model Boundaries	Branch ownership, service contracts, release personas, and company-grade gates.

9. Repository Layout

The repository is a modular monorepo. Real source code lives in packages/*/src/; the corresponding src/ directories are thin compatibility wrappers (export * from '../../packages/...') that preserve existing import paths.

text

packages/
  core/              Shared runtime types, errors, logger, constants, guards, result
  config-runtime/    Runtime config, secure config manager, setup wizard, runtime doctor, client injection
  server-runtime/    MCP server factory, capability registration, server metadata
  hosted-gateway/    Streamable HTTP MCP server, public home, premium routes, rate limiter, tx relay
  local-bridge/      Local stdio MCP bridge, payment bridge process diagnostics
  mcp-adapter/       Model Context Protocol adapter compatibility layer
  schemas/           Public Zod schemas and protocol contracts
  tools/             SAP, Solana, AgentKit, SNS, profile, skill, chat, payment, perps, and premium tools
  ui-cards/          MCP Apps Card rendering, card builder, templates, protocol logos
  wizard-core/       Shared CLI and desktop wizard flow
  tool-plugin-template/  Trusted external tool-family plugin template
  adapters/          Solana connection and public key adapter utilities
  bin/               npx-safe bootstrap entrypoints for remote and local servers
  memory/            Agent memory store, tool call store, stream buffer, Hermes bridge
  observability/     Metrics collection and exporter
  perps/             Perpetual futures analytics, Adrena builders, chart indicators, risk engine
  payments/          x402 monetization, facilitator, usage ledger, pay.sh spec, pricing
  policy/            Local, Bento, and hybrid policy engines, spending limits, permission checks
  premium/           Premium runtime plugins, streams, webhooks, session management
  prompts/           MCP prompt templates for developer, payments, context, execution-proof, registry
  resources/         MCP resource templates for memory, execution-proof, reputation, profile, registry, stats
  runtime/           Module resolution and payment bridge process management
  sap/               SAP SDK client manager, types, and error classes
  security/          Private-key guard, tool permissions, prompt injection notes, approval gates
  session/           Session store, delegated sessions, agent sessions, session limits
  signer/            Local, delegated, and external signer adapters, wallet guard, policy-enforcing wallet
  solana/            Solana ATA utilities
  strategies/        Strategy store and trade journal
  transports/        stdio and HTTP transport layers
  tui/               Terminal UI wizard save helper (legacy, source in src/tui/)

The root package.json re-exports all package surfaces so consumers can import from @oobe-protocol-labs/sap-mcp-server without referencing internal packages directly.

10. License

SAP MCP Server is released under the MIT License.

11. Partner Products

Partner / Product	Integration
@bentoguard / Bento Guard	Optional policy layer for AI-assisted intent scoring, escalation, and hybrid local/Bento guardrails. Uses the optional `@bentoguard/sdk` package and credentials from app.bentoguard.xyz.

Install

Tools (268)

sap_register_agentsap_update_agentsap_deactivate_agentsap_reactivate_agentsap_close_agentsap_report_callssap_update_reputation_metricssap_get_agent

Configuration

Environment variables

SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDEdefault false

Keep SAP MCP pointed at the active profile manager instead of stale client env overrides.

SAP_LOG_LEVELdefault info

Runtime log level for local SAP MCP stdio sessions.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "sap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@oobe-protocol-labs/sap-mcp-server@0.7.1"
      ],
      "env": {
        "SAP_MCP_ALLOW_ENV_CONFIG_OVERRIDE": "false",
        "SAP_LOG_LEVEL": "info"
      }
    }
  }
}