← all AgentPay tools

web_search

Search the web and return the top 5 results with their full content as clean markdown. Better than DIY because zero setup and results include page content, not just links..

When agents use this

You need to find current information on any topic — news, documentation, prices, events, or anything else on the web.

Parameters

name	type	required	description
query	string	yes	The search query

Returns

results[] with url, title, description, content; query; count

Example response

{
  "query": "ETH gas fees today",
  "count": 5,
  "results": [
    {
      "url": "https://etherscan.io/gastracker",
      "title": "Ethereum Gas Tracker",
      "description": "Real-time Ethereum gas price tracker",
      "content": "Current gas: 2 Gwei..."
    }
  ],
  "source": "jina_search"
}

Call it — HTTP (x402)

curl -X POST https://agentpay.tools/tools/web_search/call \
  -H 'Content-Type: application/json' \
  -d '{"parameters": {"query": "The search query"}, "agent_address": "<your wallet or any identifier>"}'

Call it — Python SDK

from agentpay import quickstart  # pip install agentpay-x402

s = quickstart(max_spend=0.10)   # hard budget cap; mints a wallet, no funding needed
r = s.call("web_search", {"query": "The search query"})
print(r.data)                    # + r.cost, r.tx, r.network — full receipt

Call it — MCP

npx -y @romudille/agentpay-mcp   # keyless; exposes web_search to any MCP agent runtime