How do I connect my Watershed account?

You subscribe to the MCP on Vinkius and enter your Watershed API Key. Once connected, your AI client can immediately start interacting with your organization's data.

Can I upload data in bulk?

Yes. You can use the upload_data_records capability to send an array of multiple activity records in a single batch.

What kind of emissions data can I manage?

The MCP handles activity data for electricity, business travel, shipping, and other sources that feed into Scope 1, 2, and 3 inventories.

Will the AI calculate my emissions?

The AI triggers Watershed's calculation engine via the submit_upload capability, which converts your activity data into CO2e measurements using established emission factors.

How do I know if my data upload succeeded?

After submitting an upload, you receive a task ID. You can use the get_task_status capability to check if the processing is complete, in progress, or failed.

What is the workflow to upload activity data and get emissions calculated in Watershed?

The complete workflow is: (1) Use create_upload to create an upload container, (2) Use upload_data_records to add your activity data records (electricity, flights, shipping, etc.), (3) Use validate_upload to check data quality and fix any errors, (4) Use submit_upload to send data for emissions calculation, (5) Use get_task_status with the returned task_id to monitor processing. Once complete, your measurements appear in the inventory.

Can I check my organization's total carbon footprint for a specific year?

Yes! Use list_inventories to find your organization's GHG inventories by year. Then use get_inventory with the specific inventory_id to see the complete emissions breakdown by Scope 1 (direct), Scope 2 (energy), and Scope 3 (value chain). You can also use list_measurements with the year filter to see individual measurement details across all inventories.

Where do I find my Watershed API key and how do I generate one?

Log in to your Watershed dashboard at dashboard.watershedclimate.com, navigate to Organization Settings in the left menu, then go to the API section. Click to generate a new API key. Copy and save this key immediately. it won't be shown again. The key typically starts with wh_. Keep it secure as it provides full access to your organization's climate data.

What types of activity data can I upload to Watershed?

Watershed accepts a wide range of activity data including: electricity and energy consumption (kWh, therms), business travel (flights, hotels, rental cars), employee commuting, freight and shipping (ton-miles, kg-km), waste generated, water usage, and purchased goods/services. Each record needs fields like activity_type, quantity, unit, start_date, end_date, and optionally location and spend_amount for accurate emissions calculation.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Watershed Climate to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire sustainability program through a single chat interface.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 16 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 16 available through Watershed Climate.

01
Get upload
This capability retrieves specific details for a single data upload. Use it to inspect an upload's status or contents using its ID.
02
List inventories
This capability pulls a list of all GHG inventories in your Watershed organization. Each inventory shows your Scope 1, 2, and 3 emissions for a specific year.
03
List reduction targets
This capability lists your configured emissions reduction goals. It shows your baseline years, target years, and current progress toward SBTi or net-zero commitments.
04
List reports
This capability provides a list of all available sustainability reports. You can find CDP disclosures, TCFD reports, and custom summaries here.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 16 available through Watershed Climate.

05
List upload data records
This capability lists every individual activity record within a specific upload. It's how you review data before you validate or submit it.
06
Update upload data record
This capability modifies an existing data record. Use it to fix errors in your activity data before you submit the upload for processing.
07
Upload data records
This capability adds activity data like electricity or travel records to an existing upload container. You can send single records or entire batches at once.
08
Get inventory
This capability fetches deep details for a specific GHG inventory. It helps you understand the exact composition of your organization's emissions.

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 16 available through Watershed Climate.

09
Create upload
This capability starts a new data upload process by creating a container. You need this container before you can add any activity records.
10
Delete upload data record
This capability removes a specific record from an upload. Use this to get rid of incorrect data before you finalize your submission.
11
Get report
This capability retrieves the full details and files for a specific sustainability report. It provides access to the actual disclosure documents.
12
Get task status
This capability checks the progress of a background processing task. Use it to see if a large data submission is finished, still running, or failed.

Capability set04 / 04

13-16

4 capabilities in this set.

Part of 16 available through Watershed Climate.

13
List measurements
This capability lists calculated carbon footprint values. You can filter these measurements by a specific inventory or by a specific year.
14
List uploads
This capability shows all existing data upload containers in your organization. It's the starting point for finding the IDs you need to manage data.
15
Submit upload
This capability triggers the calculation engine to turn your validated data into official emissions measurements. It returns a task ID so you can track the progress.
16
Validate upload
This capability checks your upload for errors or warnings. You should always run this to ensure your data is clean before you submit it for processing.

Real work

What teams actually run

Monthly Utility Reporting

An operations manager tells the AI to upload the latest electricity usage for several regional offices at once.

Audit Preparation

An ESG analyst asks the AI to retrieve specific Scope 3 measurements to prepare for a disclosure audit.

Target Monitoring

A climate lead checks if the company is meeting its SBTi reduction milestones during a quarterly review.

