Can it monitor pull requests after submission?

Yes. Its status heartbeat classifies submitted pull requests, including needs-rebase, CI-failing, stale-review, stale-without-review, clean, and waiting states.

Does PR Genius write pull requests?

No. It provides contribution advice, risk analysis, policy checks, and optimization suggestions rather than writing pull requests.

How can it run as an MCP server?

Install the prgenius-core package and run `python -m prgenius mcp serve`.

Can it monitor pull requests after submission?

Yes. Its status heartbeat classifies submitted pull requests, including needs-rebase, CI-failing, stale-review, stale-without-review, clean, and waiting states.

Does PR Genius write pull requests?

No. It provides contribution advice, risk analysis, policy checks, and optimization suggestions rather than writing pull requests.

How can it run as an MCP server?

Install the prgenius-core package and run `python -m prgenius mcp serve`.

Pr Genius

pull-requestsgithubdeveloper-toolsopen-sourceversion-control

Analyzes open-source pull requests using repository policies, historical patterns, and merge-risk signals.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "zsxh1990-pr-genius": {
      "command": "uvx",
      "args": [
        "prgenius-core"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Overview

PR Genius advises contributors before and after submitting pull requests to large open-source repositories. It evaluates titles, descriptions, repository policies, diff information, and historical case patterns to suggest whether to proceed and what to improve. It also supports monitoring submitted PRs for states such as stale review, failing CI, or needing a rebase.

Use cases

Analyze a pull request’s merge probability and risk

Coach a proposed pull request with a pass/fail recommendation

Triage changes against repository-specific maintainer policies

Search historical success and anti-pattern cases

Monitor submitted pull requests for stale or failing states

Key features

Merge probability analysis with three-tier risk levels

Pass/fail contribution coaching

Repository profile and policy checks

Historical case-study and pattern search

Pull request status classification and action suggestions

MCP server and GitHub Action support

Capabilities & Tool Schemas (8)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Pr Genius.

title

Callable MCP tool function

analyze_pr

Callable MCP tool function

coach_pr

Callable MCP tool function

triage_pr

Callable MCP tool function

repo

Callable MCP tool function

pr_description

Callable MCP tool function

Documentation Overview

type: Knowledge Bundle title: PR Genius — Pre-submission PR Advisor description: Evidence-backed PR contribution advisor for large open-source projects version: 1.4.0 created: 2026-07-01 updated: 2026-07-22 author: zsxh1990 conforms_to: OKF v0.1 (Sudhakaran88/okf-conformance) + agent_guidelines extension

mcp-name: io.github.zsxh1990/pr-genius

PR Genius — The advisor that knows which PRs get closed

1355 loaded patterns across 61 repos. 100% quality pass rate. Clone → paste MCP config → ask "Should I open this PR to encode/httpx?"

🎯 What is PR Genius?

PR Genius is not a PR dashboard. It's an Outbound PR CRM for professional OSS contributors and AI agents:

Manage PRs you've submitted to other repos — when to fix CI, rebase, wait, ping, or abandon.

Capability	`gh` CLI	PR Genius
Cross-repo PR list	✅	✅
Status classification	❌	✅ (9 states)
Stale detection	❌	✅
Action suggestions	❌	✅
Repo-specific policy	❌	✅
Snapshot & transitions	❌	✅

Status heartbeat runs daily via cron, auto-detecting:

🔴 NEEDS_REBASE / CI_FAILING — fix immediately
🟡 STALE_REVIEW — ping after threshold
🟡 STALE_NO_REVIEW — consider abandoning
🟢 CLEAN / WAITING — continue waiting

🛡️ Why PR Genius?

PR Genius doesn't write PRs for you. It knows which PRs get closed.

Capability	LLM directly	Scraper Agent	PR Genius
Knowledge source	Training data	Real-time scrape	1355 structured patterns
Repo understanding	Generic	Surface data (stars)	17-field agent_guidelines
Failure patterns	Unknown	Unknown	752 anti-patterns
Success patterns	Unknown	Unknown	703 success patterns
Maintainer preference	Guess	Recent PRs	Structured policy files
Merge probability	Can't estimate	Can't estimate	Based on repo merge rate + signals

Real cases (PR Genius helped avoid these rejections):

PR	Repo	What happened	PR Genius would have flagged
#491	MisakaNet	"Destructive README rewrite" — closed	`breaking_change_no_compat` anti-pattern
#47434	huggingface/transformers	"We'll handle internally" — closed	`maintainer_internal_handling` anti-pattern
#10393	awesome-mcp-servers	Missing Glama badge — auto-flagged	`awesome-mcp-servers-glama-badge-required` anti-pattern
#282	punkpeye/fastmcp	+271 lines, first PR — closed without review	`fastmcp-282-too-large` anti-pattern
#2902	soxoj/maigret	CI failure (tag `dev` not recognized) — fixed, merged	`maigret-tag-validation` pattern

🚀 Quick Start

Terminal

pip install prgenius-core

# Analyze PR
python3 -m prgenius analyze "feat: add feature" --repo org/repo --body "Fixes #123"

# Coach (pass/fail)
python3 -m prgenius coach "feat: add feature" --repo org/repo

# Triage (policy check)
python3 -m prgenius triage "docs: typo" --repo org/repo --diff-stat "docs/faq.md | 3 ++-"

# Status heartbeat (outbound PR monitoring)
python3 -m prgenius status --author zsxh1990
python3 -m prgenius status --author zsxh1990 --format json --save-snapshot

# Profile writeback suggestions (dry-run)
python3 -m prgenius profile writeback --author zsxh1990

🤖 GitHub Action

Use PR Genius as a GitHub Action in any repo:

server.ts

# .github/workflows/pr-genius.yml
name: PR Genius Check
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  pr-genius:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: zsxh1990/pr-genius/.github/actions/pr-genius-check@main
        id: pr-genius
        with:
          title: ${{ github.event.pull_request.title }}
          repo: ${{ github.repository }}
          body: ${{ github.event.pull_request.body }}
      - name: Comment on PR
        if: always()
        uses: actions/github-script@v7
        with:
          script: |
            const tier = '${{ steps.pr-genius.outputs.tier }}';
            const emoji = tier === 'high_risk' ? '🔴' : tier === 'medium_risk' ? '🟡' : '🟢';
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## ${emoji} PR Genius: ${tier}`
            });

