How to Use the Meltwater MCP in Pydantic AI

Q: Can I use Pydantic AI to validate Meltwater search analytics?

Yes. When your agent calls getsearchanalytics, the framework validates the numerical trends and volume metrics against your Pydantic models, ensuring your reporting pipeline receives perfectly structured data.

Q: How do I configure the Meltwater MCP Server inside my Pydantic AI codebase?

You instantiate the MCPToolset with your Vinkius HTTP endpoint. Then, pass the toolset directly into your Agent constructor's toolsets parameter to expose all 10 media monitoring tools to your model.

Build type-safe media monitoring agents with Meltwater and Pydantic AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Meltwater MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Media Intelligence with Pydantic AI

When your agent calls `get_mention_details` or `get_media_insights` through this MCP Server, Pydantic AI validates the incoming JSON against strict Python type schemas at runtime. If Meltwater updates their response structure, your agent catches it instantly instead of silently failing. This type safety ensures that downstream tasks, like posting alerts to Slack or updating internal databases, always receive clean, predictable data. You can write your business logic with absolute confidence that your data models match reality.

Validated Search and Content Retrieval

Running `search_content` through this MCP Server setup allows your agent to parse raw search results into structured Python objects automatically. The model-agnostic nature of the framework means you can swap LLM providers behind the scenes without changing your validation logic. You can also fetch specific search configurations using `get_search_details` to verify that your agent is querying the correct keywords. It keeps your media intelligence pipeline structured, predictable, and incredibly easy to test.

Structured Metadata and Tag Auditing

Your agents can use `list_tags` and `list_media_sources` to retrieve your exact organizational structure directly from your account. The framework validates every tag and source name, preventing your LLM from inventing fake categories. When you need to pull high-level analytics, `get_search_analytics` delivers structured metrics that map perfectly to your custom Pydantic models. It is the cleanest way to build production-grade PR reporting tools that never hallucinate.

Setup guide

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

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

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

If the API returns a payload that doesn't match your schema, Pydantic AI raises a validation error immediately. This prevents your agent from processing corrupt data when running tools like `get_mention_details`.

Yes. When your agent calls `get_search_analytics`, the framework validates the numerical trends and volume metrics against your Pydantic models, ensuring your reporting pipeline receives perfectly structured data.

You instantiate the `MCPToolset` with your Vinkius HTTP endpoint. Then, pass the toolset directly into your `Agent` constructor's `toolsets` parameter to expose all 10 media monitoring tools to your model.

Yes. While Vinkius hosts the production MCP Server securely, you can connect your Pydantic AI agent to the external endpoint using standard SSE or Streamable HTTP transports during local testing.

Your credentials are encrypted and passed directly to the Meltwater API via the ephemeral Vinkius V8 sandbox. None of your brand analytics, search queries, or mention details are ever cached or logged on our servers.

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