How to Use the Watershed Climate MCP in Windsurf

Q: How do I check my carbon footprint status with Watershed Climate and Windsurf?

You first list all inventories using listinventories to find the specific year you're checking. Then, your agent uses getinventory to pull up detailed information on Scope 1, 2, and 3 emissions for that period.

Q: What reports can I generate using Watershed Climate and Windsurf?

You can list all available report types with listreports. When you know which one you need, use getreport with the correct ID. This fetches formatted output, like CDP disclosures or TCFD summaries, ready for review.

Q: Where do I find my data records when using Watershed Climate and Windsurf?

The tool listuploaddatarecords shows every single activity entry tied to a specific upload container. This lets you review the raw input data before committing to validation or submission.

Q: Can I see the status of my processing job with Watershed Climate and Windsurf?

Absolutely. After running submitupload, you get a task ID. Use gettaskstatus repeatedly; it tells you if the calculation is still pending, in progress, or if something failed.

Q: How can Windsurf manage multiple uploads for Watershed Climate?

You start by listing all containers with listuploads. This gives you a list of existing upload IDs. You then use these IDs to get details via getupload or to append new data using uploaddatarecords.

Automate emissions tracking and reporting goals with Windsurf.

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 Windsurf

Create your Vinkius account to connect Watershed Climate to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage entire data submission workflow.

Need to get a full picture of your carbon footprint? Start by creating an upload container using `create_upload`. After that, you add activity records via `upload_data_records` and validate everything with `validate_upload`. Windsurf handles the whole process flow: grouping data, checking it, and getting ready for submission. Once validated, your agent submits the package using `submit_upload`. You can then monitor progress by calling `get_task_status` until the calculations are done. It's a multi-step sequence that finishes without you having to prompt for each stage.

Inspect detailed emissions inventory data.

Want to see exactly where your company emits carbon? First, list all available inventories with `list_inventories` to find the correct year and scope. Then, use `get_inventory` with a specific ID. This pulls up granular details on Scope 1, Scope 2, and Scope 3 emissions, showing you the composition of your footprint. This tool gives context beyond just total numbers. It lets you drill down into *why* your emissions are what they are, which is critical for planning reductions. You can check out `list_measurements` to see the specific activity types and emission factors used.

Track carbon reduction goals automatically.

Setting targets shouldn't be manual slog work. Use `list_reduction_targets` to pull up your organization's goals—SBTi stuff, net-zero commitments, the works. This shows you the baseline year and the required percentage drop. If you need to adjust data before hitting submit, you can use `update_upload_data_record` or correct mistakes using `delete_upload_data_record`. Windsurf plans these changes into the overall submission goal, letting you track progress toward your targets automatically.

Setup guide

Set up Watershed Climate MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Watershed Climate MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Watershed Climate payment history." If connected, Cascade will call the Watershed Climate tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

You first list all inventories using `list_inventories` to find the specific year you're checking. Then, your agent uses `get_inventory` to pull up detailed information on Scope 1, 2, and 3 emissions for that period.

You can list all available report types with `list_reports`. When you know which one you need, use `get_report` with the correct ID. This fetches formatted output, like CDP disclosures or TCFD summaries, ready for review.

The tool `list_upload_data_records` shows every single activity entry tied to a specific upload container. This lets you review the raw input data before committing to validation or submission.

Absolutely. After running `submit_upload`, you get a task ID. Use `get_task_status` repeatedly; it tells you if the calculation is still pending, in progress, or if something failed.

You start by listing all containers with `list_uploads`. This gives you a list of existing upload IDs. You then use these IDs to get details via `get_upload` or to append new data using `upload_data_records`.

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

Vercel AI SDK sdk-typescript