Upriver Plugin

Upriver Claude Code Plugin

Use Upriver’s data engineering context and tools directly inside Claude Code. This plugin connects Claude to the Upriver MCP server and applies Upriver-specific skills so you can work with incidents, warehouse queries, profiles, and your synced context without leaving the editor.

---

What you get

• Upriver MCP server — Claude can call Upriver tools (incidents, warehouse queries, profile diff, and more) through a single configured MCP server.
• Upriver skills — Built-in skills for context usage, MCP patterns, brand and directory rules, file tracking, and response quality so Claude follows your team’s conventions.
• Region switching — Choose the Upriver backend region (e.g. US or EU) via a slash command; your choice is saved and reapplied on each new session.
• Synced context — When your Upriver context is available (e.g. in upriver_context/), Claude uses it in a read-only way for architecture, data assets, and lineage.

---

Setup

1. MCP server URL

The plugin includes an .mcp.json that points the upriver server at a URL. After install, set that URL to your Upriver MCP endpoint (e.g. your tenant or environment URL).

You can do this in two ways:

• Slash command (recommended)
  In Claude Code, run:

  • /upriver-plugin:region us-east-1 for US
  • /upriver-plugin:region eu-west-1 for EU

  This updates the plugin’s .mcp.json and saves your region so it’s reapplied on every new session.

• Manual
  Edit the plugin’s .mcp.json (or your project MCP config) and set the upriver server url to your MCP base URL (e.g. the same base you use for UPRIVER_MCP_URL below; the path may include /mcp if your deployment expects it).

Reference URLs (by region):

Region	MCP URL
us-east-1	https://agentic-eks-api-server.upriverdata.com/api/internal/v1/mcp/
eu-west-1	https://agentic-eks-api-server.eu.upriverdata.com/api/internal/v1/mcp/

2. Environment variables (optional)

Set these where Claude Code can see them (e.g. shell profile, project .env, or Claude Code settings):

Variable	Required	Description
UPRIVER_MCP_URL	Only if you use context or need a specific base URL	Base URL of the Upriver MCP server (e.g. your tenant or one of the region URLs above).
UPRIVER_AUTH	No	If your MCP or gateway requires auth, set a Cookie string or Authorization header value (e.g. Authorization: Bearer <token>).

---

Using the region command

• Command: /upriver-plugin:region <region>
• Examples: /upriver-plugin:region us-east-1, /upriver-plugin:region eu-west-1

The chosen region is stored in the plugin directory and reapplied automatically on session start, so you don’t need to run the command again unless you want to switch regions.

---

Scripts

• scripts/set-region.sh [region] — Sets the Upriver MCP region (us-east-1 or eu-west-1), updates .mcp.json, and writes the choice to .upriver-region. Used by the /upriver-plugin:region slash command. Run with no arguments to see the current region and usage. Requires jq.

---

Summary

1. Install the plugin with claude plugin install.
2. Set your MCP URL via /upriver-plugin:region us-east-1 or eu-west-1 (or by editing .mcp.json).
3. Optionally set UPRIVER_MCP_URL and UPRIVER_AUTH if your setup needs them.
4. Start a new Claude Code session; the plugin will use your saved region and Upriver skills automatically.

For issues or questions, contact your Upriver administrator or support.