We use cookies (and other similar technologies) for many purposes, including to improve your experience on our site and for ads and analytics.

MCP Server

Run leaderboards by talking to Claude.

BoardQ ships an MCP server, so Claude can create boards, add players, and update live scores for you. "Make a leaderboard for our sprint and put the team on it" — done.

Setup guide Prefer the raw API?

⌁ One command to connect⚒ 5 leaderboard tools⚭ Works with any MCP client

terminal

# connect BoardQ to Claude (one time)
claude mcp add boardq -- npx -y boardq mcp --key $BOARDQ_API_KEY

# then just ask:
> Create a leaderboard "Sprint 42" with Alice, Bob and Chris,
  give Alice 3 points for yesterday's demo

✓ Board created: boardq.io/ab12cd34 — live, shareable

command to connect

leaderboard tools

lines of code to write

How it works

Connected in one minute

Get your key

Generate an account API key in Settings → Developer API on boardq.io (Premium).

Add the server

claude mcp add boardq -- npx -y boardq mcp --key YOUR_KEY — or the equivalent in any MCP client.

Just ask

"Who's leading?" · "Give Bob 5 points" · "Start a new board for Friday's quiz" — Claude does it, the board updates live.

What's inside

Five tools, everything a competition needs

Conversation is the admin UI

Create boards, rename players, adjust points — without opening the app. Great for standups and game nights.

Self-describing tools

create_leaderboard, get_standings, add_score, update_score, delete_score — typed schemas the model uses correctly, no hallucinated endpoints.

One key for everything

Your account key creates boards and manages scores on every board you own. Regenerate any time to revoke.

Live results

Every change lands on the public board in real time — put it on the TV while Claude keeps score.

Scoped & revocable

The key only reaches boards your account owns — never other users' boards or your account settings.

Any MCP client

Claude Code, Claude Desktop, or anything that speaks MCP. Runs via npx — nothing to install or update.

FAQ

MCP server questions

What is the BoardQ MCP server?

MCP (Model Context Protocol) is the standard that lets AI assistants use external tools. BoardQ's MCP server gives Claude five leaderboard tools - create_leaderboard, get_standings, add_score, update_score and delete_score - so you can run competitions by conversation instead of clicking through an app or writing API code.

How do I connect it to Claude?

Generate an account API key in BoardQ Settings → Developer API, then run: claude mcp add boardq -- npx -y boardq mcp --key YOUR_KEY. That's it - ask Claude to 'create a leaderboard for our sprint with Alice, Bob and Chris' and it will.

Does it work with clients other than Claude?

Yes. It's a standard MCP stdio server, so any MCP-compatible client works - Claude Code, Claude Desktop, and other tools that speak the protocol. The command is always: npx -y boardq mcp --key YOUR_KEY.

What can the AI actually do with it?

Everything score-related on boards your account owns: create new leaderboards (optionally seeding up to 200 players in one call), read live standings, add players, change scores, and remove rows. Every change appears on the public board in real time.

Is it safe to give the AI my API key?

The key is scoped to your account's boards only - it can't touch other users' boards or your account settings. Regenerate the key in Settings at any time to instantly revoke the old one.

Connect today

Let Claude keep the score.

Create your BoardQ account, grab an API key, and connect the MCP server in one command.

Start free Read the docs

Works with Claude Code & Claude Desktop · npx, no install · Revoke any time