English Français العربية

Squadcard

Official registry Games, sports and entertainment

Organise a weekly football game: fair teams, fixtures, squads, who is in, and the vote link.

Source code Website Documentation

What can you do with Squadcard?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http squadcard 'https://squadcard.app/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "squadcard": {
            "type": "http",
            "url": "https://squadcard.app/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Squadcard for AI agents
  2. MCP config
  3. Tools
  4. Claude Code
  5. Codex
  6. No browser where your agent runs?
  7. What is in this repository

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.

Frequently asked questions

What is Squadcard?

Organise a weekly football game: fair teams, fixtures, squads, who is in, and the vote link.

How do I install Squadcard?

It runs as a remote server. In Claude Code: claude mcp add --transport http squadcard 'https://squadcard.app/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Squadcard need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Squadcard open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Squadcard?

It is published by iuliczki. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.