MCP servers

Build and run gamification using your AI tools

Trophy has two MCP servers that let AI tools like Claude, ChatGPT and Cursor build gamification into your app for you. Included on every Trophy plan at no extra cost.

Works with your favourite AI tools

Claude
Claude Code
ChatGPT
Codex
Cursor
VS Code
GitHub Copilot

Install MCP servers Read the docs

Install

Connect Trophy to your AI tools

Add both servers to your MCP client for the best results: docs for context, account for action.

Trophy Docs MCP

Read-only access to live Trophy documentation and API reference. Your agent can search and read pages on demand, like an always up-to-date skill. No Trophy account required.

https://docs.trophy.so/mcp

Install Docs MCP Read the docs

Trophy Account MCP

Lets your agent read and manage gamification configuration in your Trophy account: metrics, achievements, streaks, points, leaderboards and settings.

https://mcp.trophy.so/mcp

Install Account MCP Read the docs

Why use MCP

Desribe your app. Trophy does the rest.

Ask your agent for a streak, an XP system or a weekly leaderboard. It reads the live docs, configures your account and wires up your code.

Always accurate.: The agent works from live Trophy docs and API reference rather than stale training data.
No dashboard clicking.: Create metrics, achievements, streaks, points and leaderboards straight from chat.
Works with your tools.: Claude, Claude Code, Cursor, ChatGPT, VS Code and any MCP client.

Install MCP servers

Trophy MCP

Sonnet 4.6 · 8 tools loaded

> Build a daily streak and weekly leaderboard for our language learning app

Connected Trophy Docs and Trophy Account · read streaks and leaderboards docs

(ctrl+o to expand)

I'll configure the streak and leaderboard in your staging environment:

Metric - lessons-completed per lesson
Streak - daily, driven by lessons-completed
Leaderboard - weekly, ranked by lessons-completed

write_metrics({ name: 'Lessons Completed', key: 'lessons-completed' })

update_streak_settings({ metricKey: 'lessons-completed', frequency: 'daily' })

write_leaderboards({ name: 'Weekly learners', runUnit: 'day', runInterval: 7 })

Streak and leaderboard are live in staging. Want me to wire up the SDK calls in your backend?

Quickstart

Quickstart: connect both servers

Add both servers to your MCP client with distinct names. The Account server opens a browser for OAuth sign-in the first time it is used.

# Claude Code
claude mcp add --transport http "Trophy Docs" https://docs.trophy.so/mcp
claude mcp add --transport http "Trophy Account" https://mcp.trophy.so/mcp

# Any other MCP client: add two remote HTTP servers
#   Trophy Docs    -> https://docs.trophy.so/mcp
#   Trophy Account -> https://mcp.trophy.so/mcp (OAuth)

FAQ

Frequently asked questions

Have a different question and can’t find the answer you’re looking for? Send us an email.

What are the Trophy MCP servers?

Trophy maintains two remote Model Context Protocol servers. The Docs MCP server gives agents read-only search over Trophy's documentation and API reference. The Account MCP server lets agents configure and manage your Trophy account. Read the overview for details.

Which AI tools work with Trophy MCP?

Any MCP client that supports remote HTTP servers, including Claude, Claude Code, Cursor, ChatGPT and VS Code.

Do I need a Trophy account?

The Docs MCP server needs no account. The Account MCP server requires a Trophy account and signs in with OAuth, so no API keys are needed. Create an account to get started.

Is it safe to give an AI tool access to my account?

Access is scoped to the organization you authorize, can target a specific environment, and AI tools cannot delete configuration. See the Account MCP docs.

Does it cost extra?

No. Both MCP servers are available on all Trophy accounts, including the free plan, at no additional cost.

Should I install both servers?

Yes, for best results. Use the Docs server for context and the Account server for action. See the best practice guide.

Get started

Start building with MCP

Install

Install the MCP servers

Connect Trophy Docs and Trophy Account to your agent in a couple of minutes.

Install now

Docs

Read the MCP docs

Capabilities, installation guides and best practice for both servers.

Read the docs

Blog

Read the announcement

Why we built the MCP servers and how teams are using them.

Read the post