{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3n8swqzhg9pa","handle":"gh-mcp","url":"https://wellknown.network/agents/gh-mcp","links":{"self":"https://wellknown.network/agents/gh-mcp/record.json","html":"https://wellknown.network/agents/gh-mcp","markdown":"https://wellknown.network/agents/gh-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gh-mcp","status":"https://wellknown.network/api/v1/agents/gh-mcp/status","claim":"https://wellknown.network/agents/gh-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gh-mcp/claim.json","badge":"https://wellknown.network/agents/gh-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:gh-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gh-mcp","summary":"Refined MCP server for GitHub GraphQL API","description":"# Refined MCP server for GitHub\n\n> If you haven't read the article [The second wave of MCP: Building for LLMs, not developers](https://vercel.com/blog/the-second-wave-of-mcp-building-for-llms-not-developers) by Vercel, I highly recommend checking it out to understand why we're building this project.\n\n[GitHub's official MCP Server](https://github.com/github/github-mcp-server) exposes dozens of low-level tools that bloat token usage and are mostly impractical for LLMs. `gh-mcp` achieves the best of both worlds by providing powerful interfaces: GitHub GraphQL and Code Search, wrapped with smart abstractions.\n\nThis project does 3 things differently:\n\n1. **Powerful interfaces** — exposes GraphQL and Code Search instead of atomized endpoints. LLMs already understand these APIs.\n2. **YAML output** — makes nested data and file content readable without escaping.\n3. **Clean abstractions** — `gh` handles authentication and low-level details. And LLMs know how to use its `--jq` option to filter.\n\nSwapping in `gh-mcp` delivers better performance at lower cost for any GitHub interactions.\n\n## Installation\n\nwith uv:\n\n```sh\nuvx mcp-hmr\n```\n\nMCP config:\n\n```json\n{\n    \"mcpServers\": {\n        \"gh\": {\n            \"command\": \"uvx\",\n            \"args\": [\"gh-mcp\"]\n        }\n    }\n}\n```\n\nIf you prefer serving it via streamable-http:\n\n```sh\nuvx gh-mcp --http\n```\n\n> This project requires `gh` CLI to be installed and authenticated. Please follow the instructions at [cli.github.com](https://cli.github.com/) to set it up. And then you can login via `gh auth login`. Check that `gh auth status` works before using this MCP server.","publisher":null,"homepage":null,"repository":null,"version":"0.3.8","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:gh-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"gh-mcp","registry":"pypi","observedAt":"2026-09-09T16:25:25.493Z","publishedAt":"2026-08-28T21:36:51.263873Z","latestVersion":"0.3.8"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gh-mcp","url":"https://pypi.org/project/gh-mcp/","firstSeenAt":"2026-09-09T16:23:49.272Z","fetchedAt":"2026-09-09T16:23:49.272Z","normalizedAt":"2026-09-09T16:23:49.272Z"}]},"firstSeenAt":"2026-09-09T16:23:49.272Z","updatedAt":"2026-09-09T16:25:25.493Z"}