Let your AI assistant find your sports partner

At a glance

Endpoint

https://match.shipfast.sh/api/mcp

Transport

Streamable HTTP, stateless, JSON responses (POST only)

Auth

Authorization: Bearer smk_… (personal key, revocable)

Server card

https://match.shipfast.sh/.well-known/mcp/server-card.json

Tools

23 (9 read-only)

Connect

1. Sign in at SportMatch and finish your profile.
2. Open Profile > AI agents and create a key. It is shown once.
3. Add the server to your client.

Claude Code

claude mcp add --transport http sportmatch https://match.shipfast.sh/api/mcp \
  --header "Authorization: Bearer smk_YOUR_KEY"

Other clients that take a remote server URL and headers (Cursor, VS Code, Gemini CLI, …)

{
  "mcpServers": {
    "sportmatch": {
      "url": "https://match.shipfast.sh/api/mcp",
      "headers": { "Authorization": "Bearer smk_YOUR_KEY" }
    }
  }
}

Client menus change often; the server needs only the URL and the Authorization header. Clients that require OAuth for custom connectors are not supported yet.

Tools

• get_optionsread-only

  Valid sports, levels, Ho Chi Minh City area ids and play-time slots.

• get_my_profileread-only

  Your own profile, plan (free or Pro) and likes left today.

• find_partnersread-only

  Players who fit your level and play times, best first.

• list_matchesread-only

  Your matches with the latest message preview.

• who_liked_meread-only

  Players waiting for your answer (names are Pro only; free accounts get the count).

• read_messageschanges data

  Messages in one match; marks them as read.

• like_playerchanges data

  Like a player; a mutual like becomes a match. Free accounts have a daily limit.

• pass_playerchanges data

  Pass on a player so they stop appearing.

• send_messagechanges data

  Send a chat message in a match, as you.

• propose_gamechanges data

  Propose a date, time and court to a match.

• list_confirmed_gamesread-only

  Accepted 1-on-1 games that have not happened yet.

• cancel_game_proposalchanges data

  Withdraw a proposal you sent.

• answer_gamechanges data

  Accept or decline a proposal someone sent you.

• block_playerchanges data

  Block a player; neither of you sees the other again.

• unblock_playerchanges data

  Undo a block you made.

• report_playerchanges data

  Report a player to the moderators (also blocks them).

• list_gamesread-only

  Upcoming open group games that fit your level.

• create_gamechanges data

  Open a group game other players can join (optionally weekly).

• join_gamechanges data

  Join a game, or its waitlist when full.

• leave_gamechanges data

  Leave a game; the next waitlisted player takes the spot.

• list_courtsread-only

  Courts players have added, with upcoming open games.

• get_leaderboardread-only

  Most active players of the last 30 days for a sport.

• rate_playerchanges data

  After a game you both played, give a kudos tag (on time, friendly, fair level or no-show).

Times are Ho Chi Minh City time (UTC+7). Nothing here deletes your account, photos or messages.

FAQ