gitranks

GitRanks Contribute

Community gitranks
Updated

Find open-source GitHub issues matched to your skills, fix one with your agent, and approve the pull request yourself.

GitRanks Contribute

Find open-source GitHub issues to contribute to, matched to your skills and checked ready for a pull request. Youragent fixes one; you review the change and approve the pull request ongitranks.com, and it opens under yourname.Every pull request opened from gitranks.com says it was made with GitRanks Contribute and your agent (with its modelwhen the agent reports one), and links where maintainers can tell us something is off or opt out.

In Claude Code: install the plugin with one command, sign in once on gitranks.com, then ask for an open-source issue and get your picks

This repository connects your own agent (Claude Code, Codex, Cursor, Gemini CLI and others) to the GitRanks ContributeMCP server at https://mcp.gitranks.com/mcp, and adds a contribute skill that walks it through one issue. It holdsonly configuration and instructions: the server runs on GitRanks.

GitRanks Contribute is in beta. It is free.

How you connect

Add the server's URL to your agent, then sign in from it. Your agent opens gitranks.com in your browser: sign in withGitHub, check what the agent will be able to do, and press Allow. Your agent keeps the access it gets and renews itby itself while you use it. Nobody copies a token.

Each agent you connect is listed on gitranks.com under Contribute → Settings → Your own agent (MCP), where you candisconnect it at any time.

A client that can't sign in can still use a personal token: see Use a token instead.

Install

One click, then confirm in your client and sign in on gitranks.com when it asks:

Each link opens the client's own add-server dialog with the URL filled in; nothing is added until you confirm it there.The setup line for every other client is below. Whichever client you use, the same limits keep itfair to maintainers.

Claude Code

claude plugin marketplace add gitranks/contribute
claude plugin install gitranks-contribute@gitranks

On Claude Code 2.1.292 or later, one line does both:claude plugin install gitranks-contribute --marketplace gitranks/contribute.

Then run /mcp, pick plugin:gitranks-contribute:gitranks, choose Authenticate and sign in on gitranks.com.

Without the plugin: claude mcp add --scope user --transport http gitranks https://mcp.gitranks.com/mcp, then /mcp → gitranks →Authenticate.

Claude Desktop and claude.ai

Use the Add to Claude linkabove, or by hand: Customize → Connectors → Add → Add custom connector, name GitRanks Contribute, URLhttps://mcp.gitranks.com/mcp. Then Connect it and sign in on gitranks.com.

ChatGPT

On chatgpt.com/plugins, press + and choose Add custom MCP server. Name itGitRanks Contribute, paste https://mcp.gitranks.com/mcp and set authentication to OAuth. Confirm the warningwith I understand and want to continue, press Create as a plugin, then install it. ChatGPT asks you to sign in:your browser opens GitRanks, where you allow it. Then start a new chat and pick it with @.

In ChatGPT, on the web, desktop or your phone, you can find, claim and track issues. The fix needs Codex or anotheragent that can run a shell, signed in to the same account: it picks up your claim.

Gemini CLI

gemini extensions install https://github.com/gitranks/contribute

Then run /mcp auth gitranks and sign in on gitranks.com.

Without the extension: gemini mcp add --scope user --transport http gitranks https://mcp.gitranks.com/mcp, then/mcp auth gitranks.

Codex

Codex can work on open-source issues picked for your skills, and you review every change before a pull request opensin your name. The work runs on your ChatGPT plan. GitRanks picks the issue, briefs Codex on it, checks the patch andopens the pull request you approve; it runs no model for you.

  1. Add GitRanks:

    codex mcp add gitranks --url https://mcp.gitranks.com/mcp
    
  2. Sign in: codex mcp login gitranks opens gitranks.com. Sign in with GitHub and press Allow. There's no token tocopy.

  3. Ask Codex: "Find me an open-source issue to work on with GitRanks." Codex calls find_issues and lists issuespicked for you. For the one you choose it calls claim_issue, which holds it for you and returns the repository'srules and how to test. Codex then works on a fresh clone and hands the commits back with submit_patch.

  4. Review on gitranks.com: look at the diff, the checks and the pull request text, then approve, send it back with anote, or discard it. The pull request opens from your fork, in your name, and says it was made with AI. The firsttime, gitranks.com asks for GitHub access to fork the repository and open the pull request.

Or, instead of steps 1 and 2, the plugin, which adds the skill too: this repository is a Codex plugin marketplace.Run codex plugin marketplace add gitranks/contribute, then install GitRanks Contribute from /plugins in Codex (orthe Plugins Directory in the ChatGPT desktop app) and sign in on gitranks.com when it asks.

Cursor

GitRanks hands Cursor's agent an open-source issue that fits your skills, and you review the change before a pullrequest opens in your name. The agent runs on your Cursor plan.

  1. Use the Cursor button above, or add this to ~/.cursor/mcp.json:

    { "mcpServers": { "gitranks": { "url": "https://mcp.gitranks.com/mcp" } } }
    
  2. Cursor offers to sign in when it connects: gitranks.com opens, you sign in with GitHub and press Allow. There'sno token to copy.

  3. In the agent panel, ask: "Find me an open-source issue to work on with GitRanks." Pick one from the list, andCursor's agent claims it, fixes it and hands the change back. Then review and approve on gitranks.com.

