Squadcard for AI agents

Squadcard is an app for football groups that play every week: who's in, fair teams, and ratings from your mates. This folder holds what agents need to use it. Full guide: https://squadcard.app/agents

One MCP server, nothing to install: https://squadcard.app/api/mcp. You sign in to Squadcard once in your browser; after that your agent can:

• make two fair teams from a list of names
• make a round-robin fixture list
• suggest team names
• start a squad and hand you the invite link
• join a squad from an invite link you give it
• say you're in, maybe or out for the next game
• set up the week's game and tell you who's in
• pick the teams, enter the score and hand you the vote link

It can never see how anyone voted, mark payments, buy anything, remove players or delete anything.

MCP config

For any client that takes a JSON config (Claude Desktop, Cursor, VS Code and others):

{
  "mcpServers": {
    "squadcard": {
      "type": "http",
      "url": "https://squadcard.app/api/mcp"
    }
  }
}

The first time a tool is used, your browser opens for you to sign in to Squadcard.

Tools

• make_fair_teams: two balanced teams from a list of names, with the keepers split
• make_fixtures: a round-robin fixture list for 3 to 16 teams
• suggest_team_names: team names from a theme or a word
• list_squads: the squads of the person signed in
• get_squad: a squad, its invite link, the next game and who is in
• create_squad: start a squad, with you as organiser
• join_squad: join a squad from an invite link you give it
• set_game: when and where the squad plays
• answer_game: say you are in, maybe or out for the next game
• pick_teams: balanced teams from whoever is in
• reshuffle_teams: another fair split of the same players
• enter_result: save the score, which opens voting, and get the vote link
• get_match: a match, its teams, score and turnout

Claude Code

claude mcp add --transport http squadcard https://squadcard.app/api/mcp

Then /mcp → squadcard → sign in.

Or install the plugin, which adds the server and a skill that tells Claude how to use it. In Claude Code:

/plugin marketplace add iuliczki/squadcard-agents
/plugin install squadcard@squadcard

Codex

codex mcp add squadcard --url https://squadcard.app/api/mcp
codex mcp login squadcard

No browser where your agent runs?

Make a key at https://squadcard.app/account under "AI agents" and send it as Authorization: Bearer <key> (codex/config.toml shows how for Codex). A key has the same limits as signing in, and you disconnect either on the same page.

What is in this repository

• plugins/squadcard/: the Claude Code plugin (the server, a skill, its own README and licence)
• .claude-plugin/marketplace.json: lets Claude Code install the plugin from this repository
• codex/config.toml: the same server for Codex
• server.json: the entry for the MCP registry

MIT licence.