> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trophy.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Practice

> How to use Trophy’s Docs MCP and Account MCP servers together.

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

<h2 id="using-both-servers-together">
  Using Both Servers Together
</h2>

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](/mcp/docs-mcp-server/installation), [Account MCP](/mcp/account-mcp-server/installation).

<h2 id="docs-mcp-live-documentation">
  Docs MCP: Live Documentation
</h2>

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](/mcp/docs-mcp-server/capabilities) for more details.

<h2 id="account-mcp-account-configuration-and-operations">
  Account MCP: Account Configuration and Operations
</h2>

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 a specific Trophy [environment](/platform/environments) via [Admin API keys](/admin-api/authentication).

See [Account MCP capabilities](/mcp/account-mcp-server/capabilities) for more details.

<h2 id="recommended-workflow">
  Recommended Workflow
</h2>

For most agentic Trophy work, use both servers together:

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

<h3 id="example-prompt">
  Example Prompt
</h3>

```text theme={null}
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.
```

<h2 id="get-support">
  Get Support
</h2>

Want to get in touch with the Trophy team? Reach out to us via [email](mailto:support@trophy.so). We're here to help!


## Related topics

- [Overview](/mcp/overview.md)
- [Introduction](/mcp/docs-mcp-server/introduction.md)
- [Installation](/mcp/docs-mcp-server/installation.md)