Documentation

Three ways in: connect a remote MCP client with no install, run the local MCP package with a wallet, or call the HTTP endpoints directly and pay per request with x402. No API keys in any of them.

1. Remote MCP, no install

Point any MCP client at the URL below. Nothing to download, no wallet needed. Returns the free preview tier across every wire.

https://thebotwire.com/mcp    (streamable HTTP)

# Claude Code
claude mcp add --transport http botwire https://thebotwire.com/mcp

# Any MCP client config
{"mcpServers":{"botwire":{"type":"http","url":"https://thebotwire.com/mcp"}}}

Tools: search_news, query_wire, list_wires, botwire_status

2. Local MCP with your wallet

The npm package signs x402 payments with your own key, so paid tiers work end to end inside your agent.

# Claude Code, Claude Desktop, Codex CLI
claude mcp add botwire -- npx -y botwire-mcp

# set a funded Base wallet for the paid wires
BOTWIRE_WALLET_PRIVATE_KEY=0x...

Package: botwire-mcp on npm

3. Direct HTTP with x402

curl "https://thebotwire.com/news?q=fed+rates&since=2h"
# 402 Payment Required, the offer arrives in the PAYMENT-REQUIRED header

curl -H "PAYMENT: <signed authorization>" "https://thebotwire.com/news?q=fed+rates&since=2h"
# 200 OK with ranked results. USDC on Base, settles in about a second.

Paid endpoints

EndpointWhat it returnsPer call
GET /news?q=&since=2h&category=Ranked news search across 40 sources, with summaries$0.005
GET /headlines?category=cryptoLatest headlines by category$0.005
GET /edgar/filings?q=&form=Search latest SEC EDGAR filings (8-K, 10-K/Q, insider Form 4, S-1, 13F, 13D)$0.01
GET /cve/latest?q=&src=Latest security advisories & CVEs (CISA, MSRC, Ubuntu, Debian, ZDI)$0.005
GET /reg/latest?q=&type=New US federal regulations (Federal Register: rules, proposed rules, notices, presidential docs)$0.005
GET /weather/alerts?q=&severity=Active US severe weather alerts (National Weather Service watches, warnings, advisories)$0.005
GET /quake/latest?q=&mag=Latest earthquakes worldwide (USGS: significant, M4.5+, M2.5+)$0.005
GET /arxiv/latest?q=&cat=New AI/ML/NLP/security research papers (arXiv cs.AI, cs.LG, cs.CL, cs.CR)$0.005
GET /fed/latest?q=&src=Central bank announcements (Federal Reserve press releases, FOMC, ECB)$0.01
GET /hn/latest?q=&feed=Hacker News front page, Show HN, and rising stories$0.005
GET /status/latest?q=&provider=Cloud provider incidents & outages (AWS, GCP, Azure DevOps, GitHub, Cloudflare, OpenAI, Anthropic)$0.005
GET /ailab/latest?q=&lab=AI lab announcements (OpenAI, Google DeepMind, Google AI, Hugging Face, AWS ML)$0.005
GET /security/news?q=&src=Security journalism and breach reporting (Krebs, BleepingComputer, The Hacker News, Ars Technica)$0.005
GET /court/opinions?q=&type=New US federal court opinions (Supreme Court, 2nd, 9th and Federal Circuits)$0.01
GET /bills/latest?q=&type=New congressional bills and statute compilations (GovInfo)$0.01
GET /enforcement/latest?q=&agency=SEC and FTC enforcement actions and press releases$0.01
GET /recalls/latest?q=&src=Product safety recalls and FDA regulatory actions (CPSC, FDA)$0.005
GET /crypto/latest?q=&src=Crypto and blockchain news (CoinDesk, Cointelegraph, Ethereum Foundation)$0.005
GET /space/latest?q=&src=NASA news releases: missions, launches, discoveries$0.005
GET /sports/latest?q=&src=Sports headlines and results (BBC Sport, ESPN)$0.005
GET /jobs/latest?q=&src=Remote tech job postings (We Work Remotely, Hacker News jobs)$0.005
GET /releases/latest?q=&project=New releases of major open-source projects (Node, Python, Kubernetes, Rust, Go, React, PyTorch, Deno, Bun)$0.005
GET /markets/latest?q=&src=Market and equities news (Yahoo Finance, MarketWatch, Seeking Alpha)$0.005
GET /world/latest?q=&src=International news from non-US desks (Al Jazeera, Deutsche Welle, France 24, BBC World)$0.005
GET /tech/latest?q=&src=Technology industry news (TechCrunch, The Verge, Ars Technica)$0.005
GET /econ/latest?q=&src=US economic data releases (BLS, BEA, Federal Reserve H.15 rates)$0.01
GET /science/latest?q=&src=Peer-reviewed science news and journal contents (Nature, Science, Phys.org)$0.005
GET /preprints/latest?q=&src=Biology and medicine preprints (bioRxiv, medRxiv)$0.005
GET /publichealth/latest?q=&src=Public health announcements and outbreak news (WHO, CDC)$0.005
GET /fda/latest?q=&src=FDA press releases: drug and device approvals, safety actions$0.005
GET /doj/latest?q=&src=US Department of Justice announcements: indictments, settlements, antitrust$0.005
GET /eu/latest?q=&src=European Commission press releases and policy announcements$0.005
GET /uk/latest?q=&src=UK government news and communications (GOV.UK)$0.005
GET /defense/latest?q=&src=US Department of Defense news releases and contract awards$0.005
GET /whitehouse/actions?q=&src=Presidential actions: executive orders, proclamations, memoranda$0.005
GET /energy/latest?q=&src=Energy market news and analysis (EIA, US DOE, OilPrice, Utility Dive)$0.005
GET /supplychain/latest?q=&src=Freight, logistics and supply chain news (FreightWaves, Supply Chain Dive)$0.005
GET /launches/latest?q=&src=New product and project launches (Product Hunt, Lobsters, DEV)$0.005
GET /gaming/latest?q=&src=Video game industry news and releases (GameSpot, IGN)$0.005
GET /film/latest?q=&src=Film and television industry news (Variety, Deadline)$0.005
GET /music/latest?q=&src=Music industry news and releases (Pitchfork, Rolling Stone)$0.005

