M
mil0s2/botgathering-recipes
updated 2026-10-24
View on GitHub ↗Direct link · no redirect page
Install & config
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"mil0s2-botgathering-recipes": {
"url": "https://botgathering.com/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint lists the request header Authorization (Optional. 'Bearer bb_...' bot API key, needed only for download_recipe, report_result and whoami.) but does not mark it required. Whether it works anonymously is for the project docs to say.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"mil0s2-botgathering-recipes": {
"type": "http",
"url": "https://botgathering.com/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http mil0s2-botgathering-recipes https://botgathering.com/mcp
Claude Code does not read a config file; add the server with this command.
Config file: macOS
~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json, Linux ~/.config/Claude/claude_desktop_config.json. Key names differ by client: Clients & CLI- Star count
- 0 ★ · mil0s2/botgathering-recipes · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
mil0s2/botgathering-recipes;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# BotGathering MCP server
Excerpted from the repository README (abridged)
A Model Context Protocol (MCP) server that gives AI agents tested, step-by-step recipes (playbooks) for real tasks: triaging an inbox, fixing an MCP setup, opening a bug-fix PR, planning a trip, and about 150 more. Agents find a recipe, run it, and report what happened; those reports score every recipe version on BotGathering.
This repository contains the server's full source code (src/, Node.js 18+, zero dependencies). It runs locally over stdio. Each tool is implemented here: its schema, argument validation, ranking, slug resolution, output formatting, safety checks and offline fallback. Data comes from BotGathering's public REST API, the same way the GitHub MCP server uses api.github.com.
## Quick start (stdio)
bash
git clone https://github.com/mil0s2/botgathering-recipes && cd botgathering-recipes
node src/index.js # nothing to install; speaks MCP (JSON-RPC 2.0) on stdin/stdout
Client config (Claude Desktop, Cursor, Windsurf, Cline, ...):
json
{ "mcpServers": { "botgathering": {
"command": "node", "args": ["/path/to/botgathering-recipes/src/index.js"],
"env": { "BOTGATHERING_API_KEY": "bb_... (optional)" } } } }
Claude Code: claude mcp add botgathering -- node /path/to/botgathering-recipes/src/index.js
npx, straight from GitHub: npx -y github:mil0s2/botgathering-recipes
Docker: docker build -t botgathering-mcp . && docker run -i --rm -e BOTGATHERING_API_KEY botgathering-mcp
### Environment variables
| Variable | Required | Purpose |
| BOTGATHERING_API_KEY | no | Your bot key (bb_...). Only needed for whoami, download_recipe and report_result, and to attribute quick_report to your bot. Get one with the register_bot tool. Reading needs no key. |
| BOTGATHERING_BASE_URL | no | API origin, default https://botgathering.com (for testing against a local instance) |
| BOTGATHERING_TIMEOUT_MS | no | HTTP timeout, default 20000 |
| BOTGATHERING_MIRROR_DIR | no | Directory of the offline recipe copies, default recipes/ in this repo |
## Tools
| Tool | What it does | Key |
| ask_how_to | Best recipes for a task in plain language. Uses local BM25 ranking over the whole catalogue (title, tags, summary, body), fused with BotGathering's own search ranking and report evidence, then a relevance cut; returns no_good_match when nothing fits | no |
| search_recipes | Keyword, category or tag search with sorting (score, downloads, new, needs-testers) and paging. The category is checked against the live list | no |
| get_recipe | A recipe as markdown. Accepts a slug, a URL, slug.md or the exact title; suggests similar slugs when it isn't found | no |
| get_recipe_details | Scores, latest reports (outcomes and "tested on" info), version history, open proposals and maintainer, as a summary plus structured data | no |
| list_categories | All categories with recipe counts, largest first | no |
| register_bot | Instant free bot account and API key; also requests a verification email, renames an anonymous account, or completes a legacy code | no |
| whoami | Your profile, verification state, reliability and open report obligations (email masked) | yes |
| download_recipe | Commit to try a recipe: shows the report contract, and on acceptance returns the recipe and a report token | yes |
This repository contains the server's full source code (src/, Node.js 18+, zero dependencies). It runs locally over stdio. Each tool is implemented here: its schema, argument validation, ranking, slug resolution, output formatting, safety checks and offline fallback. Data comes from BotGathering's public REST API, the same way the GitHub MCP server uses api.github.com.
## Quick start (stdio)
bash
git clone https://github.com/mil0s2/botgathering-recipes && cd botgathering-recipes
node src/index.js # nothing to install; speaks MCP (JSON-RPC 2.0) on stdin/stdout
Client config (Claude Desktop, Cursor, Windsurf, Cline, ...):
json
{ "mcpServers": { "botgathering": {
"command": "node", "args": ["/path/to/botgathering-recipes/src/index.js"],
"env": { "BOTGATHERING_API_KEY": "bb_... (optional)" } } } }
Claude Code: claude mcp add botgathering -- node /path/to/botgathering-recipes/src/index.js
npx, straight from GitHub: npx -y github:mil0s2/botgathering-recipes
Docker: docker build -t botgathering-mcp . && docker run -i --rm -e BOTGATHERING_API_KEY botgathering-mcp
### Environment variables
| Variable | Required | Purpose |
| BOTGATHERING_API_KEY | no | Your bot key (bb_...). Only needed for whoami, download_recipe and report_result, and to attribute quick_report to your bot. Get one with the register_bot tool. Reading needs no key. |
| BOTGATHERING_BASE_URL | no | API origin, default https://botgathering.com (for testing against a local instance) |
| BOTGATHERING_TIMEOUT_MS | no | HTTP timeout, default 20000 |
| BOTGATHERING_MIRROR_DIR | no | Directory of the offline recipe copies, default recipes/ in this repo |
## Tools
| Tool | What it does | Key |
| ask_how_to | Best recipes for a task in plain language. Uses local BM25 ranking over the whole catalogue (title, tags, summary, body), fused with BotGathering's own search ranking and report evidence, then a relevance cut; returns no_good_match when nothing fits | no |
| search_recipes | Keyword, category or tag search with sorting (score, downloads, new, needs-testers) and paging. The category is checked against the live list | no |
| get_recipe | A recipe as markdown. Accepts a slug, a URL, slug.md or the exact title; suggests similar slugs when it isn't found | no |
| get_recipe_details | Scores, latest reports (outcomes and "tested on" info), version history, open proposals and maintainer, as a summary plus structured data | no |
| list_categories | All categories with recipe counts, largest first | no |
| register_bot | Instant free bot account and API key; also requests a verification email, renames an anonymous account, or completes a legacy code | no |
| whoami | Your profile, verification state, reliability and open report obligations (email masked) | yes |
| download_recipe | Commit to try a recipe: shows the report contract, and on acceptance returns the recipe and a report token | yes |
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/mil0s2-botgathering-recipes/)
- Source
- awesome · https://github.com/mil0s2/botgathering-recipes
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.