pydantic-mcp

What is pydantic-mcp?

pydantic-mcp is a Python package that enables Model Context Protocol (MCP) tool calling support for Pydantic AI. It converts an MCP client session into a list of pydantic_ai.Tool instances for use with Pydantic AI agents. The package is now superseded by built-in MCP support in PydanticAI.

How to use pydantic-mcp?

Create an mcp.ClientSession and call tools = await mcptools(session) to get a list of pydantic_ai.Tool instances for the supported MCP tools. The package is runnable as a demo against Groq’s llama-3.1-8b-instant model using an environment variable GROQ_API_KEY.

Key features of pydantic-mcp

• Converts MCP tools to Pydantic AI Tool instances
• Works with any MCP-compliant server (e.g., filesystem)
• Simple one-call integration: mcptools(session)
• Provides a ready-to-run demo using Groq LLM

Use cases of pydantic-mcp

• Connect an LLM agent to MCP‑enabled tools (e.g., file system, databases)
• Read and summarize files via a secure MCP filesystem server
• Leverage Pydantic AI’s tool‑calling with any MCP server

FAQ from pydantic-mcp

Is pydantic-mcp still maintained?

No. PydanticAI now includes native support for MCP servers. Users should migrate to ai.pydantic.dev/mcp/ instead.

What models does the demo work with?

The demo is shown with Groq’s llama-3.1-8b-instant model; any model supported by Pydantic AI can be used with the Tool instances obtained.

How do I install pydantic-mcp?

The README does not include explicit installation instructions, but it uses uv run tests/demo.py and assumes a GROQ_API_KEY.

Does it support any MCP server?

Yes. The package converts any mcp.ClientSession — the demo uses a secure filesystem server, but any MCP server can be used.

Is there a pricing or license?

The package is distributed under the MIT License (as indicated in the demo summary of the LICENSE file).