Free endpoints

EndpointWhat it returnsPrice
GET /news/preview?q=Free preview of the news wire, top 3 resultsfree
GET /edgar/previewFree preview of the edgar wire, top 3 resultsfree
GET /cve/previewFree preview of the cve wire, top 3 resultsfree
GET /reg/previewFree preview of the reg wire, top 3 resultsfree
GET /weather/previewFree preview of the weather wire, top 3 resultsfree
GET /quake/previewFree preview of the quake wire, top 3 resultsfree
GET /arxiv/previewFree preview of the arxiv wire, top 3 resultsfree
GET /fed/previewFree preview of the fed wire, top 3 resultsfree
GET /hn/previewFree preview of the hn wire, top 3 resultsfree
GET /status/previewFree preview of the status wire, top 3 resultsfree
GET /ailab/previewFree preview of the ailab wire, top 3 resultsfree
GET /security/previewFree preview of the sec-news wire, top 3 resultsfree
GET /court/previewFree preview of the court wire, top 3 resultsfree
GET /bills/previewFree preview of the bills wire, top 3 resultsfree
GET /enforcement/previewFree preview of the enforce wire, top 3 resultsfree
GET /recalls/previewFree preview of the recall wire, top 3 resultsfree
GET /crypto/previewFree preview of the crypto wire, top 3 resultsfree
GET /space/previewFree preview of the space wire, top 3 resultsfree
GET /sports/previewFree preview of the sport wire, top 3 resultsfree
GET /jobs/previewFree preview of the jobs wire, top 3 resultsfree
GET /releases/previewFree preview of the releases wire, top 3 resultsfree
GET /markets/previewFree preview of the markets wire, top 3 resultsfree
GET /world/previewFree preview of the world wire, top 3 resultsfree
GET /tech/previewFree preview of the tech wire, top 3 resultsfree
GET /econ/previewFree preview of the econ wire, top 3 resultsfree
GET /science/previewFree preview of the science wire, top 3 resultsfree
GET /preprints/previewFree preview of the preprints wire, top 3 resultsfree
GET /publichealth/previewFree preview of the pubhealth wire, top 3 resultsfree
GET /fda/previewFree preview of the fda wire, top 3 resultsfree
GET /doj/previewFree preview of the doj wire, top 3 resultsfree
GET /eu/previewFree preview of the eu wire, top 3 resultsfree
GET /uk/previewFree preview of the uk wire, top 3 resultsfree
GET /defense/previewFree preview of the defense wire, top 3 resultsfree
GET /whitehouse/previewFree preview of the whitehouse wire, top 3 resultsfree
GET /energy/previewFree preview of the energy wire, top 3 resultsfree
GET /supplychain/previewFree preview of the supplychain wire, top 3 resultsfree
GET /launches/previewFree preview of the launches wire, top 3 resultsfree
GET /gaming/previewFree preview of the gaming wire, top 3 resultsfree
GET /film/previewFree preview of the film wire, top 3 resultsfree
GET /music/previewFree preview of the music wire, top 3 resultsfree
GET /healthService freshness, item counts, last refreshfree
GET /sourcesEvery source we poll, with categoriesfree
GET /openapi.jsonFull OpenAPI 3 specificationfree
GET /.well-known/x402x402 discovery documentfree
GET /llms.txtMachine-readable guide for AI agentsfree

Common parameters

ParameterMeaning
qSearch terms. Omit to get the latest items instead of a search.
sinceFreshness window: 30m, 2h, 24h, 3d. Defaults vary by wire.
limitMaximum results, 1 to 50. Defaults to 10.
category / form / src / type ...Per-wire filter. Each wire names its own, listed in the tables above.