Talk to your GitHub repos, issues, and project boards in plain English from your terminal
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"github-mcp-agent","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# GitHub MCP Agent Talk to your GitHub repos, issues, and project boards in plain English from your terminal.  ``` You > list open issues in my raytracer repo You > set priority of issue #42 to urgent You > what's in progress on the project board? You > which issues are assigned to maryam? ``` --- ## Install ```bash pip install github-mcp-agent ``` Or with uv: ```bash uv tool install github-mcp-agent ``` --- ## Setup ```bash github-agent setup ``` Interactive wizard: 1. GitHub token (validated immediately) 2. AI provider — choose one: - **AWS Bedrock** — existing profile, access keys, or SSO - **Anthropic API** — API key from console.anthropic.com - **OpenAI** — API key from platform.openai.com - **Google Gemini** — API key from aistudio.google.com - **GitHub Copilot** — browser OAuth flow, requires a Copilot subscription - **Local (Ollama)** — picks from your installed models, no API key needed 3. Model selection (scrollable menu) 4. Pulls the GitHub MCP Docker image Config saved to `~/.config/github-mcp-agent/.env`. --- ## Usage ```bash github-agent # start the agent github-agent setup # full setup wizard github-agent provider # switch AI provider and model github-agent model # switch model within current provider github-agent token # update GitHub token github-agent config # edit config file in $EDITOR github-agent prompt # customize the system prompt in $EDITOR github-agent -v # start with verbose tool output ``` --- ## Requirements | Requirement | Notes | |---|---| | Python 3.10+ | | | Docker | Must be running — used for the GitHub MCP server | | GitHub token | Scopes: `repo`, `read:org`, `project` — [github.com/settings/tokens](https://github.com/settings/tokens) | | Provider credentials | See setup wizard | **For AWS Bedrock:** enable Claude model access in the [Bedrock console](https://console.aws.amazon.com/bedrock) under Model acces…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.