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.

Get started

Prerequisites:

• Node.js 20+

Usage

1. Clone the repository

1. Build the application

   npm install
   npm run build

1. 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

1. Enjoy!

Development

npm install
npm run build
npm run typecheck

Configuration

The server reads configuration from environment variables.

| Variable | Required | Default | | -------------------------------- | -------- | ------------------------------------- | | PALLOLIITTO_BASE_URL | No | https://spl.torneopal.net/taso/rest | | PALLOLIITTO_ACCEPT_HEADER | Yes | - | | PALLOLIITTO_REQUEST_TIMEOUT_MS | No | 10000 |

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