Skip to content
MCP server

Upstream.codes

Git hosting with an MCP server so AI agents can read and change repos under your sign-in

Install

Upstream.codes is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Pricing
Freemium
Platforms
Web, API, CLI
Runs
Remotely
Version
1.0.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add --transport http upstream https://api.upstream.codes/mcp

Add to Settings → Connectors → Add custom connector

https://api.upstream.codes/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "upstream": {
      "url": "https://api.upstream.codes/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "upstream": {
      "type": "http",
      "url": "https://api.upstream.codes/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "upstream": {
      "serverUrl": "https://api.upstream.codes/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://api.upstream.codes/mcp

Enter a Name (for example "Upstream.codes"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "upstream": {
      "type": "http",
      "url": "https://api.upstream.codes/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About Upstream.codes

Upstream is a Git forge at upstream.codes that also exposes its repositories, code, change requests and issues to AI clients over the Model Context Protocol. The MCP endpoint uses OAuth sign-in rather than API keys, so an agent acts with the permissions of the signed-in person and the access level chosen at connection time.

The server is split into toolsets such as repos, change_requests, issues, actions and discussions, and clients can load only the ones they need. Separate URLs provide a read-only endpoint and a public endpoint for public repositories without signing in. The docs say every tool marks whether it only reads or performs destructive writes, so clients can ask before running changes.

The documentation lists setup steps for Cursor, Claude, ChatGPT, VS Code and Codex, and notes that repository contents and comments are treated as data rather than instructions. It suits developers and teams who want agents to review change requests, triage issues or push commits within limits they set.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

list_repositories
List repositories you can access.
get_file_contents
Read file contents from a repository.
search_code
Search code across repositories.
create_or_update_file
Create or update a file in a repository.
list_change_requests
List change requests.
get_change_request
Get a single change request.
create_change_request
Open a new change request.
review_change_request
Submit a review on a change request.
merge_change_request
Merge a change request.
list_issues
List issues.
create_issue
Create an issue.
comment_on_issue
Comment on an issue.

What it does

One-URL MCP connection
Clients connect to a single Streamable HTTP endpoint and sign in through OAuth instead of pasting API keys.
Selectable access levels
Read only, read and write, or admin access can be chosen when the agent signs in, and never exceed the user's own permissions.
Toolset filtering
Tools are grouped into toolsets such as repos, issues and change requests so agents load only what they need.
Read-only endpoint
A dedicated readonly URL exposes read tools only, and read-only overrides other toolset settings.
Connected agent management
Connected agents appear in settings with their access level and last use, and can be disconnected to revoke access.

Good for

  • Have an AI agent review an open change request and leave comments
  • Let a coding agent push a branch and open a change request for a fix
  • Triage and comment on issues from inside an MCP-compatible editor
  • Query repository code and history from a read-only agent connection

Pricing

Freemium

Free plan for individuals and organizations; Pro, Team and Enterprise paid tiers

Prices change. Check upstream.codes before you buy.

Upstream.codes FAQ

Do I need an API key to connect?

No. The docs say there are no API keys to create or paste; you sign in with your account through OAuth.

Can an agent do more than I can?

No. The access level never adds permissions you don't have, and organization rules, branch protection and required reviews still apply.

Is there a read-only option?

Yes. The /mcp/readonly URL exposes read tools only, and a read-only setting overrides other toolsets.

Is Upstream.codes free?

Upstream.codes has a free plan, with paid plans for more usage or features.

How do I add Upstream.codes to Claude Code?

Run this command in your terminal: claude mcp add --transport http upstream https://api.upstream.codes/mcp

What are the best alternatives to Upstream.codes?

The closest alternatives to Upstream.codes are Git A, Git MCP, Git Courer, GitHub and GitHub.

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers