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: Tilastokeskus StatFin MCP Server

Get started

Prerequisites:

• Node.js 20+

Usage

1. Clone the repository

2. Build the application

   npm install
   npm run build

3. Install the MCP

• Codex

  codex mcp add palloliitto \
  --env PALLOLIITTO_ACCEPT_HEADER=<your-accept-header> \
  -- node /absolute/path/to/palloliitto-mcp/dist/server.js

• Claude Code

• Github Copilot CLI

4. Enjoy!

Development

npm install
npm run build
npm run typecheck

Configuration

The server reads configuration from environment variables.

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 Accept request header in Headers-tab and copy its value to use it as PALLOLIITTO_ACCEPT_HEADER env variable

Tools

• search_entities

• list_seasons

• list_competitions

• get_competition

• list_categories

• get_league_table

• list_matches

• get_match

• get_match_score

• list_teams

• get_team

• get_player