# GrokBot Zone

> A searchable directory of public Grok bot listings. Agents can search, read, submit and subscribe with no browser.

The catalog is a snapshot, refreshed Monday and Thursday. A submitted bot is queued and checked before it is public. This site is not a store. The contact path is the submit form.

## Products / Services
- [Categories](https://grokbot.zone/categories/): bots grouped by the job they do
- [Search](https://grokbot.zone/bots/): find a bot by name or job
- [Submit a bot](https://grokbot.zone/submit/): list a public Grok bot
- [Read API](https://grokbot.zone/api/): static JSON catalog

## Policies
- [FAQ](https://grokbot.zone/faq/): what the directory lists, and what it does not run or host

## Help
- [For AI agents](https://grokbot.zone/agents/): MCP endpoint, HTTP API and the onboarding skill
- [Submit](https://grokbot.zone/submit/): the contact path on this site

## Agent context
- Prices and stock: not a store. Listing is free.
- Actions: MCP at https://grokbot.zone/mcp (Streamable HTTP, JSON responses). Read tools need no auth. Submit and subscribe use the same rate limits and double opt-in as the site forms.

## Optional
- [Full agent notes](https://grokbot.zone/llms-full.txt)
- [OpenAPI](https://grokbot.zone/openapi.json)
- [API catalog](https://grokbot.zone/.well-known/api-catalog)

## MCP tools
POST https://grokbot.zone/mcp. Protocol 2025-11-25 (initialize, notifications/initialized, tools/list, tools/call) and 2026-07-28 (server/discover). Stateless. GET returns 405.

| Tool | Input | Effect |
|---|---|---|
| grokbot_health | none | Worker and database check |
| grokbot_list_categories | none | Category slugs, labels, counts |
| grokbot_get_category | slug | Bots in one category |
| grokbot_search | query, optional category, optional author | Up to 10 bots scored on name and description |
| grokbot_trending | optional category | Ordered bot ids |
| grokbot_get_bot | id | One bot record |
| grokbot_check_listed | link or code | Whether that bot is already listed |
| grokbot_submit_bot | name, link, category, description, email, optional author | Queue a listing. Same handler as the form |
| grokbot_subscribe | email | Double opt-in. Nothing is sent until the confirm link is clicked |

## HTTP reads
- GET /api/v1/index.json
- GET /api/v1/categories.json
- GET /api/v1/categories/{slug}.json
- GET /api/v1/trending.json
- GET /api/v1/recent.json
- GET /api/v1/bots/{id}.json
- GET /api/v1/codes.json
- GET /api/health
- GET /feed.json and GET /feed.xml

## HTTP writes
- POST /api/v1/submissions (alias POST /api/submit), JSON, content-type application/json
- POST /subscribe, JSON

Errors are JSON `{ok:false, error}` or `{ok:false, errors}`. Send `Accept: application/problem+json` for an RFC 9457 body.
