Agent Web Search MCP

Web search + URL fetcher for AI agents. DuckDuckGo Lite — zero API keys to get started.

Two tools: search_web (DuckDuckGo, 10 results with title/URL/snippet) and fetch_url (reads page content, strips HTML, 8000 chars limit). Works with any MCP-compatible client — Claude Code, Cursor, Windsurf, Continue.dev, and raw JSON-RPC.

Quick Start

# Install
npm install
PORT=3169 node index.js

Or connect directly to the public endpoint:

POST https://hermes-api.tiagohanna.com/

MCP Protocol

Standard JSON-RPC 2.0. Request:

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_web","arguments":{"query":"latest AI news"}}}

Response contains results with title, URL, and snippet per tool.

Available Tools

Tool	Description
`search_web`	DuckDuckGo web search. Param: `query` (string, required). Max 500 chars.
`fetch_url`	Fetch and extract text from any URL. Param: `url` (string, required). Max 8000 chars output.

Pricing

Tier	Price	Limit	How
Free	$0	7 req/day per IP	No API key needed
Pro	R$50	Unlimited	API key via `x-api-key` header

Buy Pro — Fully Automated

# Step 1: Initiate purchase
curl -X POST https://hermes-api.tiagohanna.com/buy \
  -H 'Content-Type: application/json' \
  -d '{"email": "[email protected]"}'
# → Returns pending_id + purchase URL

# Step 2: Pay R$50 (Pix or credit card)
# Use the purchase URL from step 1

# Step 3: Activate with payment proof
curl -X POST https://hermes-api.tiagohanna.com/activate \
  -H 'Content-Type: application/json' \
  -d '{"pending_id": "pend-xxx...", "payment_ref": "your-order-id", "email": "[email protected]"}'
# → Returns your API key

# Step 4: Use it
curl -X POST https://hermes-api.tiagohanna.com/ \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_PRO_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_web","arguments":{"query":"hello world"}}}'

Or pay first, activate after

Just pay R$50 directly:

https://checkout.infinitepay.io/mkblprodutora?lenc=GzcBYBwJduzICuU4dMz9_dyOkAllVa2TwkT_7E2RKFYJ2bUkri-gGqWJ6srTA4cwCNqCttri_stBTnjQE0Q_yqG2uWwiwnsvRA2hzJ4B6qnU07L-YX6heyWdFUDzqqoJoqLJ8pb2uCSRFf8mnhUU5katL8d7T7i1Ubb_24uTCG6ktxvbte6CaufMuigAC7kFBo-ZKVAYAt1MB_AtUnqIBC4d6upcNHvQ6yJu5C1SJx9VQW25UVTI9CEw09TkBZFtSVxreiKxs138EwBEw1VdxA2ziepSCa6WZoZYlHooRZWbmQO6Cg.v1.2e0fe926212753c6

Then call POST /activate with your payment_ref and email.

Health Check

curl https://hermes-api.tiagohanna.com/
# → {"status":"ok","server":"agent-web-search-mcp","version":"2.0.0","freeTier":"7 req/IP/day","proTier":"R$50 via Pix/Credit"}

Host Your Own

git clone https://github.com/tiagohanna123/agent-web-search-mcp
cd agent-web-search-mcp
npm install
PORT=3169 node index.js

Deploy to any Node.js host (Railway, Fly.io, Render, VPS).

Why This Exists

AI agents don't have convenient web search. Most search APIs cost money or require complex setup. DuckDuckGo Lite is free, no API key, no rate limit on their end — this server wraps it in a clean MCP interface that any agent can consume programmatically.

License

MIT

Agent Web Search MCP