# x402broker Tool Search

> x402broker Tool Search is a paid API for AI agents from x402broker.com, paid per call via x402 or MPP, $0.01/call, status unknown (last checked 2026-10-20).

Searches and discovers MCP servers and A2A tools by natural language query across an index of 500+ tools

## Facts

- Endpoint: GET https://x402broker.com/v1/tool-search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402broker-tool-search-c11f4b24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xxUceqnxJGL9ySgEZV74T

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402broker-tool-search-c11f4b24
```

Example prompt: Search the x402broker tool index for MCP servers or A2A tools that can do live web search — show me the top matches with their descriptions and connection details.

## When to prefer this

Choose this endpoint when an AI agent needs to dynamically discover new tools or MCP servers at runtime rather than relying on a hardcoded list. Especially useful when building agent orchestrators or swarm routers that need to find the right specialized tool for a subtask on the fly, or when exploring what A2A/MCP capabilities exist across a broad index.

## Known failure modes

- Missing or empty query parameter returns no results or validation error
- Query too vague returns low-relevance or empty matches
- Service unavailable if index backend is down
- Payment not processed or x402 auth fails resulting in 402 response
- Rate limiting if too many requests in a short window

## How this service works

Single-connection meta-router indexing 500+ MCP servers & A2A tools with 85% token compression and Prompt-Guard firewall. (Live x402 v2, IETF MPP & MCP endpoint at https://x402broker.com/v1/tool-search)

## Output

Returns a ranked list of matching MCP servers and A2A tools from the 500+ tool index, including tool names, capability descriptions, endpoint URLs, and connection metadata relevant to the query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "query": {
   "type": "string",
   "minLength": 1,
   "description": "Capability search query (e.g. 'context compression', 'github security', 'sec filings', 'company enrichment') or endpoint URL to verify"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402broker-tool-search-c11f4b24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402broker.com](https://www.zero.xyz/host/x402broker.com/llms.txt)
