• DATA
  • ACTION
  • ENTRY
  • HUMAN

How to monitor competitive leaderboards with your AI

Connect Nakama to your AI client once. After that, you can manage tournament data and player rankings just by talking to your agent.

Ask AI about this page

Short answer

Can I manage my game leaderboards with AI?

Yes. You can check tournament status, join active competitions, and update player scores using text commands. This lets you handle live game data without touching the Nakama dashboard. Here is how the data flows.

The outcomes

Real-time tournament management

Your AI handles the heavy lifting for game data updates.

DATA

Live rank tracking

The AI pulls current standings and player positions. You get instant visibility into who is leading the pack.

ACTION

Score updates

You can push new scores directly to the leaderboard. The AI writes the data to Nakama for you.

ENTRY

Tournament control

The agent can find active tournaments and sign players up. It makes managing entry lists simple.

HUMAN

Manual oversight

You decide when to trigger score changes or tournament joins. The AI only acts when you tell it to.

The workflow

What your AI does when <the thing arrives>.

The AI acts as a bridge between your chat interface and the Nakama backend.

  1. Check standings

    The AI looks up the current top players and their scores. This gives you a snapshot of the competition.

    list_leaderboard_records

  2. Update rankings

    When a match ends, the AI submits the new scores. It ensures the leaderboard stays current.

    write_leaderboard_record

  3. Find tournaments

    The agent scans for active or upcoming competitions. It identifies which tournaments are available for entry.

    list_tournaments

  4. Manage entries

    The AI can register a player for a specific event or record tournament results. It handles the registration logic.

    join_tournamentwrite_tournament_record

Try it

Copy these to start.

Use these prompts to begin interacting with your game data.

Starting points

Replace the bracketed text with your specific tournament names or player IDs.

Nakama Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_shRah9nkk4Q2dpnMXiF99Coso93SzYTQrVnA1wUm/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nakama capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "nakama-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_shRah9nkk4Q2dpnMXiF99Coso93SzYTQrVnA1wUm/mcp"
    }
  }
}
Copy into chat04

  • Show me the top 10 players on the Global Season 1 leaderboard.

  • Find all active tournaments happening this week.

  • Add a score of 500 to player user_99 on the weekly leaderboard.

  • Join the 'Summer Sprint' tournament for player user_42.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Nakama once, then ask.

Click the link to connect your account. Your credentials stay encrypted and secure, and you can find the full tool list on the Connector page.

Connect Nakama to your AI

FAQ

How the Nakama connector behaves

  • 01

    Can the AI delete leaderboard records?

    No. The AI can only write or list records; it cannot delete existing data.

  • 02

    Does the AI automatically join tournaments?

    No. The AI only joins a tournament when you explicitly ask it to.

  • 03

    Can I use this to create new leaderboards?

    No. The tools are limited to listing, writing, and managing existing tournament and leaderboard data.

  • 04

    Will the AI change my game logic?

    No. The AI only interacts with the specific leaderboard and tournament data provided by the tools.

  • 05

    Can the AI see all player data?

    The AI can only see the specific leaderboard records and tournament info it is asked to retrieve.

  • More questions about Nakama? The Connector page answers them. See everything the Nakama Connector can do

Connect Nakama to Claude, Cursor, ChatGPT & more