# BotThru

> A drive-thru for AI agents. Ask for one thing, get an honest status, leave. No auth. English. United States first.

## 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`)

Do not send secrets, passwords, API keys, or personal data. Text posted to `/v1/ask` is stored, trimmed to 2000 characters. Raw IP addresses are not stored. `/` is markdown for non-browsers, JSON for `Accept: application/json`, and an order window for browsers.

## Connect

Official MCP Registry name: `com.botthru/drive-thru`.

- [MCP server card](https://botthru.com/.well-known/mcp/server-card.json): SEP-1649 card. Same tools as `tools/list`.
- [MCP manifest](https://botthru.com/.well-known/mcp.json): links to the server card
- [Agent card](https://botthru.com/.well-known/agent-card.json): also [https://botthru.com/.well-known/agent.json](https://botthru.com/.well-known/agent.json). `message/send` at https://botthru.com/a2a runs a tool and returns a completed task. No streaming and no push.
- [API catalog](https://botthru.com/.well-known/api-catalog): RFC 9727 linkset for the HTTP API
- [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

```json
{
  "mcpServers": {
    "botthru": {
      "url": "https://botthru.com/mcp",
      "transport": "streamable-http"
    }
  }
}
```

```
claude mcp add --transport http botthru https://botthru.com/mcp
```

```
curl -s https://botthru.com/v1/ask \
  -H 'content-type: application/json' \
  -H 'accept: application/json' \
  -d '{"need":"what time is it in Chicago","agent":"example"}'
```

## Order window

- [Ask](https://botthru.com/v1/ask): POST `{"need":"...","agent":"optional"}`. `answered` means a tool ran. `routed` means Workers AI wrote a pointer and the task was not done. `unsupported` means the request was logged as demand.
- [Agents](https://botthru.com/agents): curl, MCP config, and limits
- [API](https://botthru.com/api): HTTP reference, order window first

## Docs

- [Home](https://botthru.com/): concise menu (markdown or JSON)
- [Full guide](https://botthru.com/llms-full.txt): examples for every endpoint, including MCP
- [OpenAPI](https://botthru.com/openapi.json): HTTP API description
- [Agent manifest](https://botthru.com/.well-known/agents.json): machine manifest for this service
- [A2A agent card](https://botthru.com/.well-known/agent-card.json): `message/send` at https://botthru.com/a2a. No streaming and no push.
- [MCP server card](https://botthru.com/.well-known/mcp/server-card.json): SEP-1649 card, linked from https://botthru.com/.well-known/mcp.json
- [API catalog](https://botthru.com/.well-known/api-catalog): RFC 9727 linkset
- [Legacy agent card](https://botthru.com/.well-known/agent.json): same skills, plus the older url and protocolVersion fields

## API

- [Time](https://botthru.com/api/time): current UTC time and an IANA zone via `?tz=America/New_York`
- [UUID](https://botthru.com/api/uuid): one UUID v4 from crypto.randomUUID
- [Echo](https://botthru.com/api/echo): method, URL, headers, Cloudflare country, and bot classification of this request
- [Who am I](https://botthru.com/api/whoami): bot name, category, and the rule that matched
- [Stats](https://botthru.com/stats): counts for 24h, 7d, and all-time. Each window includes distinct_agents (by user agent, by salted address hash, and by both), top_agents, top_referrers (hostname only, botthru.com omitted), and mcp_methods. No raw addresses and no need text.

## MCP

- [MCP endpoint](https://botthru.com/mcp): Streamable HTTP, JSON-RPC 2.0, no session. POST initialize, then tools/list and tools/call. 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. Protocol versions: 2025-03-26, 2025-06-18, 2025-11-25. `?tools=read_url,calculate` limits tools/list and tools/call to those catalog names. Unknown names are ignored, and initialize says so. Omit it for every tool.

## Optional

- [Robots](https://botthru.com/robots.txt): crawlers may read the site. `/r/`, `/calc/`, `/time/`, `/dns/`, and `/fx/` are disallowed so a crawler does not trigger a fetch.
- [Sitemap](https://botthru.com/sitemap.xml): public URLs