🤖 MCP Configuration

config.json

{
  "mcpServers": {
    "pr-genius": {
      "command": "python",
      "args": ["-m", "prgenius", "mcp", "serve"]
    }
  }
}

Docker: docker run --rm -i ghcr.io/zsxh1990/pr-genius:1.3.0

8 MCP Tools

Tool	Purpose	Required Args
`analyze_pr`	Merge probability + optimization path + 3-tier risk	`title`, `repo`
`coach_pr`	Go/no-go decision (pass/fail)	`title`, `repo`
`triage_pr`	Maintainer policy check (9 rules)	`title`, `repo`
`get_repo_profile`	Repo profile (17 fields)	`repo`
`list_open_prs`	Open PR list	`repo`
`get_case_study`	PR case study details	`case_id`
`search_patterns`	Anti-pattern/success-pattern search	`query`
`schema_info`	OKF schema versions	(none)

Tool Parameter Notes

title (required for analyze_pr, coach_pr, triage_pr): The PR title, e.g. "fix: timeout in connection pool"
repo (required for most tools): Repository in owner/name format, e.g. "encode/httpx"
pr_description (optional): Additional PR body text for deeper analysis
query (required for search_patterns): Search keywords, e.g. "connection timeout"

📊 Data Scale

Dimension	Count
Repo profiles	61
Case studies	50+
Success patterns	687 (431 .md + 256 .json)
Anti-patterns	668 (561 .md + 107 .json)
Total patterns	1355 (all loaded)
Quality pass rate	100% (994/994 markdown ≥75分)
Covered repos	35+ (react, kubernetes, rust, uv, pydantic, etc.)

按仓库规模分布

规模	Success	Anti	总计
大仓 (>10k ⭐)	208	205	413
中仓 (1k-10k ⭐)	169	88	257
小仓 (<1k ⭐)	169	88	257
通用	203	414	617
其他 (特定仓库)	312	260	572

🤖 Robots / Agents

docs/index.md — file map
AGENT_GUIDELINES_SCHEMA.md — agent_guidelines schema
ROUNDS_SCHEMA.md — rounds schema
BLACKLIST.md — repos we don't track

📖 Contributing

See CONTRIBUTING.md. AI-assisted PRs welcome.

🤝 Community

中文文档

中文版 README：README.zh-CN.md

Citation

bibtex

