chess-results
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
chess-results
Tools for Chess-Results — for AI agents and the terminal.
Queries — players (tournament appearances, national idents, FIDE ids, ratings, player cards), tournaments, any tournament page as data (rankings, pairings, round results, team compositions, tables), and the leagues of an Austrian championship season. No login needed.
Team result entry — from a photographed paper match report to saved results. Every player is checked against both clubs' member lists and the teams' rosters on Chess-Results, missing idents are looked up, Chess-Results' own check runs, and results are saved only after explicit confirmation.
One folder, four ways in: a Claude Code plugin, an OpenClaw plugin or skill, an MCP server for any MCP client (Codex, …), and a command line.
Chess-Results has no API. The client reads its public pages and replays the website's own forms, spacing and caching its requests.
Install
You need Python 3.11+ and the packages in requirements.txt:
pip install -r requirements.txtClaude Code
/plugin marketplace add odrobnik/chess-results-skill
/plugin install chess-results@chess-results-skillOpenClaw — as a plugin (MCP tools plus the skill), or as a skill only:
openclaw plugins install git:github.com/odrobnik/chess-results-skill@v0.2.1
openclaw skills install @odrobnik/chess-resultsCodex or another MCP client — start scripts/server.py over stdio:
[mcp_servers.chess-results]
command = "python3"
args = ["/path/to/chess-results/scripts/server.py"]Command line
python3 scripts/cli.py tournaments --name "Landesliga" --country AUT
python3 scripts/cli.py players --last-name Huber --federation AUTSee SETUP.md for every option, including the OpenClaw details.
Related MCP server: ttw-mcp
Tools
MCP tool | Command line | What it does |
|
| Players and their tournament appearances |
|
| Birth year, ratings and games in one tournament |
|
| Tournaments by name, place, organiser, country |
|
| Any tournament page as tables, with links to the other views |
|
| The leagues of an Austrian championship season |
|
| Check a match report against Chess-Results; saves nothing |
|
| Check and save, only with |
|
| Whether a login is stored and works |
SKILL.md describes the match-report workflow the agent follows.
Login and club settings
The queries are public. Result entry needs a Chess-Results login and your club's settings:
Login — run
python3 scripts/cli.py loginonce, in your own terminal. It asks for your personal number and password (hidden) and stores them in the system credential store: macOS Keychain, Windows Credential Manager or Linux Secret Service. On a machine without one,cli.py login --filewrites a private file (mode 600) instead. The password never goes into a config file or a chat.Club settings — copy
examples/chess-results.example.jsontochess-results.jsonand adapt it (your club's name, its leagues, the entry deadline). It stays out of the repository.
Good to know
Be gentle with the server. Requests are spaced and retried with back-off, and public pages are cached. Ask for what you need, not whole seasons in a loop.
Appearances are not a register. A player found by name alone may be several people, and one person may appear under several spellings.
Saved results are public to the whole league. The agent only saves after the check came back clean and you said yes.
Tests
python3 -m unittest discover -s testsThe tests run offline. Every club, player and number in them is made up.
Changes
0.2.1 — The MCP server carries the match-report workflow in its instructions, for
hosts that load it without SKILL.md (ChatGPT, …), and marks every tool as read-only
except enter_match_report, so hosts ask before saving.
0.2.0 — Query results are consistent data: ISO dates everywhere, the last update
of a tournament as a timestamp (updatedAt, was "19 Hours 24 Min."), numbers as
integers, full tournament names in player searches (the site cuts them to 30
characters), a typed player block on player cards, start/end on tournament
pages, unique column names (a schedule's two "Team" columns no longer collapse into
one), match headings on round pages, and no menu entries among tournament details.
cli.py enter saves only after a typed yes (or --yes). SECURITY.md describes what
the skill accesses.
0.1.0 — First release.
License
MIT — see LICENSE. Not affiliated with Chess-Results or its operators; use it within the site's terms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Run racket-sport tournaments from your AI assistant: fair draws, scores, live standings.
Query professional padel tournament data, player stats, and live match results
Run small tennis & pickleball tournaments from your AI assistant: brackets, schedules, results.
Grounded sports predictions plus European soccer and tennis arbitrage data for AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceReal-time tennis data for ATP, WTA, Challenger and ITF: live scores, player rankings, match-winner odds, and model win-probability. 12 read-only tools; a tier-gated endpoint returns a plain-English explanation of which plan it needs rather than a bare 403. Requires a paid API key.25225 npm135MIT
- AlicenseAqualityBmaintenanceProvides access to the r.ttw.ru table tennis rating site, enabling searches for players, matches, head-to-head encounters, and tournaments via MCP tools.5MIT
- AlicenseAqualityBmaintenanceEnables querying table tennis ratings, players, tournaments, and halls from rttf.ru, with respect for robots.txt restrictions.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to answer tennis tactical questions using shot-by-shot charted match data, producing game plans, serve and return tendencies, scouting reports, match forecasts, and explanations of why a match turned. Exposes read-only tools for player reports, head-to-head game plans, match breakdowns, and tactical leaderboards, each with confidence margins and links to full pages.MIT