MCP for assistants

Free

Connect Claude, ChatGPT or any client that speaks the Model Context Protocol, and ask about rugby in plain words. Every endpoint is a tool the assistant can call with your key: the same plan, the same daily allowance, the same data.

POSThttps://api.rugbyapi.com/mcpGet a free key

Connect

Add a remote MCP server with the address above, over HTTP, and send your key as Authorization: Bearer. No session to keep: each call stands on its own.

What it can do

42 tools, one for each endpoint: matches, lineups, timelines, tables, teams, players, stats, search and national-side rankings.

What it counts

Each tool call is one lookup, as in the API. A free key's limits apply to the assistant too; Archive opens every season.

Client settings

For a client that reads an mcpServers file (Claude Desktop, Claude Code, Cursor and others):

{
    "mcpServers": {
        "rugbyapi": {
            "type": "http",
            "url": "https://api.rugbyapi.com/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_KEY"
            }
        }
    }
}

Try asking: "Who leads the Top 14 this season?", "Show the scoring timeline of the last Leinster v Munster match", "How has Japan's rating moved since 2019?"

The tools

Tool	What it does
`list_matches`	Every match in a date range, filtered by competition, team or status. Paged, newest first. Works on a free key. Endpoint: /v1/matches
`get_match`	One match in full: competition, season, round, venue, scores, half time and the quality flags. Add lineups and the timeline with include. Works on a free key. Endpoint: /v1/matches/{id}
`lineups`	Both matchday squads with shirt numbers, starter or replacement, position and captain. Needs Archive. Endpoint: /v1/matches/{id}/lineups
`timeline`	Every try, conversion, penalty, drop goal and card to the minute, with the player and the score after it. Needs Archive. Endpoint: /v1/matches/{id}/timeline
`fixtures`	Matches still to be played in the next days, nearest first. Kickoff times appear as soon as they are set. Works on a free key. Endpoint: /v1/fixtures
`results`	Finished matches since a date, newest first, with the final score. Results land within two hours of full time. Works on a free key. Endpoint: /v1/results
`today`	Every match today in the time zone you choose, with the local kickoff time. Needs Live. Endpoint: /v1/matches/today
`live`	Matches in play: the score, the period, every try, kick and card, and the match clock as a point your app counts on from. Read every 2 minutes while in play and pushed to your webhooks as it changes. Also lists every fixture of the next 7 days we follow live, so you know which games will be covered. Needs Live. Endpoint: /v1/matches/live
`competitions`	Every competition with matches or a table in the archive, with its region, type and how many seasons are on record. Works on a free key. Endpoint: /v1/competitions
`seasons`	Every season of one competition that has matches or a table, newest first. Needs Archive. Endpoint: /v1/competitions/{id}/seasons
`standings`	The table for a season: played, won, drawn, lost, points for and against, difference, bonus points and total. Works on a free key. Endpoint: /v1/seasons/{id}/standings
`season_matches`	Every fixture and result of one season, oldest first, 50 a page. Needs Archive. Endpoint: /v1/seasons/{id}/matches
`team`	A team's name, tag, country and type, the competitions it has played in over the last year, and its squad size. Works on a free key. Endpoint: /v1/teams/{id}
`squad`	Every player a team currently lists, with position, nationality and date of birth where published. Needs Archive. Endpoint: /v1/teams/{id}/squad
`form`	A team's last results, newest first, with W, D or L for each and the run as one string. Needs Archive. Endpoint: /v1/teams/{id}/form
`h2h`	Every finished meeting between two teams, newest first, with the running record. Needs Archive. Endpoint: /v1/head-to-head
`team_matches`	Every match a team has played or will play, newest first, optionally one season. Needs Archive. Endpoint: /v1/teams/{id}/matches
`rankings`	Ratings and ranks of the men's national sides, worked out by us from every Test since 1871 with World Rugby's published points-exchange method. Our own figures, not World Rugby's rankings. Works on a free key. Endpoint: /v1/rankings
`player`	A player's name, date of birth, nationality, position, current team and status, where published. Needs Archive. Endpoint: /v1/players/{id}
`player_seasons`	Appearances, starts, tries, kicks, cards and points for each competition and season. Needs Archive. Endpoint: /v1/players/{id}/seasons
`player_career`	A player's totals for each competition across every season, plus career totals. Needs Archive. Endpoint: /v1/players/{id}/career
`player_matches`	Every match a player was named in, newest first, with shirt, role and what they scored. Needs Archive. Endpoint: /v1/players/{id}/matches
`top_scorers`	Leading points scorers in a match or a season, optionally one team, built from the timelines. Top 25. Needs Archive. Endpoint: /v1/stats/top-scorers
`try_scorers`	Most tries in a match or a season, optionally one team. Top 25. Needs Archive. Endpoint: /v1/stats/try-scorers
`discipline`	Yellow and red cards by player in a match or a season, optionally one team. Top 25. Needs Archive. Endpoint: /v1/stats/discipline
`search`	Find a competition, team or player by name and get its ID. Works on a free key. Endpoint: /v1/search
`usage`	Your plan, lookups used today and what is left. Free to call; it does not count. Works on a free key. Endpoint: /v1/usage
`status`	How fresh the archive is, with the same results rule as the status page: quiet days are not late. Needs no key. Works on a free key. Endpoint: /v1/status
`an_scoring_bands`	When a team scores and concedes, in ten-minute bands, with halves and the last ten minutes. Needs Live. Endpoint: /v1/analytics/scoring-bands
`an_game_state`	Half-time leads, comebacks, lead changes and close games, replayed from the running score. Needs Live. Endpoint: /v1/analytics/game-state
`an_bonus_points`	Try bonus and losing bonus rates, home and away, next to the official table. Needs Live. Endpoint: /v1/analytics/bonus-points
`an_discipline`	Yellow and red cards and what they cost: points scored and conceded while a player is off. Needs Live. Endpoint: /v1/analytics/discipline
`an_goal_kicking`	Conversions landed out of tries scored, per team and per kicker, plus penalty and drop goals. Needs Live. Endpoint: /v1/analytics/goal-kicking
`an_bench`	What replacements add: points, tries and cards from the bench against the starting XV. Needs Live. Endpoint: /v1/analytics/bench
`an_rotation`	How settled a team is: players used, changes to the starting XV, and the usual pairings. Needs Live. Endpoint: /v1/analytics/rotation
`an_home_advantage`	Home and away win rates and margins, by team, competition and season. Needs Live. Endpoint: /v1/analytics/home-advantage
`an_totals`	Total points and winning margins: averages, how often common lines are crossed, and margin bands. Needs Live. Endpoint: /v1/analytics/totals
`an_referees`	Each referee against the average: home win rate, points, close games, cards and penalty goals. Needs Live. Endpoint: /v1/analytics/referees
`an_weather`	Results by the conditions at kickoff: rain, wind and temperature, with points, tries and home wins. Needs Live. Endpoint: /v1/analytics/weather
`an_rest_travel`	Days of rest since the last match and distance from home, against wins and margins. Needs Live. Endpoint: /v1/analytics/rest-travel
`an_first_try`	Who scores the first try and when, the first scoring play, and how often the first try scorer's side wins. Needs Live. Endpoint: /v1/analytics/first-try
`an_crowds`	Attendance by team, ground and season: averages, peaks and the share of the ground filled. Needs Live. Endpoint: /v1/analytics/crowds

Errors come back as a tool result marked as an error, with the same codes as the API: a key that is missing or rotated, a plan below the tool's, or today's lookups used up. All error codes