Pitch Time — Fair Youth Soccer Lineups
Fair youth soccer lineups, rotations, formations, playing time, age groups and fixtures.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"lineups": {
"url": "https://pitchtime.app/mcp"
}
}
}Remote endpoints
https://pitchtime.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢generate_fair_lineup(players, format, gameMinutes, periods, segmentsPerPeriod, ...)
Create a deterministic rotation with balanced minutes, goalkeeper duties and preferred positions. Returns each substitution window, player minutes and a shareable printable link. Duplicate names receive numbered suffixes. Without designated goalkeepers, everyone is available in goal.
Input Schema
{
"type": "object",
"properties": {
"players": {
"minItems": 7,
"maxItems": 30,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 80
},
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"canPlayGK": {
"type": "boolean"
},
"preferred": {
"maxItems": 11,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 10
}
}
},
"required": [
"name"
]
}
]
}
},
"format": {
"description": "7v7, 9v9 or 11v11; also accepts numbers 7, 9, 11 and strings \"7\", \"9\", \"11\".",
"anyOf": [
{
"type": "string",
"enum": [
"7v7",
"9v9",
"11v11"
]
},
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 9
},
{
"type": "number",
"const": 11
},
{
"type": "string",
"enum": [
"7",
"9",
"11"
]
}
]
},
"gameMinutes": {
"description": "Defaults: 7v7 50, 9v9 60, 11v11 70 minutes.",
"type": "number",
"minimum": 10,
"maximum": 120
},
"periods": {
"description": "2 halves (default) or 4 quarters.",
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 4
}
]
},
"segmentsPerPeriod": {
"description": "Equal substitution windows per period; default aims for about 8 minutes per segment.",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"formation": {
"description": "Full formation including GK, for example 1-2-3-1. Omit for the recommended formation.",
"type": "string"
},
"goalkeepers": {
"description": "Roster names in keeper rotation order; combined with canPlayGK flags.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"rotateGoalkeeper": {
"description": "Designated keepers rotate at period breaks by default if more than one. Without designated keepers, defaults to keeping the current keeper until benched; true requests segment rotation, false fixes the first player in goal.",
"type": "boolean"
}
},
"required": [
"players",
"format"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"7v7",
"9v9",
"11v11"
]
},
"formation": {
"type": "string"
},
"gameMinutes": {
"type": "number",
"minimum": 10,
"maximum": 120
},
"periods": {
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 4
}
]
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"index": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"period": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"startMinute": {
"type": "number"
},
"endMinute": {
"type": "number"
},
"onField": {
"type": "array",
"items": {
"type": "object",
"properties": {
"position": {
"type": "string"
},
"player": {
"type": "string"
}
},
"required": [
"position",
"player"
],
"additionalProperties": false
}
},
"bench": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"index",
"period",
"startMinute",
"endMinute",
"onField",
"bench"
],
"additionalProperties": false
}
},
"minutes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"player": {
"type": "string"
},
"minutes": {
"type": "number"
},
"percent": {
"type": "number"
}
},
"required": [
"player",
"minutes",
"percent"
],
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"shareUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"format",
"formation",
"gameMinutes",
"periods",
"segments",
"minutes",
"notes",
"shareUrl"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢recommend_formation(format, ageGroup, style)
Choose a formation for 7v7 (U8–U10), 9v9 (U11–U12) or 11v11 (U13+), with alternatives and coaching notes. Explicit format takes precedence over age; defaults to balanced 7v7.
Input Schema
{
"type": "object",
"properties": {
"format": {
"description": "7v7, 9v9 or 11v11; also accepts numbers 7, 9, 11 and strings \"7\", \"9\", \"11\".",
"anyOf": [
{
"type": "string",
"enum": [
"7v7",
"9v9",
"11v11"
]
},
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 9
},
{
"type": "number",
"const": 11
},
{
"type": "string",
"enum": [
"7",
"9",
"11"
]
}
]
},
"ageGroup": {
"description": "For example U9 or U12.",
"type": "string"
},
"style": {
"type": "string",
"enum": [
"balanced",
"attacking",
"defensive"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"7v7",
"9v9",
"11v11"
]
},
"ageGuidance": {
"type": "string"
},
"recommended": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"positions": {
"type": "array",
"items": {
"type": "string"
}
},
"bestFor": {
"type": "string"
}
},
"required": [
"name",
"positions",
"bestFor"
],
"additionalProperties": false
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"positions": {
"type": "array",
"items": {
"type": "string"
}
},
"bestFor": {
"type": "string"
}
},
"required": [
"name",
"positions",
"bestFor"
],
"additionalProperties": false
}
},
"guideUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"format",
"ageGuidance",
"recommended",
"alternatives",
"guideUrl"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢calculate_playing_time(format, gameMinutes, rosterSize)
Calculate minutes and percentage per player, bench size, a simple segment length and whether equal shares meet a 50% minimum. This is an equal-share calculation, before any goalkeeper constraints.
Input Schema
{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"7v7",
"9v9",
"11v11"
]
},
"gameMinutes": {
"type": "number",
"minimum": 10,
"maximum": 120
},
"rosterSize": {
"type": "integer",
"minimum": 7,
"maximum": 30
}
},
"required": [
"format",
"gameMinutes",
"rosterSize"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"minutesPerPlayer": {
"type": "number"
},
"percent": {
"type": "number"
},
"benchSize": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"segmentLength": {
"type": "number"
},
"meets50PercentMinimum": {
"type": "boolean"
},
"calculatorUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"minutesPerPlayer",
"percent",
"benchSize",
"segmentLength",
"meets50PercentMinimum",
"calculatorUrl"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢age_group(dob, body, seasonStartYear)
Find the age group for a birth date, governing body and season from published official cutoff rules. Covers US Youth Soccer, AYSO, The FA and Canada Soccer from 2026. Returns the cutoff source and calculator link. USYS and AYSO use the revised August–July window from 2026–27.
Input Schema
{
"type": "object",
"properties": {
"dob": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date of birth as YYYY-MM-DD."
},
"body": {
"description": "Slug (us-youth-soccer, ayso, the-fa, canada-soccer) or common name: US Youth Soccer, USYS, AYSO, The FA, FA, Canada Soccer. Case-insensitive.",
"type": "string"
},
"seasonStartYear": {
"description": "Season start year, or year of play for Canada. Defaults to the current season for the body.",
"type": "integer",
"minimum": 2026,
"maximum": 2100
}
},
"required": [
"dob",
"body"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"label": {
"type": "string"
},
"age": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"body": {
"type": "string",
"enum": [
"us-youth-soccer",
"ayso",
"the-fa",
"canada-soccer"
]
},
"bodyName": {
"type": "string"
},
"seasonStartYear": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"season": {
"type": "string"
},
"cutoff": {
"type": "string"
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"retrievedDate": {
"type": "string"
},
"pageUrl": {
"type": "string",
"format": "uri"
},
"rulesUrl": {
"type": "string",
"format": "uri"
},
"typicalFormat": {
"type": [
"string",
"null"
]
},
"formatAgeBand": {
"type": [
"string",
"null"
]
},
"formatNote": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"label",
"age",
"body",
"bodyName",
"seasonStartYear",
"season",
"cutoff",
"sourceUrl",
"retrievedDate",
"pageUrl",
"rulesUrl",
"typicalFormat",
"formatAgeBand",
"formatNote",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢generate_round_robin(teams, doubleRoundRobin, startDate, weekday)
Create deterministic weekly fixtures for 3–24 teams with balanced home/away games and odd-team byes. Double round-robin reverses the round order and swaps home/away for the return leg. Returns fixtures, team counts, a Markdown table and a share link.
Input Schema
{
"type": "object",
"properties": {
"teams": {
"minItems": 3,
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"doubleRoundRobin": {
"type": "boolean"
},
"startDate": {
"description": "First possible match date, YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"weekday": {
"description": "0 Sunday through 6 Saturday, or an English weekday name or 3-letter abbreviation (case-insensitive), for example Saturday or sat. Requires startDate; first round is on or after that date.",
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 6
},
{
"type": "string"
}
]
}
},
"required": [
"teams"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"fixtures": {
"type": "array",
"items": {
"type": "object",
"properties": {
"round": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"home": {
"type": "string"
},
"away": {
"type": "string"
},
"date": {
"type": "string"
},
"venue": {
"type": "string"
},
"time": {
"type": "string"
},
"durationMinutes": {
"type": "number"
}
},
"required": [
"round",
"home",
"away",
"durationMinutes"
],
"additionalProperties": false
}
},
"byes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"round": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"team": {
"type": "string"
},
"date": {
"type": "string"
}
},
"required": [
"round",
"team"
],
"additionalProperties": false
}
},
"summary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"team": {
"type": "string"
},
"home": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"away": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"byes": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"team",
"home",
"away",
"byes"
],
"additionalProperties": false
}
},
"shareUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"fixtures",
"byes",
"summary",
"shareUrl"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence