> ## 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.

# Introduction

> Learn about the Account MCP Server and why it exists for AI agents.

The Account MCP Server is a remote [Model Context Protocol](https://modelcontextprotocol.io) server that lets AI agents read and manage gamification configuration in your Trophy account.

Instead of copy-pasting dashboard clicks into chat, you can ask your agent to inspect metrics, create points systems, update leaderboards, restore streaks, and more.

```bash Server URL theme={null}
https://mcp.trophy.so
```

<h2 id="why-the-account-mcp">
  Why the Account MCP?
</h2>

AI coding agents are already where teams design and ship product work and Trophy has simplified this by providing pre-built infrastructure for building common gamification features. However this largely involves looking at screens and clicking buttons.

The Account MCP Server is the **action layer**: after the agent understands *what* to build (often via the [Docs MCP Server](/mcp/docs-mcp-server/introduction)), it can discover live account configuration, make targeted changes, and validate results without a human touching the dashboard.

This opens up a new workflow for teams where agents can reason about what gamification features to build, understand how to map that to Trophy features, and configure a Trophy account that achieves this all within chat.

Typical workflows include:

* Scaffolding metrics, attributes, and points systems while integrating Trophy into a new app
* Inspecting existing leaderboards or points configuration before changing production code
* Running operational tasks like granting freezes or restoring streaks from chat

<h2 id="how-it-works">
  How It Works
</h2>

Trophy hosts a remote MCP endpoint. You install it once in your MCP client, authenticate with an admin API key from the [integrations page](https://app.trophy.so/integration) under a `headers` config (`x-trophy-api-key`), and the client exposes tools your agent can call.

Those tools map to account operations — list/get for discovery, create/update for configuration, and dedicated actions for streak freezes, restores and reading analytics.

<Note>
  The Account MCP Server is intended for chat-based and agent workflows. For scripts, backend jobs, or production integrations, use the [Admin API](/admin-api/introduction).
</Note>

<h2 id="get-started">
  Get Started
</h2>

<CardGroup>
  <Card title="Installation" icon="download" href="/mcp/account-mcp-server/installation">
    Connect the MCP server in Claude, Cursor, VS Code, and other clients.
  </Card>

  <Card title="Capabilities" icon="wrench" href="/mcp/account-mcp-server/capabilities">
    See the tools your agent can use once connected.
  </Card>

  <Card title="Best practice" icon="circle-check" href="/mcp/best-practice">
    Recommended ways to work with agents and MCP.
  </Card>
</CardGroup>

<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

- [Introduction](/api-reference/introduction.md)
- [Capabilities](/mcp/docs-mcp-server/capabilities.md)