How to Use the Watershed Climate MCP in Cursor

Q: If I use Cursor, how do I check the status of a calculation task?

After submitting an upload, you get a taskid. You call gettaskstatus with that ID. The live response tells you exactly if Watershed is finished calculating or if it failed.

Q: Can I modify activity data records using Cursor?

Yes. After listing the records, use updateuploaddatarecord. This lets your agent correct errors or change values before you validate and submit the whole batch for processing.

Build carbon accounting tools right into your code editor using Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Watershed Climate MCP to Cursor

Create your Vinkius account to connect Watershed Climate to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Watershed Climate with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Building Emissions Logic with the MCP Server

When you need to process emissions data, start by creating a new container via `create_upload`. Then, inject activity records directly into your code using `upload_data_records`. The AI agent handles calling this tool and returning live results that populate your script variables. After the inputs are ready, running `validate_upload` ensures all data is clean before you call `submit_upload`, getting a task ID you can pass to other functions.

Retrieving GHG Inventory Details via MCP Server

Getting an organization's carbon footprint shouldn't be guesswork. You first use `list_inventories` to see all available yearly measurements. Then, you grab the specific inventory ID and call `get_inventory`. The live API response returns a detailed breakdown of Scope 1, 2, and 3 emissions. Want to look at related measurement values? Use `list_measurements`. You can filter by an inventory ID to see exactly how those calculated CO2e values were derived.

Managing Reports for the MCP Server

Need a report for compliance? The process starts with listing available reports using `list_reports`. Once you have a specific report ID, calling `get_report` pulls down the full details—like which disclosure frameworks are covered. This data flows right into your code. If you need to check the raw inputs first, use `list_data_records` on an upload container. It's the best way to confirm that the activity data matches what your application logic expects.

Setup guide

Set up Watershed Climate MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Watershed Climate MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Watershed Climate transactions." If the MCP tools are loaded correctly, Cursor will call the Watershed Climate tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "watershed-climate-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Watershed Climate. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Watershed Climate now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Watershed Climate MCP in Cursor

You set up the connection by adding the server details in a project-scoped `.cursor/mcp.json` file. This makes sure every teammate running your code has immediate access to the tools.

The server manages activity data records, which are the raw inputs defining usage (like kWh or gallons). This is critical for generating accurate GHG inventories.

After submitting an upload, you get a `task_id`. You call `get_task_status` with that ID. The live response tells you exactly if Watershed is finished calculating or if it failed.

Yes. After listing the records, use `update_upload_data_record`. This lets your agent correct errors or change values before you validate and submit the whole batch for processing.

The server processes activity data, turning raw inputs into measurable emissions components that populate comprehensive GHG inventories.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python