Upstream.codes
Git hosting with an MCP server so AI agents can read and change repos under your sign-in
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/mcpAdd to Settings → Connectors → Add custom connector
https://api.upstream.codes/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"upstream": {
"url": "https://api.upstream.codes/mcp"
}
}
}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/mcpEnter a Name (for example "Upstream.codes"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
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.
