# Upstream.codes

> Upstream.codes is a freemium MCP server for developer tools. Git hosting with an MCP server so AI agents can read and change repos under your sign-in. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI, VS Code
- **Website:** https://upstream.codes/docs/mcp
- **MCP Registry name:** codes.upstream/upstream
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-20

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.upstream.codes/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "upstream": {
      "url": "https://api.upstream.codes/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Git A](https://ai-powered.com/mcp/git-a): Git A is a paid MCP server for developer tools.
- [Git MCP](https://ai-powered.com/mcp/git-mcp): Git MCP is an open-source MCP server for developer tools.
- [Git Courer](https://ai-powered.com/mcp/git-courer): Git Courer is an open-source MCP server for developer tools.
- [GitHub](https://ai-powered.com/mcp/github): GitHub is an open-source MCP server for developer tools.
- [GitHub](https://ai-powered.com/mcp/github-5): GitHub is an open-source MCP server for developer tools.
- [Industry Pulse](https://ai-powered.com/mcp/industry-pulse): Industry Pulse is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/upstream-codes
