web_search · REST + MCP

Web search

Search the web and get the top results (title, URL, snippet) as clean JSON. Live Google results, any country or city. Use when you need current information, sources, or links.

$0.01 USD per successful paid call

This tool uses prepaid credit. Connect without a key and your agent will get a key and payment link when it needs this tool.

Charged once per call that returns a result, including an empty result list. Failed calls are free.

Connect your agent

Use it in your chat

Start with no key

In Claude.ai, Claude Desktop, Claude Code, ChatGPT or Codex, add a custom connector with this URL. No API key or Authorization header is needed.

https://unstuckapi.com/mcp

Try a few free calls a day with read_page, domain_check, domain_info, pdf_to_text, vulnerability_lookup, or paper_search. Each free result says how many are left and when they reset (midnight UTC).

A paid tool called without a key returns a new API key and a payment link instead of a result, and nothing is charged. In Claude, a Connect button opens the same payment page. Once credit is added, the agent can continue in the same chat with that key.

Already have a key?

If your connector cannot send headers, use this URL instead. Replace YOUR_API_KEY with your key.

https://unstuckapi.com/mcp?key=YOUR_API_KEY

Keep the completed URL private: it contains your API key.

Ask your agent to call web_search with these arguments:

{
  "query": "best running shoes",
  "num": 5
}

Inputs

Send these fields as a JSON object to POST /v1/tools/web_search.

Input fields for web_search
Field	Type	Description & limits
`query`	string Required	What to search for.Minimum characters: 1 · Maximum characters: 300
`location`	string Optional	Country or place to search from, e.g. "Houston, TX". Default "United States" (or the connection's default location).Minimum characters: 2 · Maximum characters: 100
`num`	integer Optional	How many results, default 10, max 20.Minimum: 1 · Maximum: 20

Developer option: REST

Replace YOUR_API_KEY with your key. The following command makes a paid call if it succeeds.

export UNSTUCK_API_KEY="YOUR_API_KEY"

curl 'https://unstuckapi.com/v1/tools/web_search' \
  -H "Authorization: Bearer $UNSTUCK_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"query":"best running shoes","num":5}'

The response contains result, charged_usd, and your remaining balance_usd. Invalid input and failed tool calls are not charged.

Developer option: MCP with a header

For clients that support headers, connect using Streamable HTTP and these values:

https://unstuckapi.com/mcp

Authorization: Bearer YOUR_API_KEY

Connection guide · Full JSON schemas and prices · Agent instructions