Quick Start

1. Get your Personal Access Token

   Go to Upstream Settings > API and MCP and create a token. Learn more about tokens.

2. Add the server to your AI client

   Cursor

   Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

   {
     "mcpServers": {
       "upstream": {
         "url": "https://api.upstream.do/mcp",
         "headers": {
           "Authorization": "Bearer <your-token>"
         }
       }
     }
   }

   Full Cursor setup guide →

   Claude Code

   Add to .claude/settings.local.json:

   {
     "mcpServers": {
       "upstream": {
         "url": "https://api.upstream.do/mcp",
         "headers": {
           "Authorization": "Bearer <your-token>"
         }
       }
     }
   }

   Full Claude Code setup guide →

   Claude Desktop

   Claude Desktop needs the mcp-remote bridge. Add to your Claude Desktop config:

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

   Full Claude Desktop setup guide →

   Other

   Any MCP client that supports Streamable HTTP can connect directly:

   • URL: https://api.upstream.do/mcp
   • Header: Authorization: Bearer <your-token>

   More details →

3. Start using it

   Restart your AI client. The 44 Upstream tools will load automatically. Try asking:

   “Show me my unread emails”

   “Summarize the latest thread from Sarah”

   “Reply saying we’ll ship next week”