How to Use the Brawl Stars MCP in Pydantic AI

Q: Is Brawl Stars club info type-safe in Pydantic AI?

Yes, you define a model for getclub and the framework ensures the response matches. It makes your agent code incredibly reliable for managing complex club stats.

Strictly validate your Brawl Stars data with Pydantic AI and this MCP Server for error-free agent logic.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Brawl Stars MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe Brawl Stars calls

Every response from `get_brawler` is checked against Pydantic models at runtime. If the API returns garbage, your agent stops before making a mistake. This prevents silent corruption in your code. You get a clear validation error the moment something doesn't match the schema.

Battle log verification

Run `get_player_battlelog` and let Pydantic AI enforce the structure of the last 25 matches. Your logic remains predictable and stable. No hallucinated fields will sneak through your models. If the server sends unexpected data, your agent handles the exception gracefully.

Unified toolset integration

Add the MCPToolset to your agent setup to bring all 10 tools online. It's a single, cohesive way to manage the entire Brawl Stars data suite. It works regardless of which LLM you choose. Your code stays clean and your types remain strictly defined throughout the execution.

Setup guide

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

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

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

It provides runtime validation that stops invalid data in its tracks. If the Brawl Stars API changes a field, your agent fails loudly instead of processing wrong information.

Yes, you define a model for `get_club` and the framework ensures the response matches. It makes your agent code incredibly reliable for managing complex club stats.

Install the slim package and use the MCPToolset class. Provide your HTTP endpoint, and your agent will treat the tools as typed functions ready for deployment.

It maps the battle log data to your Pydantic models automatically. This turns unstructured game records into objects your code can actually read and use.

The server uses tokenized access provided by Vinkius. Only the specific, public-facing game records you request are transmitted, ensuring your private data remains isolated from the validation layer.

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