> ## Documentation Index
> Fetch the complete documentation index at: /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 coding agents read and manage the configuration of 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/mcp
```

## Why the Account MCP?

AI coding agents are already where teams design and ship product work and Trophy has simplified this by providing pre-built infrastructure for common engagement 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.md)), 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 engagement 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

## How it works

Trophy hosts a remote MCP endpoint. You install it once in your MCP client, sign in with OAuth using your Trophy account (and select the organization to authorize), 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, pauses, restores, settings, 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.md).

## Get started

> [card] [Installation](/mcp/account-mcp-server/installation.md)
>
> Connect the MCP server in Claude, Cursor, VS Code, and other clients.

> [card] [Capabilities](/mcp/account-mcp-server/capabilities.md)
>
> See the tools your agent can use once connected.

> [card] [Best practice](/mcp/best-practice.md)
>
> Recommended ways to work with agents and MCP.

## Get support

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.