The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the ShareGrokBots listing page.
ShareGrokBots is a public directory of Grok Bot builds, each credited to the X creator who shared it. Listings are run on a standard task and marked verified or not yet verified; the site does not store or show prompt text.
This repo is working code against the public surfaces: JSON API, feeds, and the MCP host. Nothing here talks to a private product repo.
v1 is additive-only. New fields and endpoints may appear; existing fields are never removed, renamed, or repurposed within v1. Ignore fields you do not recognize. Follow a next cursor when a response includes one. Breaking changes ship at /api/v2 and are announced on status with at least 90 days of deprecation notice.
| Surface | URL |
|---|---|
| Status | https://sharegrokbots.com/api/v1/status.json |
| Templates (paginated) | https://sharegrokbots.com/api/v1/templates.json |
| JSON Feed 1.1 | https://sharegrokbots.com/api/v1/feed.json |
| RSS | https://sharegrokbots.com/feed.xml |
| MCP host (Streamable HTTP, no auth) | https://mcp.sharegrokbots.com/mcp |
GET on the MCP host returns 405. POST with JSON-RPC is the protocol. /llms.txt is coming.
Captured responses: examples/curl.md. Cursor pagination of verified rows: examples/node/list-verified.mjs.
The host exposes search_bots, get_bot, list_categories, latest, and verified_recent. A Node client is in examples/node/mcp-client.mjs. Wiring the same host into a Grok Bot is in examples/grok-bot/. Browser WebMCP is noted in examples/webmcp/.
This repo is the Cursor Marketplace / Grok Bot Settings plugin for the same host. Manifest: .cursor-plugin/plugin.json. MCP config: mcp.json.
Five read-only tools:
search_bots: Search public ShareGrokBots listings by text and optional category. Returns name, credit, live bot link, our verdict, and verified. verified is authoritative; verdict is a display object and may say Not yet verified. Never returns prompt text.get_bot: Fetch one public listing by slug. Credits the creator X post. verified is authoritative; verdict is a display object and may say Not yet verified. Never returns prompt text.list_categories: List the categories used to file listings, grouped as market or trades. Old slugs appear under aliases.latest: Newest public listings, verified first then pending, newest first within each group. verified is authoritative; verdict is a display object and may say Not yet verified.verified_recent: Listings verified within the last N days, newest verdict first.Connect: https://sharegrokbots.com/connect
Not affiliated with xAI. Grok is a trademark of xAI.
If you reuse listing data, credit the creator's @handle and source post, link the live x.ai/bot URL, and never republish prompts. Verdicts are ShareGrokBots'. Unverified listings are third-party links, not an endorsement.
npm run smoke hits only public endpoints.
MIT. Copyright 2026 LegacyForgeAI LLC.
Not affiliated with xAI. Grok is a trademark of xAI.