Tulospalvelu

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

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.

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