Best Practice - Trophy Docs

The Trophy Docs MCP Server and Account MCP Server are designed to be used together. This page covers the recommended ways to use them.

Using Both Servers Together

Install both servers in your MCP client using distinct names so tools stay easy to target:

Recommended name	URL
`Trophy Docs`	`https://docs.trophy.so/mcp`
`Trophy Account`	`https://mcp.trophy.so/mcp`

Installation guides: Docs MCP, Account MCP.

Docs MCP: Live Documentation

Use the Docs MCP as live context for how Trophy works. Use it when you need to:

Understand the behavior of Trophy features in detail
Brainstorm how to solve your specific gamification use case
Find the right API to call

The Trophy Docs MCP Server is read-only and always reads live public documentation, use it over local copies to ensure you have the most up-to-date information. See Docs MCP capabilities for more details.

Account MCP: Account Configuration and Operations

Use the Account MCP when you need to take actions in your Trophy account. Use it when you need to:

Read configuration from your Trophy account e.g. metrics, leaderboards etc.
Configure new or update existing resources in your Trophy account via chat.
Complete operational tasks such as granting freezes or restoring streaks.

Access is scoped to the Trophy organization you authorize during OAuth. Tools act on a specific environment (defaults to production or pass another key when you have multiple). See Account MCP capabilities for more details.

Recommended Workflow

For most agentic Trophy work, use both servers together:

Docs MCP — load the feature or API behavior the task needs
Account MCP (read) — list related resources so work builds on what already exists
Account MCP (write) — create or update only what the task requires
Your app — implement Application API calls in code using docs-backed shapes and your API keys
Verify — re-read account state or docs if something fails

Example Prompt

Using Trophy Docs MCP, review how metrics and event tracking works.
Using Trophy Account MCP, list my existing metrics.
Create a new 'workouts completed' metric if one does not already exist.
Then integrate event tracking to this metric in my code based on the docs.

Get Support

Want to get in touch with the Trophy team? Reach out to us via email. We’re here to help!

​Using Both Servers Together

​Docs MCP: Live Documentation

​Account MCP: Account Configuration and Operations

​Recommended Workflow

​Example Prompt

​Get Support