free-web-mcp
Web search and page reading for AI agents with zero API credits. r.jina.ai, Wikipedia, Hacker News and GitHub behind one MCP server — no key, no credit card, no rate-limit roulette.
에이전트 강화
게시자의 자체 URL입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
https://uowaj-85-114-204-123.run.pinggy-free.link/mcp위의 Claude 버튼을 누르면 이름과 URL이 채워진 상태로 Claude가 열립니다. 확인은 Claude에서 직접 해야 합니다.
claude mcp add --transport http io.github.rustemmustafingovua-byte-free-web-mcp https://uowaj-85-114-204-123.run.pinggy-free.link/mcpRun in a terminal.
{ "mcpServers": { "io.github.rustemmustafingovua-byte-free-web-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://uowaj-85-114-204-123.run.pinggy-free.link/mcp" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행Docs · Contributing · Security · Issues · Discussions
Most "web search for agents" tools bill per call. For an agent that runs dozens of searches per session, that adds up fast — and a budget-capped agent simply cannot browse.
free-web-mcp gives an agent the web for $0:
The server is live as a real streamable-HTTP MCP server:
{
"mcp": {
"free-web": {
"type": "remote",
"url": "https://kjnmv-85-114-207-24.free.pinggy.net/mcp",
"enabled": true
}
}
}
It is also listed in the official MCP Registry as
io.github.rustemmustafingovua-byte/free-web-mcp.
# проверка вручную
curl -s -X POST https://kjnmv-85-114-207-24.free.pinggy.net/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"c","version":"1"}}}'
Health check: https://kjnmv-85-114-207-24.free.pinggy.net/health
free-web-fetch reads a page that sits behind a Cloudflare check or a captcha.
It tries, in order: a direct request → a local FlareSolverr → a paid solver
(only for domains on your allowlist) → a text-render fallback. The answer says
which path worked.
export FLARESOLVERR_URL=http://127.0.0.1:8191 # optional, self-hosted
export CAPSOLVER_KEY=… # optional, paid
export FREE_WEB_ALLOWLIST=example.com # who the paid path may touch
Full survey of the options and the policy: docs/CAPTCHA.md.
The hosted endpoint takes payment in native ETH on Base as well as USDC. The 402 response lists both options with exact amounts, and the server verifies the transaction on-chain (the payer pays the gas, the server needs nothing).
→ 402 {
"ways": [
{ "kind": "transfer-and-prove", "asset": "USDC", "amount": "1000" },
{ "kind": "native-eth-transfer", "asset": "ETH", "amount": "500000000000" }
]
}
The ETH price comes from a public API without a key, cached for a minute, with a conservative fallback. Everything lands in one wallet: the payment, the gas and the Lumen deployment.
npx free-web-mcp # then ask the agent for "the links from this page"
The hosted service works in two modes:
Payments are actually collected: the server verifies the EIP-3009
transferWithAuthorization signature and submits it on-chain, so the USDC
really moves to the project wallet. The collection transaction is paid for from
X402_GAS_KEY (a small amount of ETH on Base is needed for gas).
export X402_PRICE_USD=0.001
export X402_GAS_KEY=0x… # wallet that pays gas for collecting
Clients pay the way the x402 standard says: request → 402 with the payment
terms → sign → retry with the PAYMENT-SIGNATURE header.
The hosted endpoint speaks x402. Two ways to pay, and the server never spends your money and never needs gas of its own in the first one:
# 1) клиент сам переводит USDC на адрес получателя (газ платит клиент)
# и повторяет запрос с хешем транзакции
curl -s -X POST "$HOST/mcp/paid" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-PAYMENT-TX: 0x<tx hash>" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 2) или подписывает EIP-3009 transferWithAuthorization
curl -s -X POST "$HOST/mcp/paid" \
-H "PAYMENT-SIGNATURE: <signed authorization>" \
...
Payment address (Base): 0x8aC6a229f254980CCd3Dd35CF5E1B7c08880B40E
The 402 response contains the exact terms (payTo, amount, asset, network),
so a client does not need to hardcode anything.
# tarball из релиза: без токена и без npm-логина
npm i -g https://github.com/rustemmustafingovua-byte/free-web-mcp/releases/download/v0.1.0/free-web-mcp-0.1.0.tgz
npm i -g @rustemmustafingovua-byte/free-web-mcp --registry=https://npm.pkg.github.com
flowchart LR
A[agent tool call] --> B{tool}
B -- free-web-read --> C[r.jina.ai<br/>page -> markdown]
B -- free-web-search --> D[Wikipedia + HN + GitHub]
B -- free-wiki --> E[Wikipedia REST]
B -- free-hn --> F[Algolia HN]
B -- free-github --> G[GitHub Search API]
C & D & E & F & G --> H[result<br/>usage: 0 credits]
import { read, search, wiki, hn, github } from "free-web-mcp"
const page = await read("https://example.com")
const everything = await search("opencode ai", { limit: 5 })
The HTTP mode is the same code, ready to be served — and priced per call with x402 if you want:
free-web-mcp serve --port 8788
curl -s localhost:8788 -X POST -d '{"query":"opencode"}' -H 'content-type: application/json'
The service is running publicly, no key and no credits:
curl https://kjnmv-85-114-207-24.free.pinggy.net/health
curl -X POST https://kjnmv-85-114-207-24.free.pinggy.net -H 'content-type: application/json' -d '{"query":"open source agent tools","source":"github"}'
https://kjnmv-85-114-207-24.free.pinggy.net
The tunnel URL rotates when the service restarts. To run it yourself:
free-web-mcp serve --port 8788(add--price 0.001to charge per call in USDC on Base — the payment signature is verified before anything is served).
r.jina.ai is the backbone for read; it renders JavaScript pages for you.free-web-mcp — Web search and page reading for agents, with zero API credits. Public MCP endpoint included.
USAGE
free-web-mcp run the MCP server on stdio
free-web-mcp serve run an HTTP server
free-web-mcp serve --price 0.001 charge 0.001 USDC per call on Base
COMMANDS / OPTIONS
serve HTTP mode instead of the stdio MCP server
--port <n> port for the HTTP server (default 8788)
--price <usd> charge per call in USDC (x402, Base); the signature is verified
Environment: JINA_API_KEY (optional, enables full web search), GITHUB_TOKEN (optional)
MIT · https://github.com/rustemmustafingovua-byte
MIT, forever. USDC on Base:
0x8aC6a229f254980CCd3Dd35CF5E1B7c08880B40E
Every tool here is MIT and free. If it saved you time, you can support the work:
0x8aC6a229f254980CCd3Dd35CF5E1B7c08880B40EPaid tiers of the hosted services are billed per call in USDC (x402) — no accounts, no keys.
MIT © rustemmustafingovua-byte
Web search and page reading for AI agents with zero API credits
{ "mcpServers": { "io.github.rustemmustafingovua-byte-free-web-mcp": { "url": "https://uowaj-85-114-204-123.run.pinggy-free.link/mcp", "headers": {} } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 http 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Free Web에는 HTTP로 연결합니다.
마지막 확인: 2026-11-10. Web search and page reading for AI agents with zero API credits