About gateway
ToolHail is a hosted MCP gateway for AI agents that need capabilities on demand. It searches MCP registries, proxies calls to remote servers, and meters successful use through Stripe.
Key features
- 01Searches and ranks MCP servers
- 02Returns setup details for matches
- 03Proxies calls to remote MCP tools
- 04Meters successful calls through Stripe
Use cases
- 01Find a server for an unconfigured task
- 02Call a remote tool without installing it
- 03Track usage billed per successful call
MCP support
ToolHail exposes `find_mcp_server` and `call_tool` to MCP clients through a hosted endpoint. It discovers remote MCP servers and proxies tool calls to them.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.toolhail.com/mcpclaude mcp add --transport http toolhail-gateway https://mcp.toolhail.com/mcp{"mcpServers":{"toolhail-gateway":{"type":"http","url":"https://mcp.toolhail.com/mcp"}}}Open in Cursor{"servers":{"toolhail-gateway":{"type":"http","url":"https://mcp.toolhail.com/mcp"}}}Open in VS Code{"mcpServers":{"toolhail-gateway":{"type":"http","url":"https://mcp.toolhail.com/mcp"}}}{"mcpServers":{"toolhail-gateway":{"serverUrl":"https://mcp.toolhail.com/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
2| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Plain-language description of the capability you need, e.g. 'query a Postgres database'. |
| maxResults | integer | No | How many ranked matches to return (default 5). |
| requireRemote | boolean | No | Only return servers with a hosted remote endpoint (usable immediately). |
Details
From the project READMEToolHail
The discovery-and-payment layer for AI agents. ToolHail lets an AI agent find the right MCP (Model Context Protocol) server for any task and call it — paying per use — without installing anything.
There are 10,000+ MCP servers an agent could use, and no good way to discover and use one mid-task. ToolHail closes that gap with two tools:
- 🔎
find_mcp_server(free) — describe a capability in plain language ("query a Postgres database","send a Slack message","scrape a web page") and get ranked, deduplicated MCP servers from every major registry (mcp.so, PulseMCP, Smithery, Glama) with ready-to-paste setup. - ⚡
call_tool(paid) — invoke a discovered remote MCP server through ToolHail's SSRF-guarded proxy. No install, one hop; each successful call is metered and billed through Stripe.
Use it
Hosted MCP endpoint (Streamable HTTP):
https://mcp.toolhail.com/mcp
Add it to Claude Code (or any MCP client):
claude mcp add --transport http toolhail https://mcp.toolhail.com/mcp
MCP Scout on the Apify Store — the discovery engine as a standalone, pay-per-search actor: https://apify.com/01010101/mcp-scout
Site: https://toolhail.com · Guide: https://toolhail.com/guide
How it works
- Discover — the agent hits a capability gap and asks
find_mcp_server, which searches the registries and returns the best-fit servers, ranked for usability. - Execute — instead of installing, the agent calls the chosen tool via
call_tool; ToolHail proxies it in one hop, nothing to configure. - Settle — each successful call is metered and billed through Stripe. The agent pays for exactly what it used.
Why it exists
An agent's toolset is fixed at configuration time, but real tasks need capabilities the agent doesn't have. Today the options are "hard-code every server you might ever need" or "give up." ToolHail makes tools a runtime resource: discovered on demand, called through one endpoint, paid per use. It is discovery and payment infrastructure for the agentic web — built entirely on the open Model Context Protocol.
Repo layout
| Path | What |
|---|---|
apify-mcp-scout/ | MCP Scout — the discovery engine, published on the Apify Store (live) |
gateway-worker/ | Hosted MCP gateway on Cloudflare Workers — find_mcp_server + call_tool (live at mcp.toolhail.com) |
gateway/ | Reference gateway + Stripe metering + tests |
landing/ | toolhail.com site (landing + guide + llms.txt) |
registry/ | MCP registry listing metadata (server.json) + submission playbook |
dashboard/ | Private revenue/usage dashboard |
brand/ | Brand assets |
Built on
Model Context Protocol · Cloudflare Workers · Stripe · Apify
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.