Tool detail

agents

Lists or searches SAN Foundation agents, returning id, externalId, name, slug, domain and description for each.

Categories: Tool discovery

Use when

look up a SAN agent's ref or id by name or domain before calling agent-scoped endpoints
browse or search the list of registered SAN agents

Not for

not the agent-scoped data itself, only agent identity and reference fields

Inputs

GET query params (optional): limit (integer 1-500, default 100), search (substring match on name, domain, description).

Admitted input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Max number of agents to return (default 100, max 500)."
    },
    "search": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Case-insensitive substring filter on name, domain, and description."
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://gateway.sanfoundation.com/x402/v1/agents

Payment

Protocol: x402
Listed price: 0.01 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://gateway.sanfoundation.com/x402/v1/agents
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z