Tulospalvelu MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tulospalvelu MCP show me the league table for Veikkausliiga 2024"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tulospalvelu MCP
Read-only MCP server for the Palloliitto's result service API.
Features
Connect AI applications to Palloliitto's result service data.
Search clubs, teams, players, competitions and venues data through the open search endpoint for football & futsal.
Find and inspect match data.
Discover competitions, historical season data.
Inspect league tables, player statistics, and optional embedded group matches.
Return normalized, LLM-friendly JSON payloads over MCP
stdio.
Related MCP server: playmetrics_mcp
Get started
Prerequisites:
Node.js 20+
Usage
Clone the repository
Build the application
npm install npm run buildInstall the MCP
codex mcp add palloliitto \ --env PALLOLIITTO_ACCEPT_HEADER=<your-accept-header> \ -- node /absolute/path/to/palloliitto-mcp/dist/server.js
Enjoy!
Development
npm install
npm run build
npm run typecheckConfiguration
The server reads configuration from environment variables.
Variable | Required | Default |
| No |
|
| Yes | - |
| No |
|
Acquiring PALLOLIITTO_ACCEPT_HEADER
Open Palloliitto's result service
Open browser's developer tools
Locate network tab
Initiate search from the page
Locate related network event
search?text=<your-search-string>Look for
Acceptrequest header in Headers-tab and copy its value to use it as PALLOLIITTO_ACCEPT_HEADER env variable
Tools
search_entitieslist_seasonslist_competitionsget_competitionlist_categoriesget_league_tablelist_matchesget_matchget_match_scorelist_teamsget_teamget_player
Available Tools
12 toolsget_competitionGet CompetitionB
Get a single competition by its Palloliitto competition ID.
Inputs: competitionId (required).
get_league_tableGet League TableB
Get detailed league table data, standings, player statistics, and optionally matches for a single group.
Inputs: groupId (required), categoryId (required), competitionId (required), includeMatches.
get_matchGet MatchC
Get detailed match data for a single match ID.
Inputs: matchId (required).
get_match_scoreGet Match ScoreC
Get the current or final score for a single match ID.
Inputs: matchId (required).
get_playerGet PlayerB
Get player details by Palloliitto player ID.
Inputs: playerId (required).
get_teamGet TeamA
Get current roster data for a team, or historical roster data when competitionId and categoryId are both provided.
Inputs: teamId (required), categoryId, competitionId.
list_categoriesList CategoriesC
List categories for a competition.
Inputs: competitionId (required).
list_competitionsList CompetitionsC
List competitions by season and organiser filters.
Inputs: current, official, seasonId, organiser.
list_matchesList MatchesC
List matches by date and filters, or run Taso text search mode.
Inputs: date, text, clubId, teamId, +13 more.
list_seasonsList SeasonsC
List seasons for a sport. Football is the default.
Inputs: sport.
list_teamsList TeamsC
List teams in a competition, optionally filtered by category.
Inputs: competitionId (required), categoryId.
search_entitiesSearch EntitiesC
Search Palloliitto entities such as competitions, categories, clubs, teams, players, venues, and matches.
Inputs: text (required), limit, types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool has a clearly distinct purpose. For example, get_match returns detailed match data while get_match_score returns only the score, and list_competitions vs get_competition differentiate between listing and single retrieval. No two tools overlap in functionality.
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_competition, list_matches, search_entities). There are no deviations or mixed conventions, making it predictable for agents.
With 12 tools, the set is well-scoped for a sports data service covering competitions, teams, matches, players, and standings. It provides sufficient granularity without being excessive or too sparse.
The tool surface covers the core domain of a football data API comprehensively: listing and retrieving competitions, seasons, categories, teams, matches, scores, league tables, players, and a general search. While it is read-only, it handles all typical query operations with no obvious gaps.
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Read-only MCP server for public WeJob jobs, formations, and companies.
Public, read-only MCP server for FarmNeural company facts, packages, and capabilities.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for football-data.org API providing access to football data like standings, matches, teams, and scorers.17 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server for the PlayMetrics youth-sports club management platform, enabling AI agents to query clubs, teams, players, schedules, registrations, and payments.1MIT
- AlicenseAqualityDmaintenanceA read-only MCP server that provides access to the public Basketball Vlaanderen (VBL) API, enabling users to query clubs, teams, matches, standings, and more.10MIT
- AlicenseAqualityCmaintenanceMCP server for the FootballStack football data API. Gives LLM clients and AI agents (Claude, Cursor) access to real football data — fixtures, standings, lineups, live events, shot-level xG with pitch coordinates, and model-derived fair odds.12MIT