How to Use the Climatiq Carbon Calculations MCP in Pydantic AI

Q: How do I initialize Climatiq Carbon Calculations in Pydantic AI?

Grab the pydantic-ai-slimmcp package. Set up an MCPToolset pointing to your Vinkius URL and pass it to your Agent's toolsets list.

Type-safe carbon accounting for your Pydantic AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Climatiq Carbon Calculations MCP to Pydantic AI

Create your Vinkius account to connect Climatiq Carbon Calculations 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 Climatiq Carbon Calculations with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe Climatiq Carbon Calculations

Sustainability reports require absolute mathematical precision. When your agent calls the `estimate_emissions` tool, Pydantic AI validates every single returned metric against your predefined schemas at runtime. Hallucinated carbon numbers can ruin an audit. If the MCP Server returns unexpected JSON structures, the framework fails loudly with a validation error instead of silently corrupting your database.

Validate emission factors

Building a trustworthy carbon ledger starts with accurate baseline data. Your agent uses `search_emission_factors` to find exact environmental metrics for specific business activities. You can constrain the search parameters using strict types. By exposing `list_regions` and `list_years`, the agent verifies that the selected emission factors match the exact temporal and geographic scope required by your models.

Process batch emissions reliably

Handling bulk sustainability data via MCP requires predictable API responses. The `batch_estimate_emissions` tool processes up to 100 calculations simultaneously while maintaining strict type adherence across the entire array. Converting financial data is equally rigorous. The `estimate_by_classification` tool maps standard ISIC codes to emissions, with Pydantic AI ensuring every industry classification maps cleanly to your internal tracking structures.

Setup guide

Set up Climatiq Carbon Calculations 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": {
        "climatiq-carbon-calculations-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Climatiq Carbon Calculations 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 Climatiq. 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 Climatiq Carbon Calculations 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 Climatiq Carbon Calculations MCP in Pydantic AI

Grab the pydantic-ai-slim[mcp] package. Set up an MCPToolset pointing to your Vinkius URL and pass it to your Agent's toolsets list.

The framework handles batch responses perfectly. It validates the entire JSON array returned by the batch tools against your Pydantic models before letting the agent proceed.

Your agent will catch the mismatch instantly. It can proactively call list_units to verify accepted formats, but if invalid data slips through, the runtime validation throws a strict error.

The framework is completely model-agnostic. You can connect local models, Anthropic, or OpenAI to run these carbon calculations through the standardized protocol.

Security is handled via ephemeral execution. The ISIC codes and specific activity data you send for estimation are processed in a zero-trust V8 isolate that destroys itself the millisecond the response fires.

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