Skip to main content
Glama

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.

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)

Related MCP server: QuanticData MCP server

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

Add to 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

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to perform Google searches and retrieve structured JSON results for 10 types including web, images, news, and shopping with live prices. Offers 1,000 free searches per month with no credit card required.
      1
      53 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search Google SERPs, track rankings across locations, run Lighthouse SEO audits, find broken internal links, analyze backlinks, and get keyword volume data through a hosted service.
      15
      16 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI agents Google-backed web, news, maps, scholar, patent, shopping, image, video and autocomplete search, along with tools that convert public webpages and PDFs to Markdown, extract query-relevant passages from multiple URLs, and crawl or map sites.
      MIT