FixYourDocs — Claude Code MCP server: what it does, how to install
Submits structured bug and clarity reports on broken docs straight to repository owners.
claude mcp add --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> --transport stdio mcp-server -- npx -y @fixyourdocs/mcp-serverWhat FixYourDocs does
The package exposes a single MCP tool named file_doc_feedback. When an AI assistant spots an outdated API guide, a dead link, or confusing instructions, it drafts a structured report following Docs Feedback Protocol v0. The payload reaches hub.fixyourdocs.io, which then files an issue on the doc owner's GitHub repository if they enabled the service.
Inputs include the problematic page URL, agent metadata, an issue category, and a summary under 280 characters. You can also append an optional suggestion. The local server checks constraints like string lengths before making external network calls.
This API is strictly write-only. It returns a confirmation ULID, meaning agents cannot query previously filed items back through the protocol.
What it helps with
- report broken documentation links directly from the coding terminal
- notify library maintainers about outdated code examples automatically
- submit structured documentation fixes without opening GitHub in a browser
Example prompts for the agent
- Use file_doc_feedback to report that the guide on docsfeedback.org is missing parameters
- File a feedback report with kind outdated for the selected documentation link
- Send a suggested fix via file_doc_feedback regarding the unclear setup step
How to install FixYourDocs
Platform CLI
claude mcp add --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> --transport stdio mcp-server -- npx -y @fixyourdocs/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> -- npx -y @fixyourdocs/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@fixyourdocs/mcp-server"
],
"env": {
"FIXYOURDOCS_HUB_URL": "<FIXYOURDOCS_HUB_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@fixyourdocs/mcp-server"
],
"env": {
"FIXYOURDOCS_HUB_URL": "<FIXYOURDOCS_HUB_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FIXYOURDOCS_HUB_URL=<FIXYOURDOCS_HUB_URL> mcp-server npx -y @fixyourdocs/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FixYourDocs
How to install FixYourDocs in Claude Code?
Run claude mcp add mcp-server -- npx -y @fixyourdocs/mcp-server in your terminal. The tool registers over stdio immediately.
What does FixYourDocs do?
It gives models a dedicated tool to report documentation flaws, turning agent findings into GitHub Issues for maintainers.
Does the server collect telemetry?
No background tracking exists. The process makes outgoing network calls solely when an agent deliberately invokes the reporting tool.
