How to Use the API-Football MCP in Vercel AI SDK

Q: How do I filter leagues using API-Football and Vercel AI SDK?

You instruct your agent to use listleagues first to find the correct league ID. Once the ID is found, the agent calls getstandings to render the specific table.

Q: What is the best way to handle tool errors in this setup?

Wrap your createMCPClient calls in standard try-catch blocks and ensure you call mcpClient.close() in your cleanup phase. This prevents memory leaks in your serverless environments.

Pipe real-time match data directly into your React frontends using the Vercel AI SDK and this football MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect API-Football MCP to Vercel AI SDK

Create your Vinkius account to connect API-Football to Vercel AI SDK 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-Football with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Render live scores in Vercel AI SDK apps

The `list_live_fixtures` tool lets your agent grab active matches on the fly. Instead of making your users stare at a blank loading spinner, you pipe these live updates straight into your UI components. This setup works on Edge Functions without breaking a sweat. You get immediate data rendering because the tool results flow through the same stream as your text responses.

Build interactive standings on the edge

Feeding raw league tables to your LLM is easy with `get_standings`. Your Vercel AI SDK implementation translates this raw data into clean, interactive tables right inside the chat interface. You can also pull league structures using `list_leagues` to let users toggle between different tournaments. It keeps your interface fast and interactive without heavy database overhead.

Inject player stats into your AI client components

Retrieving career statistics, cards, and goals is handled by `get_player_info`. Your agent parses this data instantly to build rich UI cards. Combine this with `get_team_info` to show head-to-head context. By using the standard MCP Server protocol, your frontend doesn't need custom API endpoints for every football statistic.

Setup guide

Set up API-Football MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all API-Football tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent API-Football transactions",
});

console.log(text);
await mcpClient.close();

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-Football. 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-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-Football MCP in Vercel AI SDK

Initialize the MCP client using the HTTP transport and pass it to `streamText`. The SDK handles the tool calls automatically, letting you stream live match data directly to your frontend.

Yes, this setup is fully compatible with Edge Functions. The lightweight connection to the MCP Server keeps cold starts low and execution fast.

You instruct your agent to use `list_leagues` first to find the correct league ID. Once the ID is found, the agent calls `get_standings` to render the specific table.

Wrap your `createMCPClient` calls in standard try-catch blocks and ensure you call `mcpClient.close()` in your cleanup phase. This prevents memory leaks in your serverless environments.

No personal data is saved. Only the football league IDs, team names, and match queries pass through the MCP sandbox. Your connection remains completely ephemeral and isolated.

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