Data Correction

A sustainability specialist uses the AI to find and fix a specific erroneous travel record in a recent upload.

Automate a task

Put Watershed Climate to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Watershed Climate works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Watershed Climate to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

983ms average. Fast in production.

Watershed Climate is checked daily against the live service.

Daily averagePeak 1212ms

Oct 3Today

Fastest day: 905ms
Slowest day: 1212ms
14-day trend: Slowing+18%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 16 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Watershed Climate, so you can see the experience inside your AI.

It does not authenticate your account with Watershed Climate. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Watershed Climate Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_svbUSyLT0Fyy3BlxNle3W7x9VHoKVZUrNfKc7l2A/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Watershed Climate capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

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

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Watershed Climate in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Watershed Climate owners hand off.

This MCP is built for professionals managing corporate climate responsibility and ESG data workflows.

01
Sustainability Teams
They hand off data uploads, validation tasks, and inventory checks to the AI.
02
ESG Analysts
They use the AI to query emissions measurements and pull progress reports for stakeholders.
03
Operations & Supply Chain Leads
They automate the ingestion of logistics and utility data into the carbon accounting system.

FAQ

Questions Watershed Climate owners ask.

01
How do I connect my Watershed account?
You subscribe to the MCP on Vinkius and enter your Watershed API Key. Once connected, your AI client can immediately start interacting with your organization's data.
02
Can I upload data in bulk?
Yes. You can use the upload_data_records capability to send an array of multiple activity records in a single batch.
03
What kind of emissions data can I manage?
The MCP handles activity data for electricity, business travel, shipping, and other sources that feed into Scope 1, 2, and 3 inventories.
04
Will the AI calculate my emissions?
The AI triggers Watershed's calculation engine via the submit_upload capability, which converts your activity data into CO2e measurements using established emission factors.
05
How do I know if my data upload succeeded?
After submitting an upload, you receive a task ID. You can use the get_task_status capability to check if the processing is complete, in progress, or failed.
06
What is the workflow to upload activity data and get emissions calculated in Watershed?
The complete workflow is: (1) Use create_upload to create an upload container, (2) Use upload_data_records to add your activity data records (electricity, flights, shipping, etc.), (3) Use validate_upload to check data quality and fix any errors, (4) Use submit_upload to send data for emissions calculation, (5) Use get_task_status with the returned task_id to monitor processing. Once complete, your measurements appear in the inventory.
07
Can I check my organization's total carbon footprint for a specific year?
Yes! Use list_inventories to find your organization's GHG inventories by year. Then use get_inventory with the specific inventory_id to see the complete emissions breakdown by Scope 1 (direct), Scope 2 (energy), and Scope 3 (value chain). You can also use list_measurements with the year filter to see individual measurement details across all inventories.
08
Where do I find my Watershed API key and how do I generate one?
Log in to your Watershed dashboard at dashboard.watershedclimate.com, navigate to Organization Settings in the left menu, then go to the API section. Click to generate a new API key. Copy and save this key immediately. it won't be shown again. The key typically starts with wh_. Keep it secure as it provides full access to your organization's climate data.
09
What types of activity data can I upload to Watershed?
Watershed accepts a wide range of activity data including: electricity and energy consumption (kWh, therms), business travel (flights, hotels, rental cars), employee commuting, freight and shipping (ton-miles, kg-km), waste generated, water usage, and purchased goods/services. Each record needs fields like activity_type, quantity, unit, start_date, end_date, and optionally location and spend_amount for accurate emissions calculation.

Explore

More in The Unthinkable

Connect Watershed Climate to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get upload

List inventories

List reduction targets

List reports

05-08

List upload data records

Update upload data record

Upload data records

Get inventory

09-12

Create upload

Delete upload data record

Get report

Get task status

13-16

List measurements

List uploads

Submit upload

Validate upload

What teams actually run

Monthly Utility Reporting

Audit Preparation

Target Monitoring

Data Correction

Building your own app? The connector is yours to use.

Watershed Climate Connector

Claude Desktop

Sustainability Teams

ESG Analysts

Operations & Supply Chain Leads

How do I connect my Watershed account?

Can I upload data in bulk?

What kind of emissions data can I manage?

Will the AI calculate my emissions?

How do I know if my data upload succeeded?

What is the workflow to upload activity data and get emissions calculated in Watershed?

Can I check my organization's total carbon footprint for a specific year?

Where do I find my Watershed API key and how do I generate one?

What types of activity data can I upload to Watershed?

Climatiq Carbon Calculations AI Connector

NCDC Climate Data Online AI Connector

NCDC Climate Data Online AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector

Suggestions

Data Pipeline Prover AI Connector

Ember Climate AI Connector

Personal Carbon Budget Tracker AI Connector

SkootEco AI Connector