Other MCP Clients

Any MCP client that supports Streamable HTTP transport can connect to Upstream directly.

Connection details

URL	https://api.upstream.do/mcp
Transport	Streamable HTTP
Auth header	Authorization: Bearer <your-token>
Protocol version	2025-03-26

Replace <your-token> with your Personal Access Token.

Streamable HTTP clients

Clients like Cursor, Claude Code, Windsurf, VS Code, and others that support Streamable HTTP can connect directly using the URL and auth header above. Consult your client’s documentation for where to configure MCP servers.

Stdio-only clients

Clients that only support stdio transport (like Claude Desktop) need the mcp-remote bridge. See the Claude Desktop guide for the pattern — it works the same way for any stdio-only client:

{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://api.upstream.do/mcp",
    "--header",
    "Authorization: Bearer <your-token>"
  ]
}

What to expect

Once connected, your client will discover 44 tools and 4 prompt workflows automatically. The server also provides built-in instructions that help your AI assistant understand how to navigate your inbox efficiently.