# BotThru

> A drive-thru for bots. Whatever your agent needs. Just ask.

BotThru (https://botthru.com) is a free, no-auth lane for AI agents and crawlers. English. United States first. Browsers get an order window. Everyone else gets this page.

Do not send secrets or personal data. The text you POST to `/v1/ask` is stored. Send `Accept: text/markdown` or `Accept: application/json`. No account, no key. CORS is open.

## Use it from any fetch tool

No MCP client required. GET the URL. `/r/` returns markdown. The others return plain text. `Accept: application/json` returns the tool JSON. Each call is logged like an MCP or REST tool call.

- https://botthru.com/r/https://example.com/page — Read a public page as markdown. /r/example.com works without a scheme. (`read_url`)
- https://botthru.com/calc/15%25%20of%2080 — Evaluate an expression or convert a unit. (`calculate`)
- https://botthru.com/time/America/Sao_Paulo — Current time in a city or IANA time zone. (`time`)
- https://botthru.com/dns/example.com/MX — DNS lookup. The type defaults to A. (`dns_lookup`)
- https://botthru.com/fx/USD/BRL/100 — Fiat rate. The amount defaults to 1. (`exchange_rate`)

## Menu

Version 0.2.0. BotThru 0.2.0 reads public pages, extracts their metadata and structure, checks URLs and remote MCP servers, calculates and converts units, looks up DNS and registration data, converts times and dates, lists holidays and fiat rates, and embeds or reranks text. Agents with only a web fetch can GET /r/https://example.com, /calc/, /time/, /dns/, and /fx/. POST /v1/ask, A2A message/send, and POST /v1/message:send run a tool when the request is clear. Unclear text gets the skill list, not a guessed answer. No auth. No streaming and no push.

- [Read URL](https://botthru.com/v1/tools/read_url): Read https://example.com
- [Calculate](https://botthru.com/v1/tools/calculate): What is 15% of 80
- [Extract page data](https://botthru.com/v1/tools/extract_page_data): Extract metadata from https://example.com
- [Site discovery](https://botthru.com/v1/tools/site_discovery): Discover agent files for example.com
- [Check URL](https://botthru.com/v1/tools/check_url): Check the status of https://example.com
- [Check MCP server](https://botthru.com/v1/tools/check_mcp_server): Check the MCP server at https://example.com/mcp
- [DNS lookup](https://botthru.com/v1/tools/dns_lookup): MX records for example.com
- [RDAP lookup](https://botthru.com/v1/tools/rdap_lookup): Whois example.com
- [Convert time](https://botthru.com/v1/tools/time_convert): Convert 2026-11-17T15:00 from America/New_York to Europe/Paris
- [Date math](https://botthru.com/v1/tools/date_math): Add 3 business days to 2026-11-17
- [Public holidays](https://botthru.com/v1/tools/holidays): Public holidays in the US in 2026
- [Exchange rate](https://botthru.com/v1/tools/exchange_rate): Convert 10 USD to EUR
- [Embed text](https://botthru.com/v1/tools/embed): POST /v1/tools/embed {"texts":["hello"]}
- [Rerank documents](https://botthru.com/v1/tools/rerank): POST /v1/tools/rerank {"query":"docs","documents":["a","b"]}
- [Fetch page](https://botthru.com/v1/tools/fetch_page): GET /v1/tools/fetch_page?url=https://example.com
- [Ask](https://botthru.com/v1/tools/ask): POST /v1/ask {"need":"what time is it in Chicago"}
- [Current time](https://botthru.com/v1/tools/time): What time is it in Chicago
- [UUID](https://botthru.com/v1/tools/uuid): Make a UUID
- [Echo request](https://botthru.com/v1/tools/echo): Echo my headers
- [Who am I](https://botthru.com/v1/tools/whoami): Who am I

- [Ask](https://botthru.com/v1/ask): POST `{"need":"..."}`. Status is `answered`, `routed`, or `unsupported`. Nothing is marked done unless a tool ran.
- [Agents](https://botthru.com/agents): how to call the order window, MCP, and A2A
- [API](https://botthru.com/api): HTTP reference
- [llms.txt](https://botthru.com/llms.txt): discovery index
- [Full guide](https://botthru.com/llms-full.txt): request and response examples
- [MCP](https://botthru.com/mcp): Streamable HTTP. Tools: read_url, calculate, extract_page_data, site_discovery, check_url, check_mcp_server, dns_lookup, rdap_lookup, time_convert, date_math, holidays, exchange_rate, embed, rerank, fetch_page, ask, time, uuid, echo, whoami.
- [A2A](https://botthru.com/a2a): `message/send` returns a completed task. Card: https://botthru.com/.well-known/agent-card.json
- [Stats](https://botthru.com/stats): visits by bot, traffic lane, distinct agents, referrers, MCP methods, and ask resolution
