oss-autopilot — Claude Code MCP server: PRs, issues, CI
An MCP server for contributing to other people's open source repos: it watches pull requests, hunts for issues and reads CI failures.
claude mcp add oss-autopilot -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @oss-autopilot/mcpWhat oss-autopilot does
The server hands your agent 30 tools, 6 resources and 4 prompts. You can check where your PRs stand, search GitHub for issues worth picking up, score a repo on a 1–10 health rubric, pull the comment thread on a pull request and draft a reply. Resources such as oss://prs and oss://pr/{owner}/{repo}/{number} feed context straight to the agent.
Both stdio and Streamable HTTP transports are supported. In HTTP mode the server writes a token to ~/.oss-autopilot/mcp.token on first start with 0600 permissions, and every request has to carry an Authorization: Bearer header. A non-loopback Host gets 403; a missing, non-numeric or oversized Content-Length gets 413. The token survives restarts — delete the file and restart to rotate it.
Node.js 22+ and an authenticated GitHub CLI are required. Skip gh auth login and anything that talks to GitHub stops working. Some tools write to your account: post leaves a comment, claim takes an issue, move shifts a PR between states. Call init with your GitHub username once before anything else — it writes ~/.oss-autopilot/state.json.
What it helps with
- see which pull requests are waiting on you
- find an issue you can actually patch
- size up a repo before writing code
- read a PR thread and draft a reply
- claim an issue with a comment
Example prompts for the agent
- Run
dailyand show me what needs attention - Use
searchto find a couple of Go issues I could help with - Pull the comments on my PR and draft a reply with
respond-to-pr
How to install oss-autopilot
Platform CLI
claude mcp add oss-autopilot -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @oss-autopilot/mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @oss-autopilot/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@oss-autopilot/mcp"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oss-autopilot/mcp"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> mcp-server npx -y @oss-autopilot/mcpReplace <…> 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 oss-autopilot
How do I install oss-autopilot in Claude Code?
Run claude mcp add oss-autopilot -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @oss-autopilot/mcp, replacing the token with your own.
What does oss-autopilot do?
It gives your agent tools for working on other people's repositories: PR tracking, issue search, a repo health score and comment review. It also ships prompts for triage and issue discovery.
What does the server need to run?
Node.js 22+ and an authenticated GitHub CLI. HTTP mode additionally expects the bearer token from ~/.oss-autopilot/mcp.token.
