# BotThru

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

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`.

```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): discovery card; BotThru does not accept A2A tasks
- [MCP server card](https://botthru.com/.well-known/mcp.json): Streamable HTTP endpoint and protocol versions

## 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): visit counts by bot and category for 24h, 7d, and all-time, plus top paths

## MCP

- [MCP endpoint](https://botthru.com/mcp): Streamable HTTP, JSON-RPC 2.0, no session. POST initialize, then tools/list and tools/call. Tools, ask first: ask, time, uuid, echo, whoami. Protocol versions: 2025-03-26, 2025-06-18, 2025-11-25.

## Optional

- [Robots](https://botthru.com/robots.txt): all crawlers allowed, including AI crawlers
- [Sitemap](https://botthru.com/sitemap.xml): public URLs
