Give Codex Google search and live data via MCP

Q: "Authentication required" when Codex calls a 1toolring tool

The 1ToolRing server needs a sign-in or an API key. Run codex mcp login 1toolring and select Allow on the 1ToolRing page.

Q: No browser on this machine (SSH, a container)

Run codex mcp login 1toolring --no-browser. Codex prints the authorization URL: open it in a browser, sign in, then paste the full redirect URL back into the terminal.

To give Codex Google search, run codex mcp add 1toolring --url https://mcp.1toolring.com/mcp, then codex mcp login 1toolring and select Allow in the browser. Codex then has 1ToolRing's four tools and can fetch live Google results as JSON, keyword search volume, Google Maps places, Amazon products and exchange rates. Every tool carries its price, shown before the run, and runs are paid from a prepaid balance you top up from $1 by card or Rp10.000 by bank transfer. Failed calls are not charged.

Set it up

Add the server from your terminal:

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

Sign in. Your browser opens the 1ToolRing approval page; select Allow.
```
codex mcp login 1toolring
```
Check that it is configured:
```
codex mcp list
```

Where Codex keeps the config

Codex stores MCP servers in config.toml, by default ~/.codex/config.toml, so the server is there for every session. Run codex mcp --help to see the other MCP commands.

Other ways to set it up

Paste this line into the agent's chat and it reads the setup guide, installs 1ToolRing and asks you to sign in:

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

Or add 1toolring to every agent on this machine from a terminal (needs Node.js):

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

First prompt to try

Paste this into a new session. The agent should call discover_tools to find a Google search tool, inspect_tool to read its input and price, and then run_tool. You see the price before anything is spent.

Use 1toolring to get the top Google results for "standing desk" in the United States. Tell me which tool you will use and its price before you run it, then list the top 10 URLs with their rank.

What the calls cost

A few tools your agent is likely to pick. Discovering and inspecting tools is free; only a successful run is charged. How pricing works.

Prices as of 5 Nov 2026; the live price is always shown before a run.
Job	Tool id	Price	Billed
Live Google organic results, SERP features parsed	dataforseo/serp/google-organic	$0.0026 (Rp48)	per call (one page of 10 results)
Google search, every results-page element as JSON	serpapi/google/search	$0.0195 (Rp354)	per successful search
Google Ads search volume, CPC and competition	dataforseo/keywords/google-ads-search-volume	$0.117 (Rp2.122)	per call (up to 1,000 keywords)
Google Maps places, or one place in full	serpapi/google/maps	$0.0195 (Rp354)	per successful search
Amazon search with price, rating and badges	dataforseo/amazon/products	$0.0043 (Rp78)	per call (one page of 48 results)
Daily exchange rates from a base currency	1toolring/fx/latest	$0.0003 (Rp5)	per call

Troubleshooting

"Authentication required" when Codex calls a 1toolring tool

The 1ToolRing server needs a sign-in or an API key. Run codex mcp login 1toolring and select Allow on the 1ToolRing page.

No browser on this machine (SSH, a container)

Run codex mcp login 1toolring --no-browser. Codex prints the authorization URL: open it in a browser, sign in, then paste the full redirect URL back into the terminal.

mcp.1toolring.com can't be reached (proxy 403, DNS failure, timeout)

That comes from the network policy of the environment the agent runs in, so retrying won't help. Run the agent on a machine with normal network access, or allowlist mcp.1toolring.com and api.1toolring.com on port 443.

Tools answer 403 EARLY_ACCESS_PENDING

1ToolRing is in early access and new accounts are approved in batches. Sign-in works before approval, but tools, keys and top-ups stay locked until the approval email arrives. Nothing is charged for these calls.

A run fails with 402 INSUFFICIENT_BALANCE

The balance can't cover the price of that call. The error carries your balance, the amount needed and a top-up link. Top up any amount on the Billing page: from Rp10.000 by bank virtual account or Alfamart/Indomaret, or from $1 by card. The refused call costs nothing.

A tool answers 403 TOOL_BLOCKED

That tool is not offered on 1ToolRing, and nothing was charged. People or contact data, email finding, social media data and web scraping are not in the catalog. Ask your agent to pick another tool with discover_tools.

Tool pages

Other guides

Steps checked against Codex: Model Context Protocol (checked 2026-11-05).