VS Code and Kiro

Use the buttons above, or add the server by its URL alone; the editor offers to sign in when it first connects.

  • VS Code (.vscode/mcp.json in a workspace, or MCP: Open User Configuration):

    { "servers": { "gitranks": { "type": "http", "url": "https://mcp.gitranks.com/mcp" } } }
    
  • Kiro (~/.kiro/settings/mcp.json, or .kiro/settings/mcp.json in a workspace):

    { "mcpServers": { "gitranks": { "url": "https://mcp.gitranks.com/mcp" } } }
    

Other clients

Each one connects by the URL alone and signs in on gitranks.com in your browser:

  • GitHub Copilot CLI: copilot mcp add --transport http gitranks https://mcp.gitranks.com/mcp. The browser opens tosign in on first use; /mcp auth gitranks signs in again. The plugin may also install withcopilot plugin install gitranks/contribute (not tested yet).

  • Devin (CLI and Desktop): devin mcp add gitranks https://mcp.gitranks.com/mcp, then devin mcp login gitranks.

  • Amp: amp mcp add gitranks https://mcp.gitranks.com/mcp. Amp opens the sign-in page in your browser when itstarts.

  • opencode: opencode mcp add gitranks --url https://mcp.gitranks.com/mcp, then opencode mcp auth gitranks.

  • Zed: Settings → AI → MCP Servers → Add Server → Add Remote Server, or in settings.json{ "context_servers": { "gitranks": { "url": "https://mcp.gitranks.com/mcp" } } }. Zed asks you to sign in when itconnects.

  • Cline: cline mcp add gitranks https://mcp.gitranks.com/mcp --transport http, or in cline_mcp_settings.json(set the type: without it Cline falls back to the old SSE transport):

    { "mcpServers": { "gitranks": { "type": "streamableHttp", "url": "https://mcp.gitranks.com/mcp" } } }
    

    Then authorize it (OAuth) when Cline offers to, and sign in.

  • Factory droid: droid mcp add gitranks https://mcp.gitranks.com/mcp --type http, then /mcp in Droid and signin in the browser.

  • Warp: Settings → Agents → MCP servers → + Add, paste{ "gitranks": { "url": "https://mcp.gitranks.com/mcp" } }, then Start: the browser opens to sign in.

  • Clients without sign-in for remote servers (JetBrains AI Assistant, Augment, clients that only run localservers): connect through the mcp-remote bridge, which signs in for them.It opens the browser on first run:

    { "mcpServers": { "gitranks": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.gitranks.com/mcp", "--transport", "http-only"] } } }
    
  • Any MCP client with streamable HTTP and sign-in: URL https://mcp.gitranks.com/mcp, nothing else.

Antigravity

  1. Add the server to Antigravity's MCP config, ~/.gemini/config/mcp_config.json, with the URL alone. In the IDE, openit from the … menu at the top of the agent panel → MCP Servers → Manage MCP Servers → View raw config.

    { "mcpServers": { "gitranks": { "serverUrl": "https://mcp.gitranks.com/mcp" } } }
    
  2. In the agent's window, click Customizations, scroll down to MCP servers and click Sign in next togitranks. Your browser opens gitranks.com: sign in with GitHub and press Allow.

Don't use the Authenticate button on the Manage MCP Servers page: it only opens Settings → Customizations,which has no MCP servers section. Sign in from the agent's window instead.

A token works too: see Use a token instead.

Plugin formats in this repository

The skill in skills/contribute/SKILL.md works in any agent that reads Agent Skills. The repository packages it withthe server for each plugin format below. Each connects by signing in.

  • .claude-plugin/ and .mcp.json: the Claude Code plugin and its marketplace (gitranks);
  • gemini-extension.json: the Gemini CLI extension;
  • plugin.json and mcp.json at the root: an Agent Pluginspackage, for clients and marketplaces that install that format, with the listing and review details for the ChatGPTand Codex plugin directory;
  • .agents/plugins/marketplace.json: the Codex plugin marketplace;
  • .devin-plugin/plugin.json: the Devin plugin manifest;
  • .antigravity-plugin/plugin.json and mcp_config.json: the Antigravity plugin manifest and its server, by sign-in(installing the plugin is not tested in Antigravity yet; the setup in Antigravity is).

Use a token instead

For a client without sign-in, or a script, create a personal token ongitranks.com/contribute underContribute → Settings → Your own agent (MCP). It starts with gr_. Send it in the X-GitRanks-Token header, oras Authorization: Bearer <your token>. Keep it to yourself: it acts as you until you revoke it there. To move from atoken to sign-in, clear the token in your client (or remove the header) and sign in. Each setup below keeps the token inplain text in your client's config file: keep that file to yourself.

  • Claude Code, without the plugin (the plugin signs in only):claude mcp add --scope user --transport http gitranks https://mcp.gitranks.com/mcp --header "X-GitRanks-Token: <your GitRanks token>".

  • Gemini CLI, without the extension (the extension signs in only):gemini mcp add --scope user --transport http --header "X-GitRanks-Token: <your GitRanks token>" gitranks https://mcp.gitranks.com/mcp.

  • Codex (~/.codex/config.toml):

    [mcp_servers.gitranks]
    url = "https://mcp.gitranks.com/mcp"
    http_headers = { "X-GitRanks-Token" = "<your GitRanks token>" }
    
  • Cursor (~/.cursor/mcp.json):

    { "mcpServers": { "gitranks": { "url": "https://mcp.gitranks.com/mcp", "headers": { "X-GitRanks-Token": "<your GitRanks token>" } } } }
    
  • Any MCP client with streamable HTTP: URL https://mcp.gitranks.com/mcp, header Authorization: Bearer <your token>.

  • Antigravity: add the gitranks entry to its MCP config, ~/.gemini/config/mcp_config.json. In the IDE, openit from the … menu at the top of the agent panel → MCP Servers → Manage MCP Servers → View raw config.

    { "mcpServers": { "gitranks": { "serverUrl": "https://mcp.gitranks.com/mcp", "headers": { "Authorization": "Bearer <your GitRanks token>" } } } }
    

    Then restart it: in the agent's window, Customizations → MCP servers, ⋮ next to gitranks → Restart; inthe CLI, /mcp.

Use it

Ask your agent: "Find me an open-source issue to work on with GitRanks." It lists issues picked for you, claims the oneyou choose, fixes it on your machine and hands the change back. Then review it and approve the pull request ongitranks.com. Merged pull requests stay on your GitHub profile.

In Claude Code the plugin adds two commands:

  • /gitranks-contribute:find [language, kind or owner/repo]: issues picked for you, then work on the one you choose;
  • /gitranks-contribute:status: your claims and pull requests, and what each one needs from you.

The server also offers one prompt, Find an open-source issue for me, with an optional one-word wish such astypescript, docs or owner/repo. Clients that list server prompts show it as a command or menu item; in ClaudeCode it is an /mcp__…find_issue command.

Fair to maintainers

GitRanks opens at most one pull request in a repository at a time and never more than four a month. Two misses in onerepository within 90 days (a pull request no one answers for 30 days, or one closed as wrong, low quality or harshly)take it out of the shared pool for 90 days; a merge cancels its own miss. A maintainer who closes one saying the projecttakes no AI-made pull requests takes the repository out for 90 days; one who asks us to stay away, for 365. Maintainerscan opt out on themaintainers' page.

What is sent to GitRanks

Everything goes to mcp.gitranks.com, except the sign-in page and your approvals, which are on gitranks.com.

When you sign in:

  • your agent registers itself: the name it gives itself, the address the sign-in answer goes back to (on yourcomputer, or the client's own page), and the other details it registers with, such as its version or homepage. Theconsent page shows the name and the address;
  • you sign in to gitranks.com with GitHub, and press Allow. Your agent then gets an access token and a refresh tokenfrom mcp.gitranks.com. It sends the access token with every call and uses the refresh token to renew it.

With every tool call, the access token (or your personal token, when you use one), and:

  • the filters you ask find_issues for;
  • the issue you claim or give back, with the reason and your note;
  • the change you hand back: the patch (git format-patch), your agent's verdict, summary and brief, the tests it ranwith their output, its risk notes, and the pull request title and text it suggests;
  • your agent's name and the model it runs on, as it reports them with a change or a proof;
  • for a follow-up, what you asked for in your own words, and your agent's reply drafts to the review;
  • what your agent learned about how a repository builds and tests;
  • in GitRanks Learn (invite-only), the lesson your agent writes on its fix: its steps (text, diagrams, the diff's lines,code excerpts from the repository) and its questions with their answers; it becomes public, linked from the pullrequest, when GitRanks opens it;
  • for a proof: its outcome, summary, the section or reply it drafts for the pull request, its notes, a list of whatit removed (for example "2 IP addresses"), and its screenshots, which go to upload links the server gives.

Your agent runs on your machine with your own model. GitRanks never sees your other files or your model's API key, andyour agent never gets your GitHub access. See theprivacy policy and themaintainers' page for whatGitRanks does with a change and how a repository can opt out.

Support

Questions or problems: email [email protected],open an issue in this repository, or read theFAQ.

License

MIT

MCP Server · Populars

MCP Server · New

    Nimbleway

    WebRouter

    WebRouter is an open source standard that connects your agent to the web

    Community Nimbleway
    frontman-ai

    frontman

    The AI agent that lives in your framework/browser

    Community frontman-ai
    Laksh-star

    Screenward

    Movie and TV discovery, watch planning, and streaming availability—for browsers and MCP clients.

    Community Laksh-star
    codescene-oss

    CodeHealth MCP Server

    The CodeScene MCP Server exposes CodeScene’s Code Health analysis as local AI-friendly tools.

    Community codescene-oss
    Poptin-LTD

    poptin-mcp

    Official Poptin MCP server. Connect your AI agent to create email campaigns, analyze popup and form performance, and build targeted audience segments.

    Community Poptin-LTD