freebuff-mcp-server
MCP server that lets any MCP client (VS Code, Copilot Chat, etc.) drive the Freebuff coding agent — with persisted sessions, transcripts, and a safe read-only default agent.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
RNK-Enterprise
Source: github_repo_search
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
freebuff_runRun the Freebuff coding agent on a prompt, inside a workspace folder. By default runs the built-in read-only 'freebuff-ask' agent, which can read files, search code, and answer questions but cannot modify anything — safe for codebase Q&A. Pass agent: 'codebuff/base@0.0.16' to let the agent edit fil…
freebuff_statusCheck whether the Freebuff MCP server has valid credentials and can reach the agent backend.
freebuff_deleteDelete a Freebuff agent session by id — from memory and disk. Returns error if the id is unknown. The transcript resource for a deleted session disappears; active runs must be cancelled (freebuff_stop) before deleting their session.
freebuff_stopCancel the currently running Freebuff agent session, if any.
freebuff_sessionsList Freebuff agent sessions known to this server (memory + persisted on disk).
CODEBUFF_API_KEY2. FREEBUFF_API_KEY or environment variableCODEBUFF_CONFIG_DIRFREEBUFF_API_KEY2. or CODEBUFF_API_KEY environment variableFREEBUFF_MCP_DIROverride with (directory) — the test suite uses thisXDG_CONFIG_HOMETool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
5/5 tools missing one or more hints — freebuff_run (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); freebuff_status (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); freebuff_delete (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +2 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Destructive tools are labelled
2 tools perform destructive updates without destructiveHint — freebuff_run deletes at line 311 (fs.unlinkSync(tmp)); freebuff_delete deletes at line 406 (fs.unlinkSync(file))
Add destructiveHint:true to any tool whose handler calls .delete(), .upsert(), .update(), unlink, rm, DELETE, DROP, REPLACE INTO, or any operation that overwrites existing data.
Descriptions match behaviour
2 tools describe read intent but their handlers mutate — freebuff_status (line 238: fs.mkdirSync(SESSIONS_DIR, { recursive: true })); freebuff_sessions (line 238: fs.mkdirSync(SESSIONS_DIR, { recursive: true }))
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
4/5 tool handlers declare input schemas (80%)
Declare an inputSchema with zod/joi/yup on every tool definition.
License file
No license file
Add a LICENSE file (MIT, Apache-2.0, etc.).
Tool description accuracy
freebuff_status: description implies read-only but handler writes/deletes/executes; freebuff_sessions: description implies read-only but handler writes/deletes/executes
Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/rnk-enterprise/freebuff-mcp-server)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check