1ToolRing

1ToolRing MCP server

One key and one prepaid balance for 3,051 pay-per-call tools from 99 providers: Google search results and keyword data, Google Maps places, Amazon and Google Shopping prices, market data, exchange rates, web pages and more.

Your agent finds a tool by describing the job, sees the price before it runs anything, and pays per call from your 1ToolRing balance. Failed calls are not charged. There is no subscription.

• Website: https://1toolring.com
• Docs: https://docs.1toolring.com/overview/
• Setup guide for agents: https://1toolring.com/llms.txt
• Status: open. Sign-up is open to everyone, and a new account gets a small starter balance once its email is verified.

This repository holds the public connection details and client configs. The server itself is hosted; there is nothing to run locally.

Endpoint

URL	https://mcp.1toolring.com/mcp
Transport	Streamable HTTP
Auth	OAuth 2.1 (dynamic client registration, PKCE). An API key sent as Authorization: Bearer <key> also works.
Registry name	com.1toolring/mcp (official MCP Registry)

Tools

Tool	What it does	Cost
discover_tools	Search the catalog by describing the job in plain words. Returns tool ids, a short description and the price.	Free
inspect_tool	Read one tool's input schema, price model and health before running it.	Free
run_tool	Run a tool, paid from your prepaid balance. The price is held up front and settled to the real cost; failed runs are not charged.	Per call
get_tool_run	Fetch the status and output of a slow run started by run_tool.	Free

What the catalog covers today: 3,051 tools from 99 providers, across Google search and SEO data, maps and places, shopping prices, market data, exchange rates, web pages, and more. The full list with prices is at https://1toolring.com/tools/

Set up

The quickest way: paste this line into your agent's chat (Claude Code, Codex, Cursor, ChatGPT, claude.ai).

set up 1ToolRing - https://1toolring.com/llms.txt

Or add it by hand:

Claude Code (plugin, includes the skill)

/plugin install 1toolring --marketplace khmuhtadin/1toolring-mcp

Claude Code (MCP server only)

claude mcp add --transport http 1toolring https://mcp.1toolring.com/mcp

Then run /mcp, choose Authenticate and select Allow in your browser.

Codex

codex mcp add 1toolring --url https://mcp.1toolring.com/mcp
codex mcp login 1toolring

Cursor

Add to Cursor, or add this to ~/.cursor/mcp.json:

{ "mcpServers": { "1toolring": { "url": "https://mcp.1toolring.com/mcp" } } }

VS Code / GitHub Copilot

code --add-mcp '{"name":"1toolring","type":"http","url":"https://mcp.1toolring.com/mcp"}'

Kiro

Or add it to .kiro/settings/mcp.json and sign in when Kiro asks:

{ "mcpServers": { "1toolring": { "url": "https://mcp.1toolring.com/mcp" } } }

Cline

cline mcp install 1toolring --transport http https://mcp.1toolring.com/mcp

Cline opens a 1ToolRing sign-in page to approve access. The entry is also in the Cline marketplace (cline/marketplace#433).

Gemini CLI

gemini extensions install https://github.com/khmuhtadin/1toolring-mcp

Or gemini mcp add --transport http 1toolring https://mcp.1toolring.com/mcp, then /mcp auth 1toolring.

claude.ai and ChatGPT

Add a custom connector with the URL https://mcp.1toolring.com/mcp (no client ID needed), then choose Allow.

Hermes Agent

hermes plugins install https://github.com/khmuhtadin/1toolring-mcp
hermes plugins enable 1toolring

Then add your key (from https://app.1toolring.com/keys) as ONETOOLRING_API_KEY in your Hermes profile .env, or paste it in the plugin's settings form in Hermes Desktop. Portable packages stay disabled until you enable them. Start a new session (or run /reload-mcp) and the 1toolring MCP tools are available, along with the 1toolring:1toolring skill.

Disclosure for the Hermes package:

• Every tool call, with its arguments, goes to 1ToolRing's hosted server (mcp.1toolring.com). The tool list is served by that server at runtime.
• run_tool spends money from the prepaid balance of the account that owns the key, at the price shown by inspect_tool. Failed runs are not charged. The other three tools are free and read-only.
• The server is marked untrusted in the package, so Hermes asks before every run_tool call; the free read-only tools run without a prompt.
• The key is read from ONETOOLRING_API_KEY and sent as an Authorization: Bearer header. The package has no local code, runs no shell commands and stores nothing.

Every agent on this machine at once

npx add-mcp https://mcp.1toolring.com/mcp -g

Agent on a server or VPS

Sign-in opens in a browser on your own computer. When your agent runs on another machine, that browser cannot reach the agent, so the Allow click leaves it waiting for a callback it will never get. After you choose Allow, the 1ToolRing page shows a link and a ready curl command. Paste the link to your agent, or run the command on the server. The link works once and expires soon.

You can also skip the sign-in flow and use an API key: create one at https://app.1toolring.com/keys, then follow the API key steps at https://1toolring.com/install/ (they include a one-line installer for servers).

How your agent handles cost and questions

• It runs small jobs without asking (a run of $0.05 or less, while the whole request stays under about $0.25) and tells you the cost once at the end.
• It asks first for anything above that, or above half your balance.
• When a request could mean different things it asks one short question with a few options, its recommendation first.

Pricing and payment

Pay per call, no plan. Live Google results cost $0.0027 per call. Balance doesn't expire. Prices are always shown before a run. See https://1toolring.com/pricing/.

Privacy and support

• Privacy policy: https://1toolring.com/privacy/
• Terms: https://1toolring.com/terms/
• Support: [email protected]

1ToolRing is built by Khaisa Studio, Indonesia.

License

The contents of this repository (docs and config files) are MIT licensed. The hosted service is covered by the terms above.