How to Use the Watershed Climate MCP in Pydantic AI

Q: How does Pydantic AI ensure accuracy with Watershed Climate?

Pydantic AI validates the entire MCP workflow. If submitupload returns unexpected data, your agent fails loudly with a clear validation error. This means you know instantly if there's an issue, rather than getting bad results.

Q: What is the process for checking Watershed Climate report generation?

Your agent first calls listreports to see what reports are available (CDP, TCFD, etc.). Then, it uses getreport to access all generated files and summarized emission data securely.

Q: Can I check the status of a processing task using Pydantic AI?

Yes. After you submit an upload for calculation, submitupload gives you a task ID. The agent then repeatedly calls gettaskstatus to monitor Watershed Climate's progress until the job is complete.

Validate carbon data submissions with Pydantic AI's type safety.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Structure and Upload Activity Data

The `upload_data_records` tool allows your agent to upload structured activity records—think electricity consumption or flights. Since this is a production system, the Pydantic AI client ensures that every record adheres to required fields like quantity and unit. You'll never get silent data corruption.

Manage Data Lifecycle with MCP Server

If you need to clean up or adjust data before processing, the agent can first list all uploads using `list_uploads`. It then uses `delete_upload_data_record` for removal or `update_upload_data_record` for corrections. This control gives you full oversight of the entire activity dataset.

Monitor Reduction Targets and Inventories

To keep your organization accountable, use `list_reduction_targets` to track progress toward net-zero goals. Additionally, checking all GHG inventories via `list_inventories` gives a quick status check on Scope 1, 2, and 3 emissions year by year.

Setup guide

Set up Watershed Climate MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "watershed-climate-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Watershed Climate tools.",
)

result = await agent.run("List recent Watershed Climate transactions")
print(result.output)

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 Pydantic AI

Pydantic AI validates the entire MCP workflow. If `submit_upload` returns unexpected data, your agent fails loudly with a clear validation error. This means you know instantly if there's an issue, rather than getting bad results.

Your agent first calls `list_reports` to see what reports are available (CDP, TCFD, etc.). Then, it uses `get_report` to access all generated files and summarized emission data securely.

Yes. After you submit an upload for calculation, `submit_upload` gives you a task ID. The agent then repeatedly calls `get_task_status` to monitor Watershed Climate's progress until the job is complete.

The Pydantic AI framework prevents this. It forces validation via `validate_upload`. If there's a quality issue, the agent stops and reports the specific error before submitting anything to Watershed Climate.

The server handles Activity Data Records. The Pydantic AI client reads these records, validates their structure, and then submits them for conversion into measurable emissions figures in Watershed Climate.

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