About Sports Rules
Work an offside call through IFAB Law 11 or NHL Rule 83, step by step
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
Endpoint
https://sports-rules.gumballtools.com/api/mcpCopy install command
Claude CodeTerminal
claude mcp add --transport http com-gumballtools-sports-rules https://sports-rules.gumballtools.com/api/mcpCursor.cursor/mcp.json
{"mcpServers":{"com-gumballtools-sports-rules":{"type":"http","url":"https://sports-rules.gumballtools.com/api/mcp"}}}Open in CursorVS Code.vscode/mcp.json
{"servers":{"com-gumballtools-sports-rules":{"type":"http","url":"https://sports-rules.gumballtools.com/api/mcp"}}}Open in VS CodeClaude Desktopclaude_desktop_config.json
{"mcpServers":{"com-gumballtools-sports-rules":{"type":"http","url":"https://sports-rules.gumballtools.com/api/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"com-gumballtools-sports-rules":{"serverUrl":"https://sports-rules.gumballtools.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| ball | number | No | SOCCER. Position of the ball, same scale. |
| sport | enum | Yes | Which rule book. The two are structurally opposite — do not mix them up.soccer | hockey |
| stick | number | No | HOCKEY. Ignored, and reported as ignored. Skates decide it. |
| restart | enum | No | SOCCER. There is NO offside offence direct from a throw-in, goal kick, or corner. Always ask which restart it was before answering.open-play | throw-in | goal-kick | corner-kick | free-kick | kick-off | drop-ball |
| attacker | number | No | SOCCER. Position of the attacker along the attacking axis, larger being nearer the opponents’ goal line. Any consistent scale; only the order matters. |
| inOwnHalf | boolean | No | SOCCER. A player in their own half cannot be in an offside position. |
| lastTouch | enum | No | SOCCER. A DELIBERATE play by an opponent resets offside. A deflection, a save, or a rebound off the frame does NOT.team-mate | opponent-deliberate-play | opponent-deflection | opponent-save | rebound-off-post-or-crossbar |
| rearSkate | number | No | HOCKEY. The trailing skate in centimetres relative to the LEADING EDGE of the blue line — the edge nearer the attacking zone. Negative is the neutral-zone side; positive means it has broken the plane. |
| situation | enum | No | HOCKEY. zone-entry (default), or tag-up for clearing a delayed offside. The same skate position can give opposite answers.zone-entry | tag-up |
| skateOnIce | boolean | No | HOCKEY. Since 2021 this does NOT affect a zone entry — a skate above the plane is onside. It is decisive when tagging up, where the skate must contact the line. |
| involvement | enum | No | SOCCER. REQUIRED once the player is in an offside position — the call errors without it rather than assuming. An offside POSITION is not an offence; this is what turns it into one, and "none" is a common and correct answer meaning play continues.none | interfering-with-play | interfering-with-opponent | gaining-advantage |
| foremostPart | enum | No | SOCCER. Which part the attacker position describes. Passing an arm or hand is REFUSED with an explanation: only parts that could legally score count, and the boundary is the bottom of the armpit.head | shoulder | torso | hip | thigh | knee | shin | foot | arm | upper-arm | forearm | elbow | hand | fingertip |
| secondLastDefender | number | No | SOCCER. Position of the SECOND-last opponent, same scale. Usually the last outfield defender, since the goalkeeper is normally the last. |
| deliberatePlayCriteriaMet | array | No | SOCCER. Which of IFAB’s five deliberate-play criteria are met. Reported, not scored — there is no pass mark. |
Details
The maintainer has not added details yet. Check the README in the repository.
Comments
Markdown supported
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.