How to Use the GameScorekeeper MCP in Pydantic AI

Q: How do I configure GameScorekeeper in Pydantic AI?

Install pydantic-ai-slimmcp. Create an MCPToolset pointing to your HTTP endpoint, then pass that toolset into your Agent constructor.

Enforce strict runtime validation on live sports data with Pydantic AI and the GameScorekeeper integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GameScorekeeper MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate live sports data with Pydantic AI

GameScorekeeper feeds live match data to your agent through tools like `get_fixture_details` and `get_fixture_lineup`. Because sports APIs frequently change their data schemas, Pydantic AI forces every response through your predefined models. If the provider suddenly changes a field name in the lineup array, your agent fails loudly with a validation error. You get a clear stack trace instead of silently writing corrupted stats to your database.

Map tournaments using this MCP Server

The `list_competitions` and `list_competition_stages` tools pull the structural data for global esports and football leagues. You instantiate the `MCPToolset` with your endpoint URL and hand it to your agent. Your agent figures out which leagues are currently active and fetches the corresponding stages. Since the framework is model-agnostic, you can use a fast, cheap local model to map the brackets and save your expensive API calls for complex analysis.

Analyze player and team performance

You retrieve deep historical context using `get_player_stats` and `get_team_form`. The agent pulls the win-loss records and individual player metrics to answer specific user queries about upcoming matchups. The framework ensures the integer types for stats like goals or headshots actually parse as integers. If the API returns a string by mistake, the strict validation catches it before your application attempts to run math operations on the data.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]`. Create an `MCPToolset` pointing to your HTTP endpoint, then pass that toolset into your Agent constructor.

Sports data is notoriously messy. Pydantic AI guarantees that the output from tools like `get_team_details` perfectly matches your application's expected types before any further code executes.

Yes. The framework is entirely model-agnostic. You can connect the MCP server and run your queries through a local Llama instance just as easily as Claude or OpenAI.

The framework throws a validation error immediately. The agent stops execution, preventing hallucinated fields or corrupted data from entering your production systems.

The integration strictly handles public sports metrics, tournament brackets, and live match scores. The connection is ephemeral, meaning the server retains no memory of your queries and cannot access your local file system.

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