Squadcard

Run your football group from Claude Code or Codex

Start a squad, see who’s playing, pick fair teams and enter the score, without leaving your terminal. Your AI agent does the organiser’s jobs; you just ask.

Connect Claude Code

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

Then type /mcp in Claude Code, pick squadcard and sign in. Your browser opens, you sign in to Squadcard and press Allow.

MCP server

https://squadcard.app/api/mcp

Transport

HTTP (streamable)

Sign-in

OAuth with PKCE in your browser, or a bearer key

Works with

Claude Code, Codex, and other MCP clients that can sign in

What it feels like

Youwho's in for Tuesday? pick the teams

AgentEight are in for Tuesday Fives, 8pm at The Cage: Dan, Priya, Kofi, Sam, Ollie, Aisha, Marek and Jay. Bibs: Dan, Kofi, Aisha, Marek (GK) Non-bibs: Priya, Sam, Ollie, Jay (GK) The teams are saved on Tuesday's match. Want another split?

Youwe won 6-4, bibs. put it in

AgentBibs 6, Non-bibs 4. Save that? It opens voting.

Youyes

AgentSaved, and voting is open. Post this in the group chat so everyone can rate the game: squadcard.app/v/…

An example. The names are made up; the steps are what the tools do.

Before your first request

1. Make your player card. If you’ve never played in a Squadcard squad, make one at squadcard.app/card: your name, position, age and the terms, a minute in your browser. An agent can’t do this step for you, and it will send you there if you skip it.
2. Joining a squad is free. Give your agent an invite link and it tells you which squad it’s for before joining.
3. Starting a squad follows the same rule as the website. Joining a squad, voting, your card and stats are always free. Starting a new squad needs Squad Pro (7 days free on the yearly plan), and one Squad Pro covers the whole squad. Squads started before 5 October 2026 stay free. Pricing.

Safe by design

A connected agent gets a short list of football jobs and nothing else. The limit is enforced on our side, so it holds whatever the agent is told to do.

It can never

• See how anyone voted. Only totals exist outside the ballot.
• Take, move or mark money.
• Buy, cancel or change a subscription.
• Remove players, change photos or close a squad.
• Delete your account, or sign you up.

You stay in charge

• You sign in yourself, on a page that says what you’re allowing.
• It’s set up to ask before starting a squad, joining one or saving a score.
• Disconnect it any time in your account, under AI agents.
• Invite and vote links come to you, to post in your own group chat.

What it can do

With names you give it

Quick sums. They don’t touch your squads.

• make_fair_teams Two balanced teams from a list of names, keepers on opposite sides.
• make_fixtures A round-robin for 3 to 16 teams, where everyone plays everyone.
• suggest_team_names Team names by theme, or club-style names from a word like your town or pub.

With your squads

These read or change the squads on your Squadcard account.

• list_squads The squads you're in.
• create_squad Starts a squad with you as organiser and gives you the invite link.
• join_squad Joins a squad from an invite link you give it, after telling you which squad the link is for.
• get_squad A squad's invite link, its players, the next game and who's in.
• set_game When and where you play, how often, the pitch cost and the player limit.
• answer_game Says you're in, maybe or out for the next game.
• pick_teams Two balanced teams from whoever is in for the next game.
• reshuffle_teams Another fair split of the same players.
• enter_result Saves the score, which opens voting, and gives you the vote link.
• get_match A match's teams, score, how many have voted, and the result once voting closes.

Other ways to connect

Claude Code, as a plugin

The same server, plus a skill that tells Claude how to use it. Type these two lines in Claude Code; the files are on GitHub.

/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

Any other MCP client

Point it at the server address above. It will send you to sign in the first time.

No browser where your agent runs? Use a key

Make a key in your account under AI agents, keep it in an environment variable, and send it as a bearer token.

Claude Code

claude mcp add --transport http squadcard https://squadcard.app/api/mcp \
  --header "Authorization: Bearer $SQUADCARD_AGENT_KEY"

Codex, in ~/.codex/config.toml

[mcp_servers.squadcard]
url = "https://squadcard.app/api/mcp"
bearer_token_env_var = "SQUADCARD_AGENT_KEY"

Things to try

• “Make two fair teams from: Dan, Priya, Kofi, Sam, Ollie, Aisha, Tom, Lewis, Marek (keeper), Jay (keeper).”
• “We’ve got six teams for Saturday. Make the fixtures.”
• “Start a 7-a-side squad called Thursday Sevens and give me the invite link.”
• “Here’s the invite link for my mate’s game. Which squad is it? Join it.”
• “Put me down as in for Tuesday.”
• “Who’s in for Tuesday? Pick the teams.”

Prefer to click? The same tools are on the site: free tools, and the organiser’s first week.

If something doesn’t work

Your agent doesn’t show Squadcard’s tools

Check the server is added and signed in. In a terminal, claude mcp list should show squadcard as connected. “Needs authentication” means run /mcp and sign in. If you added it while Claude Code was open, restart Claude Code.

“This account has no player card yet”

Make one at squadcard.app/card, signed in with the same account, then ask again.

“Starting a squad needs Squad Pro”

That’s the website’s own rule, not the agent’s. The agent gives you a link to pick a plan and pay in your browser; then ask it again. Or join a squad instead, which is always free.

Your squads are missing

You probably signed in with a different account from the one you play on (Google here, Apple there). Disconnect it in your account and connect again with the right one.

It stopped working

The connection was disconnected, or the key was removed. Connect again, or make a new key.

Questions

Does Squadcard have an MCP server?

Yes. It's at https://squadcard.app/api/mcp, over HTTP. An agent that speaks the Model Context Protocol connects to that address and signs you in to Squadcard in your browser.

Do I need an account?

Yes. The first time your agent uses Squadcard, it opens a browser page where you sign in and say yes. After that it stays connected until you disconnect it.

What can a connected agent do?

Only what's listed on this page: read your squads, start a squad, join one from an invite link you give it, say if you're in for a game, set the game, pick teams and enter a score. It can't see votes, mark payments, buy anything, change your photo or delete anything.

Can the agent see how people voted?

No. Nobody can: not the agent, not the organiser. Only totals are ever shown.

How do I switch it off?

Open your account, find AI agents, and disconnect it. It stops working at once.

My agent can't open a browser. Can I still use it?

Yes. Make a key in your account under AI agents and give it to the agent as a bearer token. A key has the same limits as signing in.

Can an agent sign me up?

No. The first time, you make your player card yourself in a browser, at squadcard.app/card, because that's where you confirm your age and accept the terms. It takes a minute and doesn't need a squad. After that an agent can start squads for you.

Which agents does it work with?

It's checked with Claude Code, and set up for Codex from Codex's own documentation. Any other client that speaks the Model Context Protocol over HTTP and can sign in with OAuth, or send a bearer token, should work too. It's one address, with nothing to install.

Squadcard is an app for football groups that play every week: who's in, fair teams, and ratings from your mates.