Bot Shelf MCP connector
Search Bot Shelf, an independent directory of 9,000+ community Grok Bots, from any MCP client. Describe a job in plain words and get bots that fit, each with its creator credited and a link that adds it in Grok.
https://mcp.botshelf.dev/mcp
Remote server over streamable HTTP. No account or API key needed. It's free and read-only, apart from suggesting a bot.
Tools
| Tool | What it does |
|---|---|
| find_bots | Finds bots for a job you describe in plain words, best match first, with a link that adds each one in Grok. |
| get_bot | One bot's full listing, from its x.ai/bot share link or its Bot Shelf page. |
| latest | The bots most recently added to Bot Shelf. |
| list_categories | The categories, with how many bots each has. |
| suggest_bot | Suggests a Grok Bot for Bot Shelf. A person reviews every suggestion before it's listed. |
Add it to Grok Bot
In Grok Bot's settings, add a custom connector named Bot Shelf with the address https://mcp.botshelf.dev/mcp. Then ask: "Find me a bot on Bot Shelf that chases unpaid invoices."
Full setup steps: botshelf.dev/connector
Add it to other MCP clients
{
"mcpServers": {
"bot-shelf": {
"type": "http",
"url": "https://mcp.botshelf.dev/mcp"
}
}
}
Add it as a skill
For Claude Code, Cursor, Codex and other agents that use skills:
npx skills add cradrrat/bot-shelf-mcp
The skill searches Bot Shelf through the connector, and falls back to plain HTTP when no MCP server is set up.
Add it to Hermes Agent
hermes plugins install cradrrat/bot-shelf-mcp --no-enable
hermes plugins enable bot-shelf
This repository is an Agent Plugins v1 package: plugin.json, mcp.json and skills/bot-shelf/SKILL.md, configuration only, with no code to run.
What it sends where
Every tool call goes to https://mcp.botshelf.dev/mcp, which Bot Shelf runs on Cloudflare. Searches and lookups only read the public directory. suggest_bot sends the link you give it, plus an optional note and name, to a review queue, where it's kept for up to 30 days until a person reviews it. Searches aren't stored. Cloudflare rate-limits calls by IP address, and Bot Shelf doesn't keep those addresses. No account, key or stored credential is involved.
Plain files
Prefer files to a connector? See botshelf.dev/llms.txt.
About
Bot Shelf is made by Nomis (@cradrrat). Bot listings belong to their creators. It isn't affiliated with xAI or X.
The connector's source code isn't published here. This repository is its public listing page, skill and Hermes plugin.
README from the reviewed commit 52547d5; it updates when the author re-pins.

cradrrat