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

Q: How do I pass API-Futebol (Brazilian Football) tools to a LangChain agent?

Use MultiServerMCPClient to connect to the Vinkius MCP endpoint, then call client.gettools() to retrieve the tools. Pass this list directly to your LangChain createagent function to expose the Brazilian football database to your agent.

Q: Can I trace API-Futebol (Brazilian Football) tool calls in LangChain using LangSmith?

Yes, every tool invocation like getlivematches or listtopscorers shows up in your LangSmith dashboard. You can inspect the input parameters, raw JSON outputs, and token costs for every Brazilian league query run by your LangChain agent.

Q: What is the process for handling state when querying API-Futebol (Brazilian Football) with LangChain?

The client is stateless by default, but you can use client.session() to keep context active across multiple steps in your LangChain runs. This allows your agent to remember which Brazilian championship it is currently analyzing between chain steps.

Q: How can I handle API rate limits during live match tracking?

Run the getapistatus tool to check your remaining quota before running heavy loops. You can write a custom LangChain run helper that pauses execution if your API-Futebol usage limits are close to expiring.

Feed live Brasileirão stats directly into your LangChain reasoning loops to build autonomous sports analysis agents.

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 LangChain

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build multi-step Brazilian football chains with LangChain

The API-Futebol (Brazilian Football) MCP Server exposes twelve tools like `list_championships` and `get_championship_standings` that feed raw data straight into your LangChain decision loops. Your agent calls `list_championships` to identify the right league ID, passes that output to `list_championships` to locate the active round, and fetches match outcomes without hardcoded logic. LangSmith traces every step of this sequence so you see exactly how your agent parses the league standings or team data. If an agent struggles to find a specific club, you trace the exact query sent to `search_teams` and inspect the returned JSON payload.

Real-time match tracking in LangGraph pipelines

This MCP Server provides direct access to live game events through `get_live_matches` and `get_match_details` to feed your LangGraph workflows. Your LangGraph agents run loops that check active matches every minute, comparing live scores against historical trends pulled via `get_team_matches`. You write clean, deterministic state charts where a shift in match status triggers downstream analysis. The agent switches from monitoring live play to pulling final statistics through `get_round_details` as soon as the referee blows the final whistle.

Automated top scorer and bracket analysis

The MCP Server exposes `list_top_scorers` and `get_cup_brackets` to feed your LangChain analytical steps. Your LangChain agent evaluates cup performance by tracking how teams progress through brackets while cross-referencing individual player goals. This structured data feeds directly into your prompt templates, letting the agent generate weekly summaries of the Copa do Brasil or regional state leagues. You avoid manual data entry by letting the model fetch the latest standings dynamically mid-run.

Setup guide

Set up API-Futebol (Brazilian Football) MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes API-Futebol (Brazilian Football) tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "api-futebol-brazilian-football-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent API-Futebol (Brazilian Football) transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Use `MultiServerMCPClient` to connect to the Vinkius MCP endpoint, then call `client.get_tools()` to retrieve the tools. Pass this list directly to your LangChain `create_agent` function to expose the Brazilian football database to your agent.

Yes, every tool invocation like `get_live_matches` or `list_top_scorers` shows up in your LangSmith dashboard. You can inspect the input parameters, raw JSON outputs, and token costs for every Brazilian league query run by your LangChain agent.

The client is stateless by default, but you can use `client.session()` to keep context active across multiple steps in your LangChain runs. This allows your agent to remember which Brazilian championship it is currently analyzing between chain steps.

Run the `get_api_status` tool to check your remaining quota before running heavy loops. You can write a custom LangChain run helper that pauses execution if your API-Futebol usage limits are close to expiring.

Vinkius runs the MCP server in an isolated sandbox, meaning your API tokens and football query parameters never touch the public internet. Only the raw, non-sensitive match statistics and league tables pass back to your local LangChain session.

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