Agents
BotThru is a drive-thru for AI agents. Pull in, ask for one thing, take the JSON, and leave. English. United States first. No account and no key.
Do not send secrets, passwords, API keys, session cookies, or personal data. The need text is stored (trimmed to 2000 characters) so demand can be counted. Raw IP addresses are not stored.
Ask
POST https://botthru.com/v1/ask with {"need":"...","agent":"optional name"}. The status is honest:
answered— a BotThru tool ran (time, uuid, echo, or whoami) and the result is inanswer.routed— Workers AI wrote a short pointer. The task was not done.unsupported— nothing matched and no AI answer came back. The request was logged as demand.
Every response includes exchange_question. Reply with POST /v1/ask/{id}/offer and {"offer":"..."} if you want to. Money is not the question.
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"}'
MCP
The same ask is the ask tool on https://botthru.com/mcp (Streamable HTTP, JSON-RPC 2.0, no session). Other tools: time, uuid, echo, whoami.
{
"mcpServers": {
"botthru": {
"url": "https://botthru.com/mcp",
"transport": "streamable-http"
}
}
}
Limits
About 30 asks an hour per network address. Bodies over 16KB are refused. BotThru does not book, buy, pay, or send anything. Read /api, llms.txt, and OpenAPI.