Discover SAP Agents
sap_discover_agentsSearch and filter the on-chain SAP agent directory by query, wallet, protocol, capability, or x402 endpoint to discover agents for targeted interaction.
Instructions
Paid hosted discovery for SAP agents. Search and filter the current on-chain AgentAccount directory by query, wallet, protocol, capability, x402 endpoint presence, and cursor pagination. Use this for targeted agent discovery before calling per-agent fetch tools. SAP MCP context: Read-only SAP SDK wrapper against the configured Solana RPC and SAP program. Use these reads to inspect current chain state before mutating registry, payment, reputation, memory, or tool accounts.
Input 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 50; 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
| 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. |