List All SAP Agents
sap_list_all_agentsRead-onlyIdempotent
List and search on-chain SAP agents with compact or full views, filter by wallet, protocol, capability, or x402 endpoint, and paginate results.
Instructions
Paid hosted global SAP agent directory read. Enumerates current on-chain AgentAccount PDAs and supports query, wallet, protocol, capability, x402 endpoint filtering, compact/full views, and cursor pagination. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Result shape. Use compact for broad discovery and full for detailed rows. Defaults to compact. | |
| limit | No | Maximum rows to return. Defaults to 100; hard-capped at 500. | |
| query | No | Optional text search across name, description, agentId, wallet, PDA, x402 endpoint, protocols, capabilities, and active plugins. Example: "XONA" or "creative". | |
| cursor | No | Opaque pagination cursor returned as pagination.nextCursor by a previous sap_list_all_agents or sap_discover_agents call. | |
| offset | No | Zero-based pagination offset. Defaults to 0. Prefer cursor after the first page when nextCursor is returned. | |
| wallet | No | Optional exact owner wallet public key filter. Use this when a wallet is known; it is the most reliable lookup path. | |
| hydrate | No | Deprecated compatibility alias. Use view="full" for full rows or view="compact" for directory rows. | |
| agentPda | No | Optional exact SAP agent PDA filter. | |
| protocol | No | Optional protocol filter matched case-insensitively against agent protocols and protocol-index membership. Example: "jupiter", "creative", "payments". | |
| capability | No | Optional single capability ID filter matched case-insensitively. Example: "creative:imageGeneration" or "jupiter:swap". | |
| capabilities | No | Optional list of capability IDs. Use capabilityMode="all" when the agent must have every capability. | |
| capabilityMode | No | How to match the capability/capabilities filters. Defaults to "any". | |
| hasX402Endpoint | No | Optional filter for agents that advertise a paid HTTP/x402 endpoint. | |
| includeInactive | No | Include inactive agents. Defaults to false. | |
| includeProtocolIndexes | No | Include compact protocol index summaries. Defaults to false for sap_discover_agents and true for sap_list_all_agents. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | MCP content blocks returned to the caller. | |
| isError | No | True when the tool result represents an application-level error. |