Skip to content
MCP server

Upstream

Live status, deprecations and model retirements for about 40 AI and developer APIs

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
0.2.0
Listing updated
2 days ago

About Upstream

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

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "upstream": {
      "url": "https://upstream.toolweather.workers.dev/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://upstream.toolweather.workers.dev/mcp"
    }
  }
}

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

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

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

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

Tools this server provides (5)

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

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

What it does

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

Pricing

Freemium

Free tier for most agents; above it $0.003-$0.05 per call via x402

Prices change. Check upstream-api.pages.dev before you buy.

Upstream 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 to Upstream

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools