# 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):

```json
{
  "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.