How to Use the Emissions API MCP in Pydantic AI

Q: How do I connect the Emissions API MCP Server to a Pydantic AI agent?

Instantiate the unified MCPToolset with your Vinkius HTTP endpoint URL. Pass this toolset directly into the toolsets argument when defining your Pydantic AI agent.

Build type-safe gas tracking agents with Pydantic AI that validate every single emissions data point at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Emissions API MCP to Pydantic AI

Create your Vinkius account to connect Emissions API 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 Emissions API with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate carbon monoxide data using Pydantic AI

The `get_carbon_monoxide` tool returns raw emission values that Pydantic AI validates against strict type schemas before your agent processes them. If the API returns unexpected formats, the Pydantic AI runtime raises a validation error immediately. This prevents silent data corruption in your Pydantic AI pipelines. Your agent works with guaranteed Python types, ensuring that gas concentration metrics map perfectly to your internal database models.

Type-safe geojson parsing with MCP Server

The `get_geojson_emissions` tool delivers spatial geographic data that Pydantic AI parses into structured Python models. The framework validates coordinates and properties before letting your agent build map visualizations. This setup works with any LLM provider connected to Pydantic AI, including Anthropic, OpenAI, or local models. The MCP Server handles the data transport, while Pydantic AI guarantees structural integrity at the application layer.

Track ozone and methane levels with Pydantic AI

The `get_ozone` and `get_methane` tools provide real-time atmospheric readings that your Pydantic AI agent queries during scheduled environmental audits. The schema validation ensures that null values or missing fields trigger loud failures instead of logical bugs. You initialize the unified `MCPToolset` pointing to the Vinkius HTTP endpoint inside your Pydantic AI code. This keeps your codebase clean and avoids deprecated HTTP classes while keeping your environmental data strictly typed.

Setup guide

Set up Emissions API 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": {
        "emissions-api-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

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

Instantiate the unified `MCPToolset` with your Vinkius HTTP endpoint URL. Pass this toolset directly into the `toolsets` argument when defining your Pydantic AI agent.

The Pydantic AI framework immediately throws a validation error instead of letting the agent hallucinate or process bad data. This ensures your gas metrics are always accurate.

Yes, because Pydantic AI is completely model-agnostic. You can connect a local Ollama model to the gas tools, and the framework will still validate all incoming gas readings.

Use the MCP streamable HTTP or SSE transport options. The deprecated server classes should be avoided in favor of the unified toolset interface to guarantee stable connection handling.

Validation occurs entirely in your local Pydantic AI Python runtime, meaning your raw gas data and coordinates are never sent to third-party validation servers. Vinkius operates on a zero-trust architecture, discarding execution memory as soon as the API response completes.

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