Squadcard

AI エージェント向け Squadcard

Squadcard は、毎週プレーするサッカーグループ向けのアプリです。参加者の確認、公平なチーム分け、仲間からの評価ができます。 このフォルダーには、エージェントが利用するために必要なものが含まれています。詳しいガイド：https://squadcard.app/agents

インストール不要の MCP サーバーが 1 つあります：https://squadcard.app/api/mcp。ブラウザーで一度 Squadcard にサインインすれば、その後エージェントは次のことができます。

• 名前のリストから公平な 2 チームを作成する
• 総当たり形式の対戦表を作成する
• チーム名を提案する
• スクワッドを作成し、招待リンクを渡す
• 渡された招待リンクからスクワッドに参加する
• 次の試合に参加する、参加するかもしれない、または参加しないと回答する
• 今週の試合を設定し、参加者を知らせる
• チームを選び、スコアを入力して、投票リンクを渡す

誰がどう投票したかを確認したり、支払い済みにしたり、何かを購入したり、選手を削除したり、何かを消去したりすることはできません。

MCP 設定

JSON 設定を受け付けるクライアント（Claude Desktop、Cursor、VS Code など）の場合：

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

初めてツールを使うときにブラウザーが開き、Squadcard にサインインできます。

ツール

• make_fair_teams：名前のリストから、ゴールキーパーを分けたバランスのよい 2 チームを作成する
• make_fixtures：3～16 チームの総当たり形式の対戦表を作成する
• suggest_team_names：テーマや単語からチーム名を提案する
• list_squads：サインイン中の人が所属するスクワッドを一覧表示する
• get_squad：スクワッド、招待リンク、次の試合、参加者を取得する
• create_squad：自分が主催者となるスクワッドを作成する
• join_squad：渡された招待リンクからスクワッドに参加する
• set_game：スクワッドの試合日時と場所を設定する
• answer_game：次の試合に参加する、参加するかもしれない、または参加しないと回答する
• pick_teams：参加予定者からバランスのよいチームを作成する
• reshuffle_teams：同じ選手を別の公平なチームに分け直す
• enter_result：スコアを保存して投票を開始し、投票リンクを取得する
• get_match：試合、チーム、スコア、参加状況を取得する

Claude Code

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

次に /mcp → squadcard → サインインの順に選択します。

または、サーバーと Claude の使い方を説明するスキルが追加されるプラグインをインストールします。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

エージェントの実行環境にブラウザーがない場合

https://squadcard.app/account の「AI agents」でキーを作成し、Authorization: Bearer <key> として渡してください （Codex の場合は codex/config.toml に設定方法が記載されています）。キーの権限はサインイン時と同じです。また、同じページからどちらも接続を解除できます。

このリポジトリの内容

• plugins/squadcard/：Claude Code プラグイン（サーバー、スキル、独自の README とライセンス）
• .claude-plugin/marketplace.json：Claude Code がこのリポジトリからプラグインをインストールできるようにします
• codex/config.toml：Codex 用の同じサーバー
• server.json：MCP レジストリ用のエントリー

MIT ライセンス。