clearhouse — Claude Code MCP server: features and setup
clearhouse searches a combined directory of MCP, A2A, and x402 services, then routes calls to them. Use it when an agent needs to discover a service or receive a signed call receipt.
claude mcp add --transport http clearhouse https://mcp.clearhouse.sh/mcpWhat clearhouse does
The server merges listings from several registries, removes duplicates, and gives agents tools to search the directory, inspect observed service activity, and check index statistics. It can also route MCP, A2A, and HTTP-x402 calls, returning a signed receipt. For paid calls, the agent signs locally with its own key; Clearhouse neither holds funds nor receives the private key.
An Ed25519 receipt links the intent, execution, settlement, and outcome. Listings are claims gathered from registries, though, and observed activity is not an audit or endorsement. In a random probe, about 43% of remote MCP listings failed to complete a handshake, so check whether the service you need responds. x402 routing is on Base: testnet is live, with mainnet described as forthcoming.
What it helps with
- search service listings across multiple registries
- inspect observed activity for a service
- route an MCP, A2A, or HTTP-x402 call through one server
- get a signed receipt for a routed call
Example prompts for the agent
- Search the directory for MCP services that handle payments and compare the listings.
- Check the observed activity for service
<listing_id>before calling it. - Call service
<listing_id>and return the result with its receipt.
How to install clearhouse
Platform CLI: remote server
claude mcp add --transport http clearhouse https://mcp.clearhouse.sh/mcpPlatform CLI: remote server
codex mcp add clearhouse --url https://mcp.clearhouse.sh/mcpConfig file
{
"mcpServers": {
"clearhouse": {
"url": "https://mcp.clearhouse.sh/mcp"
}
}
}Config file
{
"servers": {
"clearhouse": {
"type": "http",
"url": "https://mcp.clearhouse.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http clearhouse https://mcp.clearhouse.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about clearhouse
How do I install clearhouse in Claude Code?
Run claude mcp add --transport http clearhouse https://mcp.clearhouse.sh/mcp. The server connects over HTTP.
What does clearhouse do?
It searches a combined service directory and routes calls to listed services. Routed calls come with a signed receipt.
How does x402 payment work?
The agent signs the payment locally with its own key, then Clearhouse relays the call. Clearhouse does not hold funds or receive the private key.
