How to integrate Api sports MCP with Codex

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Api sports MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Api sports logoApi sports
Api Key

Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.

67 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Api sports MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Api sports with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Api sports MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the Api sports MCP server, and what's possible with it?

The Api sports MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Api sports account. It provides structured and secure access to rich sports data, so your agent can fetch fixtures, analyze team stats, retrieve player info, and explore historical match data on your behalf.

  • Live fixture and match retrieval: Instantly access upcoming and past football fixtures, filterable by league, team, date, or season for up-to-date match information.
  • Detailed match statistics and events: Have your agent pull granular match data, including goals, cards, substitutions, and in-depth statistics like possession, fouls, and passes for any fixture.
  • Team, coach, and player insights: Effortlessly fetch team rosters, coach histories, and individual player statistics or injury reports, making it easy to analyze team lineups and track player performance over time.
  • Head-to-head comparisons and historical data: Ask your agent to compare two teams’ direct matchups, review historical data, or examine league rounds, helping you make informed predictions or reports.
  • Dynamic country and league exploration: Let your agent discover available countries, leagues, and competitions, then drill down by code or search to tailor your sports data queries to specific needs.

Conclusion

You've successfully integrated Api sports with Codex using Composio's MCP server. Now you can interact with Api sports directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Api sports operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Api sports operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Api sports action and event your agent gets out of the box.

Get AFL Games

Tool to retrieve AFL games and matches.

Get AFL Game Player Statistics

Tool to retrieve player statistics from AFL (Australian Football League) game(s).

Get AFL Seasons

Tool to get the list of available seasons for AFL.

Get AFL Standings

Tool to retrieve AFL standings for a league.

Get Baseball Games Head-to-Head

Tool to get head-to-head baseball games between two teams.

Get Basketball Bets

Tool to get all available basketball bet types.

Get Basketball Bookmakers

Tool to get all available basketball bookmakers.

Get basketball statistics

Tool to get basketball statistics for a team in a given league and season.

Get Formula 1 Circuits

Tool to get the list of available Formula 1 circuits.

Get Coaches

Tool to fetch coaches and their career history.

Get Countries

Tool to fetch available countries for league queries.

Get Fighters Records

Tool to get fighter career statistics.

Get Fixtures

Tool to retrieve football fixtures/matches.

Get fixtures events

Tool to get events (goals, cards, substitutions, VAR, etc.

Get Head-to-Head Fixtures

Tool to get head-to-head fixtures between two teams.

Get Fixture Lineups

Tool to retrieve starting XI and substitutes for a fixture.

Get fixtures players

Tool to get player statistics from a fixture.

Get Fixtures Rounds

Tool to get the rounds for a league or cup.

Get fixture statistics

Tool to get statistics for a fixture.

Get Formula 1 Competitions

Tool to retrieve Formula 1 competitions (Grand Prix races).

Get Formula 1 Races

Tool to retrieve Formula 1 race information for a given season.

Get Formula 1 Starting Grid

Tool to retrieve the starting grid for a Formula 1 race.

Get games events

Tool to get events (goals, penalties, etc.

Get AFL Games Quarters

Tool to retrieve AFL game quarter scores.

Get game statistics by teams

Tool to get team statistics from a game by ID.

Get Injuries

Tool to get injured or suspended players.

Get Leagues

Tool to retrieve leagues and cups.

Get League Seasons

Tool to get the list of available seasons for all leagues.

Get MMA Categories

Tool to fetch the list of all available MMA categories.

Get MMA Fighters

Tool to fetch MMA fighters data.

Get MMA Fights

Tool to retrieve the list of MMA fights according to given parameters.

Get MMA Fight Results

Tool to retrieve results from one or several MMA fights.

Get MMA Fighter Statistics

Tool to get fighter statistics from MMA fights.

Get NBA game statistics

Tool to get NBA game statistics including player stats for both teams.

Get NFL Standings Conferences

Tool to retrieve the list of available conferences for the NFL to be used in the standings endpoint.

Get Odds

Tool to fetch pre-match odds.

Get Odds Bets

Tool to get all available pre-match bet types.

Get Odds Bookmakers

Tool to list all available pre-match bookmakers.

Get In-Play Odds

Tool to fetch in-play odds for fixtures in progress.

Get Live Odds Bets

Tool to fetch all available bet types for in-play odds.

Get Odds Mapping

Tool to get the list of available fixture IDs for the odds endpoint.

Get Players

Tool to get player statistics.

Get Players Profiles

Tool to get the list of all available players.

Get Players Seasons

Tool to list all available seasons for player statistics.

Get Players Squads

Tool to get player squads.

Get player statistics

Tool to get player statistics for a specific basketball game.

Get Players Teams

Tool to get the list of teams and seasons in which a player played during his career.

Get Players Top Assists

Tool to get the 20 best players (top assists) for a league or cup.

Get Players Top Red Cards

Tool to get the 20 players with the most red cards for a league or cup.

Get Players Top Scorers

Tool to get the 20 best players (top scorers) for a league or cup.

Get Players Top Yellow Cards

Tool to get the 20 players with the most yellow cards for a league or cup.

Get Predictions

Tool to get predictions about a fixture.

Get Formula 1 Driver Rankings

Tool to retrieve Formula 1 driver rankings for a season.

Get Fastest Laps Rankings

Tool to get the ranking of the fastest laps for a Formula 1 race.

Get Race Rankings

Tool to retrieve rankings for a specific Formula 1 race.

Get Formula 1 Team Rankings

Tool to retrieve Formula 1 team rankings for a specific season.

Get Sidelined

Tool to get sidelined information (injuries, suspensions, etc.

Get Standings Divisions

Tool to retrieve the list of available divisions for an NFL competition to be used in the standings endpoint.

Get Standings Groups

Tool to retrieve the list of available groups for a league to be used in the standings endpoint.

Get Standings Stages

Tool to retrieve the list of available stages for a league to be used in the standings endpoint.

Get Teams

Tool to retrieve available teams.

Get Team Seasons

Tool to get the list of seasons available for a team.

Get team statistics

Tool to get detailed statistics of a team for a given league and season.

Get Timezone

Tool to fetch the complete list of available timezones for fixture queries.

Get Transfers

Tool to get all available transfers for players and teams.

Get Trophies

Tool to get trophies for a player or coach.

Get Venues

Tool to retrieve available venues.

FAQ

Frequently asked questions

With a standalone Api sports MCP server, the agents and LLMs can only access a fixed set of Api sports tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Api sports and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Api sports tools.

Yes, absolutely. You can configure which Api sports scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Api sports data and credentials are handled as safely as possible.

Start with Api sports.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Api sports tool your agent needs.Free to start.

Start building