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

# Installation

> Install the Account MCP Server in Claude Code, Cursor, VS Code, and other MCP clients.

<Note>
  You need a [Trophy account](https://app.trophy.so/sign-up) to use the Trophy Account MCP Server.
</Note>

The Trophy Account MCP Server is a remote HTTP MCP server. You point your client at the URL below using your [Admin API key](/admin-api/authentication) and your agent can start using the tools.

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

<h2 id="install-in-your-client">
  Install in Your Client
</h2>

Name this server clearly (for example `Trophy Account`) so it does not collide with the [Docs MCP Server](/mcp/docs-mcp-server/installation).

<Note>
  Replace `YOUR_ADMIN_API_KEY` with an API key from the [integrations page](https://app.trophy.so/integration) of the Trophy dashboard.
</Note>

<Tabs>
  <Tab title="Claude Code">
    Add the remote server with a `headers` entry for the API key:

    ```bash theme={null}
    claude mcp add-json "Trophy Account" '{
      "type": "http",
      "url": "https://mcp.trophy.so",
      "headers": {
        "x-trophy-api-key": "YOUR_ADMIN_API_KEY"
      }
    }'
    ```

    To pull the key from the environment instead of inlining it:

    ```bash theme={null}
    claude mcp add-json "Trophy Account" "{
      \"type\": \"http\",
      \"url\": \"https://mcp.trophy.so\",
      \"headers\": {
        \"x-trophy-api-key\": \"${TROPHY_API_KEY}\"
      }
    }"
    ```

    Verify it appears in your list:

    ```bash theme={null}
    claude mcp list
    ```
  </Tab>

  <Tab title="Cursor">
    Open MCP settings and add this to your `mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "Trophy Account": {
          "url": "https://mcp.trophy.so",
          "headers": {
            "x-trophy-api-key": "YOUR_ADMIN_API_KEY"
          }
        }
      }
    }
    ```

    If you prefer not to store the key in the file, use Cursor’s env substitution where available:

    ```json theme={null}
    {
      "mcpServers": {
        "Trophy Account": {
          "url": "https://mcp.trophy.so",
          "headers": {
            "x-trophy-api-key": "${env:TROPHY_API_KEY}"
          }
        }
      }
    }
    ```

    Restart Cursor if needed so the server and headers load.
  </Tab>

  <Tab title="VS Code">
    Create or update `.vscode/mcp.json` in your workspace:

    ```json theme={null}
    {
      "servers": {
        "Trophy Account": {
          "type": "http",
          "url": "https://mcp.trophy.so",
          "headers": {
            "x-trophy-api-key": "YOUR_ADMIN_API_KEY"
          }
        }
      }
    }
    ```

    Reload VS Code and enable the server.
  </Tab>

  <Tab title="Other clients">
    Any MCP client that supports remote HTTP servers and a `headers` config can connect.

    Use:

    * **Transport:** HTTP (streamable HTTP)
    * **URL:** `https://mcp.trophy.so`
    * **Name:** `Trophy Account` (or any label you prefer)
    * **headers:**

    ```json theme={null}
    {
      "headers": {
        "x-trophy-api-key": "YOUR_ADMIN_API_KEY"
      }
    }
    ```
  </Tab>
</Tabs>

<h2 id="verify-the-connection">
  Verify the Connection
</h2>

Ask your agent something that requires a live account call, for example:

```text theme={null}
List the metrics in my Trophy account.
```

If authentication succeeded, you should get metrics from your organization. If you get an auth or unauthorized error, confirm the key is valid and that your client’s config includes:

```json theme={null}
"headers": {
  "x-trophy-api-key": "YOUR_ADMIN_API_KEY"
}
```

<h2 id="next-steps">
  Next Steps
</h2>

<CardGroup>
  <Card title="Capabilities" icon="wrench" href="/mcp/account-mcp-server/capabilities">
    Explore what tools the Account MCP Server exposes.
  </Card>

  <Card title="Docs MCP installation" icon="download" href="/mcp/docs-mcp-server/installation">
    Add on-demand docs context for your agent.
  </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

- [Installation](/mcp/docs-mcp-server/installation.md)
- [Introduction](/mcp/docs-mcp-server/introduction.md)
- [Best Practice](/mcp/best-practice.md)
- [How to Build a Gamified Fitness Tracker](/guides/gamified-fitness-platform.md)