@paretools/github

MCP server for GitHub — structured PR, issue, and Actions data for AI agents

latest

Source

npm

Version: 0.22.2

Version published: 6 days ago

Weekly downloads: 144

Maintainers: 1

Weekly downloads

Created: 6 months ago

Source

@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

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
`secret-set`	Set a repo, org, or environment GitHub Actions secret
`secret-list`	List secret names and metadata; values are never returned
`secret-delete`	Delete a repo, org, or environment GitHub Actions secret
`variable-set`	Set a repo, org, or environment GitHub Actions variable
`variable-list`	List variable names, values, and metadata
`variable-delete`	Delete a repo, org, or environment GitHub Actions variable

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
}

secret-set input:

{
  "name": "MAXMIND_LICENSE_KEY",
  "value": "license-key-value",
  "repo": "owner/repo"
}

Secret values are sent to gh secret set via stdin and are not returned in structured output. For organization scope, pass org and optional visibility / repos; for environment scope, pass repo and env.

variable-list output:

{
  "scope": "repo",
  "variables": [
    {
      "name": "PUBLIC_URL",
      "value": "https://example.com",
      "updatedAt": "2026-01-01T00:00:00Z"
    }
  ]
}