# Upstream

> Upstream is a freemium MCP server for developer tools. Live status, deprecations and model retirements for about 40 AI and developer APIs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://upstream-api.pages.dev
- **Repository:** https://github.com/toolweather/upstream
- **MCP Registry name:** io.github.toolweather/upstream
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Upstream answers the question an agent often needs before it makes a call: is the API it depends on working right now, and is the model it uses about to disappear? It checks around 40 providers every few minutes and watches the deprecation, retirement and pricing pages of major LLM providers.

The answers come from official public status pages and docs, and each response includes the excerpt that was read so you can verify it. For providers without a machine-readable status page it only checks that the API responds, and "unknown" means the check failed, not that the provider is down.

A free key is available through a single POST, with pay-per-call above the free tier in USDC on Base via x402. A free daily digest of breaking changes is published at 12:00 UTC as RSS and JSON.

## Features

- **API status check:** Reports whether a provider is up, with incidents and affected parts.
- **Model deprecation lookup:** Says whether a model is active, deprecated or retired, with shutdown date and replacement.
- **Change feed:** Lists outages, deprecations, retirements and pricing edits since a date.
- **Provider list:** Shows which providers are tracked and their state.
- **Daily digest:** A free breaking-changes digest as RSS and JSON.
- **x402 pay-per-call:** Pay in USDC above the free tier with no account.

## Good for

- Have an agent check an API's health before relying on it
- Find out when a model your app uses is being retired
- Monitor pricing changes across LLM providers
- Alert a workflow when a provider announces a breaking change

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http upstream https://upstream.toolweather.workers.dev/mcp
```

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

```sh
https://upstream.toolweather.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "upstream": {
      "url": "https://upstream.toolweather.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "upstream": {
      "type": "http",
      "url": "https://upstream.toolweather.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "upstream": {
      "serverUrl": "https://upstream.toolweather.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "upstream": {
      "type": "http",
      "url": "https://upstream.toolweather.workers.dev/mcp"
    }
  }
}
```

## Tools

- `check_api_status`: Is this API down?
- `check_model_deprecation`: Is this model deprecated, what replaces it?
- `list_recent_api_changes`: Recent outages, deprecations, retirements and pricing edits
- `list_providers`: Providers tracked and their state
- `get_digest`: The daily breaking-changes digest

## FAQ

### How do I get a key?

Run a POST to the /v1/keys endpoint; the site says it is free for most agents.

### What does it cost above the free tier?

Listed prices are $0.003 for status or model lookups, $0.01 for the changes feed and $0.05 for an extra watch.

### Where does the data come from?

Official public status pages and provider docs, with the excerpt included in each answer.

### What does unknown mean?

Upstream's own check failed; it does not mean the provider is down.

### Is Upstream free?

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

### How do I add Upstream to Claude Code?

Run this command in your terminal: claude mcp add --transport http upstream https://upstream.toolweather.workers.dev/mcp

### What are the best alternatives to Upstream?

The closest alternatives to Upstream are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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