How to Use the Riot Games MCP in Pydantic AI

Q: How does Pydantic AI validate Riot Games match data at runtime?

The framework wraps the getmatch tool outputs in Pydantic models. If any field like gold earned or damage dealt deviates from the expected type, the agent raises a validation error instantly.

Q: Can I use Pydantic AI to fetch ranked standings from Riot Games?

Yes, the getleagueentries tool returns structured tier, rank, and LP data. Your agent validates these fields against predefined enums, ensuring you never process invalid rank values.

Q: What transport does Pydantic AI use to connect to this Riot Games MCP Server?

It connects via the MCPToolset using either Streamable HTTP or SSE transports. You point the toolset to your Vinkius-hosted endpoint, and it auto-discovers all 12 tools.

Q: How do I resolve player IDs without causing validation errors?

Use getaccountbyriotid to get the PUUID first. Since the returned object is strictly typed, your agent can safely pass the validated PUUID to getchampionmasteries or getsummonerbyid.

Run type-safe Riot Games data queries with Pydantic AI and our MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Riot Games MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Type-Safe Match Parsing with Pydantic AI

The `get_match` tool retrieves deep match details that are instantly validated against strict schemas by your Pydantic AI agent. If the Riot Games API structure changes or returns unexpected nulls, the Pydantic AI framework raises a validation error immediately rather than letting corrupted data break your app. This strict validation is crucial when processing historical League match data from `get_match_ids`. You get guaranteed type safety across every player statistic, item build, and match outcome in Pydantic AI.

Guaranteed Summoner Profile Schemas

The `get_summoner_by_puuid` tool returns essential account metadata that your Pydantic AI setup validates at runtime. This ensures that fields like summoner level, profile icon ID, and revision date strictly match your internal Pydantic AI models. When translating Riot IDs via `get_account_by_riot_id`, you can be certain the returned PUUID format is correct before passing it to subsequent tools. The MCP Server acts as a reliable data source that keeps your type-checked League pipeline solid.

Validated Live Game Monitoring

The `get_active_game` tool delivers live lobby statistics directly to your Pydantic AI toolset over MCP. Since active League games contain complex nested structures like runes, banned champions, and active spells, Pydantic AI runtime validation prevents your agent from hallucinating player matchups. If a lookup fails because a player is offline, the MCP Server returns a clean 404 that your Pydantic AI agent catches. This allows you to build reliable, crash-resistant live trackers that always know when a League match is actually in progress.

Setup guide

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

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

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

The framework wraps the `get_match` tool outputs in Pydantic models. If any field like gold earned or damage dealt deviates from the expected type, the agent raises a validation error instantly.

Yes, the `get_league_entries` tool returns structured tier, rank, and LP data. Your agent validates these fields against predefined enums, ensuring you never process invalid rank values.

It connects via the `MCPToolset` using either Streamable HTTP or SSE transports. You point the toolset to your Vinkius-hosted endpoint, and it auto-discovers all 12 tools.

Use `get_account_by_riot_id` to get the PUUID first. Since the returned object is strictly typed, your agent can safely pass the validated PUUID to `get_champion_masteries` or `get_summoner_by_id`.

Your developer key is securely hosted on Vinkius within a zero-trust sandbox. Your local agent only needs a single secure endpoint token, keeping your sensitive Riot credentials isolated from local client code.

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