@paretools/github

Structured, token-efficient GitHub operations for AI agents. Wraps the GitHub CLI (gh) with typed JSON output.

Part of the Pare suite of MCP servers.

Tools (8)

| Tool | Description | | -------------- | -------------------------------------------------------- | | pr-view | View PR details with checks, review decision, diff stats | | pr-list | List PRs with state/author/label filters | | pr-create | Create a pull request with title, body, base/head | | issue-view | View issue details with labels, assignees, body | | issue-list | List issues with state/label/assignee filters | | issue-create | Create an issue with title, body, labels | | run-view | View workflow run details with job statuses | | run-list | List workflow runs with branch/status filters |

Quick Start

npx -y @paretools/github

Add to your MCP client config:

{
  "mcpServers": {
    "pare-github": {
      "command": "npx",
      "args": ["-y", "@paretools/github"]
    }
  }
}

Example

pr-view output:

{
  "number": 42,
  "state": "OPEN",
  "title": "Add search functionality",
  "mergeable": "MERGEABLE",
  "reviewDecision": "APPROVED",
  "checks": [{ "name": "CI", "status": "COMPLETED", "conclusion": "SUCCESS" }],
  "url": "https://github.com/owner/repo/pull/42",
  "headBranch": "feat/search",
  "baseBranch": "main",
  "additions": 150,
  "deletions": 20,
  "changedFiles": 5
}

Prerequisites

• GitHub CLI (gh) installed and authenticated (gh auth login)

Compatible Clients

Works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code / GitHub Copilot, Cline, Roo Code, Zed, Continue.dev, Gemini CLI, OpenAI Codex

Links

• Pare monorepo
• MCP protocol

License

MIT