How to Use the EIA Coal & Mining — Solid Fuels Intelligence MCP in Pydantic AI

Validate coal data with EIA Coal & Mining — Solid Fuels Intelligence and Pydantic AI for type-safe agent logic.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EIA Coal & Mining — Solid Fuels Intelligence MCP to Pydantic AI

Create your Vinkius account to connect EIA Coal & Mining — Solid Fuels Intelligence 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 EIA Coal & Mining — Solid Fuels Intelligence with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Coal Market Intelligence

Use `get_coal_prices` and `get_coal_production` within Pydantic AI to ensure every response matches your defined schemas. If the API returns malformed or unexpected data, your agent catches the validation error immediately. This prevents silent failures in your coal market models. Your agent only acts on data that strictly conforms to your expected types, providing a stable foundation for your energy analysis.

Rigorous Quality and Mine Data Validation

Implement `get_mine_production` and `get_coal_quality` to pull verified metrics into your agent. Pydantic AI checks these results at runtime, ensuring heat content and sulfur figures are always valid numbers. Your agent logic stays clean because it never handles hallucinated fields or unexpected formats. It enforces a strict contract between the EIA data and your internal processing code.

Structured Trade and Reserve Reporting

Integrate `get_coal_trade` and `get_coal_reserves` to build type-safe reports on fuel availability. Your agent uses these tools to pull trade volumes and stock levels, validating every digit against your Pydantic models. This approach ensures that your agent's decision-making is based on verified, structured info. You get reliable data flow that respects your defined constraints at every step of the process.

Setup guide

Set up EIA Coal & Mining — Solid Fuels Intelligence 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": {
        "eia-coal-mining-solid-fuels-intelligence-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to EIA Coal & Mining — Solid Fuels Intelligence tools.",
)

result = await agent.run("List recent EIA Coal & Mining — Solid Fuels Intelligence 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 EIA. 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 EIA Coal & Mining — Solid Fuels Intelligence 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 EIA Coal & Mining — Solid Fuels Intelligence MCP in Pydantic AI

Pydantic AI triggers a validation error if the server output fails your model schema. This prevents your agent from proceeding with corrupted data, ensuring your logic remains sound.

You initialize an MCPToolset with the server's HTTP URL. This adds the tools to your agent's registry, allowing it to validate incoming responses against your models automatically.

Yes, because the validation happens at the Pydantic level, the server works with any model you use. Whether you choose OpenAI, Anthropic, or local LLMs, your agent maintains the same strict data standards.

The connection uses encrypted SSE or HTTP transports provided by Vinkius. You manage your connection via a single endpoint token, ensuring your agent's access remains authenticated and secure.

Your requests are processed in an ephemeral V8 Isolate Sandbox. This server acts as a stateless conduit, ensuring that your specific coal data queries are never stored, traced, or shared beyond your immediate agent session.

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