Upriver MCP
Use the Upriver agent from Claude, Codex, Cursor and other AI clients through MCP.
The Upriver MCP server brings the Upriver Agent into the AI clients you already use, such as Claude, Codex and Cursor.
Your client sends your request to Upriver. The agent does the work with its full context of your data stack, and your client gets the answer back with a link to the task in Upriver.
You don't have to give your client any context about your data, and you don't have to build your own MCP servers or skills for it. Upriver already knows your schemas, lineage, pipelines and business definitions.
How it works
Each request from your client starts or continues an Upriver task. It is the same kind of task you see in the Upriver web app.
Every task that you start through MCP shows in your task list in the web app. You can open it there to see the full tables, charts and steps, or to continue the work.
When the agent needs a decision from you, your client shows its question. Your answer goes back to the same task.
Server URL
https://agentic-eks-api-server.upriverdata.com/upriver-mcp/The server uses the streamable HTTP transport. If your Upriver workspace is in the EU region, contact Upriver support for your server URL.
Authentication
Add the server URL to your client. The first time your client connects, it opens a browser window where you sign in to Upriver. Your client then acts as you, with the same access that you have in the Upriver web app. You don't have to copy a token.
Connect your client
Let your agent set it up (recommended)
The fastest way is to ask your AI client to do it. Paste this message into Claude Code, Codex or Cursor:
Your client reads this page and adds the server. Then sign in to Upriver when your client asks.
Or pick your client
Claude Code
Run this command, then run /mcp in Claude Code and select upriver to sign in:
--scope user makes Upriver available in all your projects.
Claude Desktop and claude.ai
Go to Customize → Connectors, or open claude.ai/customize/connectors.
Click + Add → Add custom connector.
Enter the name
Upriverand the server URL.Click Connect and sign in to Upriver.
A connector that you add on claude.ai is also available in Claude Desktop when you sign in with the same account.
Codex
The Codex CLI and the Codex desktop app use the same settings, so you only need to set this up once.
Codex desktop: click the Codex desktop card above. It opens a new Codex chat with the setup message. Send the message, and Codex adds the server for you.
Codex CLI: run this command. It adds the server and opens a browser window where you sign in to Upriver:
To sign in again later, run codex mcp login upriver.
Cursor
Add the server to ~/.cursor/mcp.json (for all projects) or to .cursor/mcp.json (for one project):
Then open Cursor Settings → MCP and sign in to upriver. Cursor shows the results as text. It does not show the live task view.
Other clients
Other clients that support remote MCP servers over streamable HTTP with OAuth sign-in can also connect. Add the server URL in the client's MCP settings, then sign in to Upriver when the tool asks.
The live task view shows only in clients that support MCP Apps. Other clients show the results as text.
Check the connection
Ask your client a question about your data, for example:
Ask Upriver what data sources are connected.
Your client calls Upriver and returns the agent's answer with a link to the task in the Upriver web app.
Live view
In clients that support MCP Apps, such as Claude and Codex, Upriver shows a live view of the task inside the chat instead of a text-only reply. The view shows the agent's steps as it works, any question it needs you to answer, and the final answer with its tables and charts.
You don't have to set anything up. Clients that support MCP Apps show the live view automatically. Other clients, such as Cursor, show the results as text.
Considerations
Permissions: your client acts as you, with the same access that you have in the Upriver web app. The agent has read-only access to your warehouse.
Result size: to keep your client's context small, answers summarize query results instead of including every row. Your client can get up to 200 rows for each query with
get_query_results. The full results are in the Upriver web app.Tasks: every question that you ask through MCP is saved as a task in your Upriver task list, so you can open it in the web app later.
Next steps
MCP tools reference: the tools that the server gives your AI client.
Agent: what the Upriver agent can do.
Last updated