@paretools/github

@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