How to Use the Content ROI Calculator MCP in Pydantic AI

Enforce strict type validation on your marketing metrics using Pydantic AI and the Content ROI Calculator.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Content ROI Calculator MCP to Pydantic AI

Create your Vinkius account to connect Content ROI Calculator to Pydantic AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Content ROI Calculator with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Calculate exact spend with Pydantic AI

Financial math demands precision. Silent failures in cost reporting lead to blown budgets and angry executives. Executing `calculate_total_cost` ensures your agent gathers every writer fee and editing hour accurately. If the API returns a string instead of a float, the framework throws a validation error immediately.

Validate organic revenue estimates

Projecting income from search traffic involves multiple variables. You cannot afford hallucinated conversion rates creeping into your reports. The `calculate_attributed_revenue` tool processes those inputs under strict schema constraints. Your model-agnostic setup guarantees the math holds up whether you run local models or external providers.

Extract typed profitability data from this MCP

Wrapping up a performance review requires hard numbers. You want a clean data structure containing the final return metrics. Triggering `calculate_roi_summary` returns the exact payback period in a predictable format. Your agent gets verified data it can confidently pass to the next stage of your application.

Setup guide

Set up Content ROI Calculator 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": {
        "content-roi-calculator-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

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

Install the slim package with the MCP extra. Use the unified `MCPToolset` class pointing to your HTTP endpoint and pass it into the toolsets array of your Agent.

The framework validates every response against your defined models at runtime. You get absolute certainty that the returned financial numbers match the expected types.

The server must run externally. You connect your agent to it using either Streamable HTTP or SSE transports depending on your network setup.

Yes. The framework is completely model-agnostic. As long as your local model supports tool calling, it can interact with the calculator.

Your production costs and payback periods remain confined to your local runtime. The type checking happens entirely on your machine without transmitting sensitive financial variables to external validation services.

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