How to Use the API-Futebol (Brazilian Football) MCP in Pydantic AI

Q: How do I register the API-Futebol (Brazilian Football) toolset in Pydantic AI?

Install the slim MCP package, then initialize MCPToolset with your Vinkius URL. Pass this toolset into the toolsets list of your Agent constructor.

Q: How do I query cup tournaments instead of standard leagues?

Use getcupbrackets to pull the knockout phases and tournament brackets. This tool handles non-round-robin formats automatically.

Build type-safe Brazilian football trackers using Pydantic AI to validate every live score and standing at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect API-Futebol (Brazilian Football) MCP to Pydantic AI

Create your Vinkius account to connect API-Futebol (Brazilian Football) 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 API-Futebol (Brazilian Football) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-Safe Standing Validation

The `get_championship_standings` tool returns structured tables of Brazilian league points. When using Pydantic AI, every row of this table is validated against strict Pydantic models before your agent can read it. If the API schema shifts, your system throws a validation error immediately instead of passing corrupted standings into your application. This guarantees that your UI displays accurate, uncorrupted data.

Strict Live Score Tracking

The `get_live_matches` tool delivers real-time match data directly from active games. Your Pydantic AI agent parses this live stream, ensuring that score integers and team names strictly conform to your defined schemas. By using the unified `MCPToolset` configuration, your agent stays model-agnostic. You can switch from OpenAI to Anthropic models without rewriting your live match parsers.

Error-Free Top Scorer Analysis with MCP Server

The `list_top_scorers` tool retrieves player goals and statistics for a given championship. This MCP Server guarantees that the returned numeric fields map directly to Python floats and integers. Your agent uses these validated numbers to calculate scoring averages without risk of type mismatches. If a player name is missing, the validation layer catches it before it corrupts your analytics.

Setup guide

Set up API-Futebol (Brazilian Football) 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": {
        "api-futebol-brazilian-football-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent API-Futebol (Brazilian Football) 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 API-Futebol. 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 API-Futebol (Brazilian Football) 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 API-Futebol (Brazilian Football) MCP in Pydantic AI

Install the slim MCP package, then initialize `MCPToolset` with your Vinkius URL. Pass this toolset into the `toolsets` list of your Agent constructor.

The framework will raise a validation error instantly. The MCP validation layer prevents your agent from hallucinating football statistics or processing broken API payloads.

Yes. The MCP protocol integration is completely model-agnostic, allowing you to run your football analysis agents on local LLMs or proprietary cloud models.

Use `get_cup_brackets` to pull the knockout phases and tournament brackets. This tool handles non-round-robin formats automatically.

Your requests for championship standings and team stats are processed through ephemeral V8 instances. No persistent storage is used, keeping your queries isolated and secure.

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