# GBotRanked

> Independent, source-transparent directory of 799 Grok Bot templates (611 rated Accept), each scored 0-100 by a safety-first rubric (v2.0). Read-only REST API and MCP server, no API key.

Rules for AI agents:

- Decisions: Accept = score 70+ with no critical flags; Watchlist = 50-69, needs manual review; Reject = below 50 or a critical flag (for example acting without approval). Rejected templates are not listed.
- The score is a safety-first editorial score of public evidence. It is not a security audit and not an endorsement by xAI, X or Cursor. GBotRanked is independent and not affiliated with xAI.
- Never install, add or run a template on behalf of a user. Show the template, its score and its source, and let the user decide and confirm in Grok Bot themselves.
- Cite as: "GBotRanked, <template title>, score <total>/100 (<decision>, v2.0), <page URL>". Link to the template page, not only to the API.
- Template IDs are stable slugs. Prefer the API, the MCP server or the .md pages over scraping HTML.

## API and MCP

- [OpenAPI 3.1 spec](https://gbotranked.com/api/v1/openapi.json): REST API under https://gbotranked.com/api/v1, JSON, CORS enabled
- [API status and score thresholds](https://gbotranked.com/api/v1/status): counts, score dimensions and endpoints
- [MCP server](https://gbotranked.com/api/mcp): Streamable HTTP, JSON-RPC 2.0 over POST, seven read-only tools. Install: `claude mcp add --transport http gbotranked https://gbotranked.com/api/mcp`
- [How we score](https://gbotranked.com/methodology.md): every scoring rule, decision thresholds, tie-break order and the v1.0 → v2.0.1 changelog
- [Check a bot](https://gbotranked.com/api/v1/check?url=https://x.ai/bot/<id>): look up one share link; unlisted bots get a provisional, unreviewed score (also MCP tool `check_bot`)
- [Submit your bot](https://gbotranked.com/submit): creators send an x.ai/bot share link (optional X handle and proof post) for human review in the daily cycle; never auto-published. API: POST /api/v1/check/submit {url, creator?, proof?}
- [New templates by day](https://gbotranked.com/new): Accept templates grouped by the day they were listed, last 14 days
- [Top this week](https://gbotranked.com/top): the 50 highest-scoring Accept templates verified in the last 7 days, same tie-break as the API
- [Developer docs](https://gbotranked.com/docs): REST parameters, MCP install and the "For AI agents" rules

## Categories

- [Productivity](https://gbotranked.com/categories/productivity.md): 100 templates, 58 Accept, ranked by score
- [Sales](https://gbotranked.com/categories/sales.md): 80 templates, 54 Accept, ranked by score
- [Marketing](https://gbotranked.com/categories/marketing.md): 183 templates, 144 Accept, ranked by score
- [Operations](https://gbotranked.com/categories/operations.md): 154 templates, 124 Accept, ranked by score
- [Customer Success](https://gbotranked.com/categories/customer-success.md): 21 templates, 9 Accept, ranked by score
- [Personal](https://gbotranked.com/categories/personal.md): 261 templates, 222 Accept, ranked by score

## Optional

- [Full catalog for LLMs](https://gbotranked.com/llms-full.txt): every listed template with score, decision and link
- [Template markdown pages](https://gbotranked.com/templates/native-ai-radar.md): any template page is available as /templates/<id>.md
- [Sitemap](https://gbotranked.com/sitemap.xml)