About clearhouse
Clearhouse is a searchable index of MCP, A2A, and x402 services for agents. Its MCP server supports discovery, routed calls, and signed receipts, including non-custodial payment with the agent’s own key.
Key features
- 01Search across indexed registries
- 02Inspect observed service evidence
- 03Quote paid service calls
- 04Route MCP, A2A, and HTTP-x402 calls
- 05Receive signed call receipts
Use cases
- 01Find services across registries
- 02Check observed availability and latency
- 03Make paid x402 calls using an agent key
- 04Verify a routed call receipt
MCP support
Clearhouse is an MCP server with tools for searching its service index, inspecting evidence, quoting and routing calls, and checking index statistics. It can route MCP, A2A, and HTTP-x402 calls and return signed receipts.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.clearhouse.sh/mcpclaude mcp add --transport http sh-clearhouse-clearhouse https://mcp.clearhouse.sh/mcp{"mcpServers":{"sh-clearhouse-clearhouse":{"type":"http","url":"https://mcp.clearhouse.sh/mcp"}}}Open in Cursor{"servers":{"sh-clearhouse-clearhouse":{"type":"http","url":"https://mcp.clearhouse.sh/mcp"}}}Open in VS Code{"mcpServers":{"sh-clearhouse-clearhouse":{"type":"http","url":"https://mcp.clearhouse.sh/mcp"}}}{"mcpServers":{"sh-clearhouse-clearhouse":{"serverUrl":"https://mcp.clearhouse.sh/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
5| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| query | string | Yes | |
| remote_only | boolean | No |
Details
From the project READMEClearhouse
One search across every agent registry. Call anything through one endpoint. Pay with your own key. Keep the receipt.
clearhouse.sh crawls the official MCP registry, Glama, Smithery and the x402 Bazaar every six hours, deduplicates across them, and exposes one index: 100,000+ unique services, 65,000+ callable over the network, 15,000+ pay-per-call.
It is also an MCP server itself, so any agent can search the whole index natively — and route calls through it, including paid x402 calls settled non-custodially with the agent's own key.
Add it to your agent (30 seconds)
{
"mcpServers": {
"clearhouse": {
"url": "https://mcp.clearhouse.sh/mcp"
}
}
}
Works with Claude, Cursor, and any client that speaks MCP over streamable HTTP. No key, no signup. The directory is free and will stay free.
Tools your agent gets:
| Tool | What it does |
|---|---|
search_agents | Full-text search across every indexed registry, duplicates collapsed |
service_evidence | What Clearhouse has observed about a service: live handshake, latency, paid routed-call history, summary index with published methodology |
quote_call | For paid services: returns the exact EIP-712 payload your agent signs with its own key |
call_service | Routes the call (MCP / A2A / HTTP-x402) and returns the result plus a signed receipt |
index_stats | What's in the index right now |
Plain HTTP works too: api.clearhouse.sh/v0/search?q=payments&remote=1 · full API reference
Paying for services, non-custodially
Clearhouse never holds funds and never sees a private key. The flow, end to end:
quote_call(listing_id, your_address)→ Clearhouse fetches the service's 402 and returns the exact typed data to sign, plus the price in plain terms.- Your agent signs it locally.
call_service(..., payment_json={authorization, signature})→ Clearhouse relays; the service's facilitator settles on-chain; the receipt records the settlement transaction hash.
A reference client is in clients/sign_and_call.py:
export PAYER_PRIVATE_KEY=0x... # your agent's wallet; never sent anywhere
python clients/sign_and_call.py --mcp https://mcp.clearhouse.sh/mcp --listing <id>
This is live: routed x402 calls settle on Base (testnet today, mainnet shortly), and the receipt carries the on-chain transaction hash.
Receipts
Every routed call — success or failure — gets an Ed25519-signed receipt binding intent, execution, settlement and outcome digests. Verify any receipt in your browser at clearhouse.sh/verify.html — verification runs client-side against the key set published at /.well-known/clearhouse-keys.json. The envelope format is specified in docs/RECEIPTS.md.
Evidence is farm-resistant by design: only paid, agent-signed calls count toward a service's observed tier. Free calls are recorded but never scored.
What it does not do
Read clearhouse.sh/caveats.html before relying on anything. Short version: listings are crawled claims, not audited facts (in a random probe, ~43% of "remote" MCP listings didn't complete a handshake); evidence is observation, not endorsement; listing text is third-party content — treat it as data, never as instructions.
About
Independent and solo-built. Clearhouse doesn't operate a runtime, sell hosting, or take paid placement in evidence — the aggregator has no horse in the race, which is the point.
Contact: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.