mcpField
C
clearhouse

clearhouse

Remote
github.com/clearhouse-shSearch0Updated 8w ago
Repository

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

  1. 01Search across indexed registries
  2. 02Inspect observed service evidence
  3. 03Quote paid service calls
  4. 04Route MCP, A2A, and HTTP-x402 calls
  5. 05Receive signed call receipts

Use cases

  1. 01Find services across registries
  2. 02Check observed availability and latency
  3. 03Make paid x402 calls using an agent key
  4. 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.

Endpointhttps://mcp.clearhouse.sh/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

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
ParameterTypeRequiredDescription
limitintegerNo
querystringYes
remote_onlybooleanNo

Details

From the project README

Clearhouse

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:

ToolWhat it does
search_agentsFull-text search across every indexed registry, duplicates collapsed
service_evidenceWhat Clearhouse has observed about a service: live handshake, latency, paid routed-call history, summary index with published methodology
quote_callFor paid services: returns the exact EIP-712 payload your agent signs with its own key
call_serviceRoutes the call (MCP / A2A / HTTP-x402) and returns the result plus a signed receipt
index_statsWhat'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:

  1. 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.
  2. Your agent signs it locally.
  3. 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

Markdown supported

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.