@misc{pr-genius-2026,
  title  = {PR Genius — Evidence-backed PR Contribution Advisor},
  author = {zsxh1990},
  year   = {2026},
  url    = {https://github.com/zsxh1990/pr-genius}
}

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Frequently Asked Questions about Pr Genius

It analyzes pull request titles, repositories, descriptions, and, for triage, diff statistics against repository-specific policies and historical patterns.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/zsxh1990-pr-genius?style=directory)](https://allmcps.com/mcp/zsxh1990-pr-genius)

HTML Embed

<a href="https://allmcps.com/mcp/zsxh1990-pr-genius"><img src="https://allmcps.com/api/badge/zsxh1990-pr-genius?style=directory" alt="Pr Genius on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

57Quality signal: Good · 57/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Pr Genius →Install in Claude Desktop Install in Cursor Install in VS Code

Pr Genius

pull-requestsgithubdeveloper-toolsopen-sourceversion-control

Analyzes open-source pull requests using repository policies, historical patterns, and merge-risk signals.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "zsxh1990-pr-genius": {
      "command": "uvx",
      "args": [
        "prgenius-core"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Overview

Use cases

Analyze a pull request’s merge probability and risk

Coach a proposed pull request with a pass/fail recommendation

Triage changes against repository-specific maintainer policies

Search historical success and anti-pattern cases

Monitor submitted pull requests for stale or failing states

Key features

Merge probability analysis with three-tier risk levels

Pass/fail contribution coaching

Repository profile and policy checks

Historical case-study and pattern search

Pull request status classification and action suggestions

MCP server and GitHub Action support

Capabilities & Tool Schemas (8)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Pr Genius.

title

Callable MCP tool function

analyze_pr

Callable MCP tool function

coach_pr

Callable MCP tool function

triage_pr

Callable MCP tool function

repo

Callable MCP tool function

pr_description

Callable MCP tool function

Documentation Overview

type: Knowledge Bundle title: PR Genius — Pre-submission PR Advisor description: Evidence-backed PR contribution advisor for large open-source projects version: 1.4.0 created: 2026-07-01 updated: 2026-07-22 author: zsxh1990 conforms_to: OKF v0.1 (Sudhakaran88/okf-conformance) + agent_guidelines extension

mcp-name: io.github.zsxh1990/pr-genius

PR Genius — The advisor that knows which PRs get closed

1355 loaded patterns across 61 repos. 100% quality pass rate. Clone → paste MCP config → ask "Should I open this PR to encode/httpx?"

🎯 What is PR Genius?

PR Genius is not a PR dashboard. It's an Outbound PR CRM for professional OSS contributors and AI agents:

Manage PRs you've submitted to other repos — when to fix CI, rebase, wait, ping, or abandon.

Capability	`gh` CLI	PR Genius
Cross-repo PR list	✅	✅
Status classification	❌	✅ (9 states)
Stale detection	❌	✅
Action suggestions	❌	✅
Repo-specific policy	❌	✅
Snapshot & transitions	❌	✅

Status heartbeat runs daily via cron, auto-detecting:

🔴 NEEDS_REBASE / CI_FAILING — fix immediately
🟡 STALE_REVIEW — ping after threshold
🟡 STALE_NO_REVIEW — consider abandoning
🟢 CLEAN / WAITING — continue waiting

🛡️ Why PR Genius?

PR Genius doesn't write PRs for you. It knows which PRs get closed.

Capability	LLM directly	Scraper Agent	PR Genius
Knowledge source	Training data	Real-time scrape	1355 structured patterns
Repo understanding	Generic	Surface data (stars)	17-field agent_guidelines
Failure patterns	Unknown	Unknown	752 anti-patterns
Success patterns	Unknown	Unknown	703 success patterns
Maintainer preference	Guess	Recent PRs	Structured policy files
Merge probability	Can't estimate	Can't estimate	Based on repo merge rate + signals

Real cases (PR Genius helped avoid these rejections):

PR	Repo	What happened	PR Genius would have flagged
#491	MisakaNet	"Destructive README rewrite" — closed	`breaking_change_no_compat` anti-pattern
#47434	huggingface/transformers	"We'll handle internally" — closed	`maintainer_internal_handling` anti-pattern
#10393	awesome-mcp-servers	Missing Glama badge — auto-flagged	`awesome-mcp-servers-glama-badge-required` anti-pattern
#282	punkpeye/fastmcp	+271 lines, first PR — closed without review	`fastmcp-282-too-large` anti-pattern
#2902	soxoj/maigret	CI failure (tag `dev` not recognized) — fixed, merged	`maigret-tag-validation` pattern

🚀 Quick Start

Terminal

pip install prgenius-core

# Analyze PR
python3 -m prgenius analyze "feat: add feature" --repo org/repo --body "Fixes #123"

# Coach (pass/fail)
python3 -m prgenius coach "feat: add feature" --repo org/repo

# Triage (policy check)
python3 -m prgenius triage "docs: typo" --repo org/repo --diff-stat "docs/faq.md | 3 ++-"

# Status heartbeat (outbound PR monitoring)
python3 -m prgenius status --author zsxh1990
python3 -m prgenius status --author zsxh1990 --format json --save-snapshot

# Profile writeback suggestions (dry-run)
python3 -m prgenius profile writeback --author zsxh1990

🤖 GitHub Action

Use PR Genius as a GitHub Action in any repo:

server.ts

# .github/workflows/pr-genius.yml
name: PR Genius Check
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  pr-genius:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: zsxh1990/pr-genius/.github/actions/pr-genius-check@main
        id: pr-genius
        with:
          title: ${{ github.event.pull_request.title }}
          repo: ${{ github.repository }}
          body: ${{ github.event.pull_request.body }}
      - name: Comment on PR
        if: always()
        uses: actions/github-script@v7
        with:
          script: |
            const tier = '${{ steps.pr-genius.outputs.tier }}';
            const emoji = tier === 'high_risk' ? '🔴' : tier === 'medium_risk' ? '🟡' : '🟢';
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `## ${emoji} PR Genius: ${tier}`
            });

🤖 MCP Configuration

config.json

{
  "mcpServers": {
    "pr-genius": {
      "command": "python",
      "args": ["-m", "prgenius", "mcp", "serve"]
    }
  }
}

Docker: docker run --rm -i ghcr.io/zsxh1990/pr-genius:1.3.0

8 MCP Tools

Tool	Purpose	Required Args
`analyze_pr`	Merge probability + optimization path + 3-tier risk	`title`, `repo`
`coach_pr`	Go/no-go decision (pass/fail)	`title`, `repo`
`triage_pr`	Maintainer policy check (9 rules)	`title`, `repo`
`get_repo_profile`	Repo profile (17 fields)	`repo`
`list_open_prs`	Open PR list	`repo`
`get_case_study`	PR case study details	`case_id`
`search_patterns`	Anti-pattern/success-pattern search	`query`
`schema_info`	OKF schema versions	(none)

Tool Parameter Notes

title (required for analyze_pr, coach_pr, triage_pr): The PR title, e.g. "fix: timeout in connection pool"
repo (required for most tools): Repository in owner/name format, e.g. "encode/httpx"
pr_description (optional): Additional PR body text for deeper analysis
query (required for search_patterns): Search keywords, e.g. "connection timeout"

📊 Data Scale

Dimension	Count
Repo profiles	61
Case studies	50+
Success patterns	687 (431 .md + 256 .json)
Anti-patterns	668 (561 .md + 107 .json)
Total patterns	1355 (all loaded)
Quality pass rate	100% (994/994 markdown ≥75分)
Covered repos	35+ (react, kubernetes, rust, uv, pydantic, etc.)

按仓库规模分布

规模	Success	Anti	总计
大仓 (>10k ⭐)	208	205	413
中仓 (1k-10k ⭐)	169	88	257
小仓 (<1k ⭐)	169	88	257
通用	203	414	617
其他 (特定仓库)	312	260	572

🤖 Robots / Agents

docs/index.md — file map
AGENT_GUIDELINES_SCHEMA.md — agent_guidelines schema
ROUNDS_SCHEMA.md — rounds schema
BLACKLIST.md — repos we don't track

📖 Contributing

See CONTRIBUTING.md. AI-assisted PRs welcome.

🤝 Community

中文文档

中文版 README：README.zh-CN.md

Citation

bibtex

@misc{pr-genius-2026,
  title  = {PR Genius — Evidence-backed PR Contribution Advisor},
  author = {zsxh1990},
  year   = {2026},
  url    = {https://github.com/zsxh1990/pr-genius}
}

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Frequently Asked Questions about Pr Genius

It analyzes pull request titles, repositories, descriptions, and, for triage, diff statistics against repository-specific policies and historical patterns.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/zsxh1990-pr-genius?style=directory)](https://allmcps.com/mcp/zsxh1990-pr-genius)

HTML Embed

<a href="https://allmcps.com/mcp/zsxh1990-pr-genius"><img src="https://allmcps.com/api/badge/zsxh1990-pr-genius?style=directory" alt="Pr Genius on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

57Quality signal: Good · 57/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity5/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Pr Genius →Install in Claude Desktop Install in Cursor Install in VS Code