Skip to main content
Glama
Tulospalvelu MCP

Tulospalvelu MCP

by jsvirtane

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

  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

  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

Available Tools

12 tools
get_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

    B3.4/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for football-data.org API providing access to football data like standings, matches, teams, and scorers.
      17 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for the PlayMetrics youth-sports club management platform, enabling AI agents to query clubs, teams, players, schedules, registrations, and payments.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that provides access to the public Basketball Vlaanderen (VBL) API, enabling users to query clubs, teams, matches, standings, and more.
      10
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP 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.
      12
      MIT