mcpField
S
Squadcard

Squadcard

Remote
squadcard.appGames & Entertainment1Updated 3w ago
RepositoryVisit website

About Squadcard

Squadcard is an MCP server for groups organizing weekly football games. It handles squad participation and match setup, and can create balanced teams and fixtures through a remote endpoint.

Key features

  1. 01Create balanced teams and round-robin fixtures
  2. 02Create squads and join by invite link
  3. 03Set game details and record availability
  4. 04Select or reshuffle teams
  5. 05Enter scores and retrieve vote links
  6. 06View squads, matches, and turnout

Use cases

  1. 01Organize a weekly football game
  2. 02Balance teams from players who are available
  3. 03Create a fixture list for a tournament
  4. 04Share a match vote link after entering the result

MCP support

Squadcard exposes its football-group tools through the remote MCP endpoint https://squadcard.app/api/mcp. Users sign in through a browser on first use, or can authenticate with a bearer key.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://squadcard.app/api/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

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

Details

From the project README

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.

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.