The 1ToolRing MCP (Model Context Protocol) server exposes the catalog loop as tools over streamable HTTP. An agent searches the catalog by job, reads the price, calls the entry, and gets back the answer plus the charge. It never needs to know a path or a parameter name in advance.
Endpoint: https://mcp.1toolring.com/mcp
Auth: Authorization: Bearer <key>, your own 1ToolRing key, sent as an HTTP header on the endpoint. The server accepts Bearer only.
Tools
| Tool | Arguments | Description |
|---|---|---|
search_catalog | query, category?, capability?, limit? | Search the active catalog by job. Returns entries with id, method, path, price_credits, price_unit, capability and freshness. Free. |
call_service | id, query?, body?, path_params? | Read the entry by id, build the real request, and send it with your key. query for GET parameters, body for a POST body (including a routed toolring.<capability> job), path_params for {placeholders} in the path. Returns the upstream answer, the status, which source served it, and the charge. |
search_catalog({ query: "verify email" })
→ [{ id: "email.verify", method: "POST", path: "/api/v1/email/verify", price_credits: 105, price_unit: "chargeable address", ... }]
call_service({ id: "email.verify", body: { email: "[email protected]" } })
→ { status: 200, charged: 105, data: { result: "ok", ... } }Client configuration
{
"mcpServers": {
"toolring": {
"url": "https://mcp.1toolring.com/mcp",
"headers": { "Authorization": "Bearer aip_live_..." }
}
}
}This works in Claude Desktop, Cursor, and any MCP client that supports streamable HTTP with custom headers. The key is forwarded to the API on every call and is never logged or returned.
Transport
POST,GET,DELETE /mcp: MCP streamable HTTP, stateless, JSON responses.GET /health: liveness probe.
Without MCP
The REST contract is agent-friendly on its own. GET https://api.1toolring.com/llms.txt is generated from the same registry the billing path uses and teaches the whole loop in plain text, so an agent that cannot speak MCP can still read the catalog and call it with curl.