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

# Capabilities

> Learn about what the Trophy Account MCP Server can do.

Once connected, the Account MCP Server exposes tools your agent can call to inspect and manage your account.

Most configuration resources offer paired **read** and **write** tools:

* **Read** tools list and fetch resources
* **Write** tools create or update resources in batch to speed up operations

## Tool reference

The full list of tools available in the Trophy Account MCP Server.

### Metrics tools

Create and manage the [Metrics](/features/metrics.md) that drive streaks, milestones, points, and leaderboards.

| Tool | What it does |
| - | - |
| `read_metrics` | List metrics, or get a single metric by ID |
| `write_metrics` | Create or update metrics |

### Attributes tools

Manage [Custom User Attributes](/features/users.md#custom-user-attributes) and [Custom Event Attributes](/features/events.md#custom-event-attributes) used for feature targeting and personalization.

| Tool | What it does |
| - | - |
| `read_attributes` | List attributes, or get a single attribute by ID |
| `write_attributes` | Create or update attributes |

### Milestones tools

Configure [Milestones](/features/milestones.md) (called achievements in the API and tool names) and read completion analytics for your account.

| Tool | What it does |
| - | - |
| `read_achievements` | List achievements, or get a single achievement by ID |
| `write_achievements` | Create or update achievements |
| `read_achievements_analytics` | List achievements with completion counts and rarity; optionally filter by `user_attributes` |

### Leaderboards tools

Configure [Leaderboards](/features/leaderboards.md) and read live rankings.

| Tool | What it does |
| - | - |
| `read_leaderboards` | List leaderboards, or get a single leaderboard by ID |
| `write_leaderboards` | Create or update leaderboards |
| `read_leaderboard_rankings` | Get a leaderboard with live rankings by key (optional pagination, run date, user centering, and attribute filters) |

### Points tools

Configure full [Points](/features/points.md) systems, including [Triggers](/features/points.md#points-triggers), [Levels](/features/points.md#points-levels), and [Boosts](/features/points.md#points-boosts), and read distribution analytics.

| Tool | What it does |
| - | - |
| `read_points_systems` | List points systems, or get one by ID |
| `write_points_systems` | Create or update points systems (optionally with nested triggers, levels, and boosts) |
| `read_points_triggers` | List or get triggers for a points system |
| `write_points_triggers` | Create or update triggers for a points system |
| `read_points_levels` | List or get levels for a points system |
| `write_points_levels` | Create or update levels for a points system |
| `read_points_boosts` | List or get boosts for a points system |
| `write_points_boosts` | Create or update boosts for a points system |
| `read_points_analytics` | Points distribution and level breakdowns for a system (`summary` or `level_summary`; optional `user_attributes` on summary) |

### Tenants tools

Manage [Multi-Tenant](/platform/multi-tenancy.md) organization records when multi-tenancy is enabled on your account.

| Tool | What it does |
| - | - |
| `read_tenants` | List tenants, or get a single tenant by ID |
| `write_tenants` | Create or update tenants |

> [!NOTE]
>
> If multi-tenancy is not enabled on your account, these tools will not function.

### Environments tools

List the [Environments](/platform/environments.md) in your Trophy account.

| Tool | What it does |
| - | - |
| `read_environments` | List all active environments ordered by priority (name, key, priority; production is always priority 1) |

### Streaks tools

Look up and run operational [Streaks](/features/streaks.md) actions for users, including granting [Streak Freezes](/features/streaks.md#streak-freezes), creating [Streak Pauses](/features/streaks.md#streak-pauses), [restoring streaks](/features/streaks.md#restoring-a-users-streak), [resetting streaks](/features/streaks.md#resetting-a-users-streak), and reading or updating organization streak settings.

| Tool | What it does |
| - | - |
| `list_user_streaks` | Get streak length (and last extension timestamp) for up to 100 users, ranked longest first |
| `grant_streak_freezes` | Grant streak freezes to one or more users |
| `restore_streaks` | Restore a broken streak to its previous length |
| `reset_streaks` | Reset streaks to zero for one or more users (up to 100 per request) |
| `create_streak_pauses` | Create streak pauses for users over a date range (up to 100 per request) |
| `delete_streak_pauses` | Delete streak pauses by ID (up to 100 per request) |
| `get_streak_settings` | Get organization streak configuration (frequency, evaluation mode, metrics, days off, freezes) |
| `update_streak_settings` | Update organization streak configuration |

### Settings tools

Read and update organization settings, including [Brand kit](/context/brand-kit.md), [Experimentation](/platform/experimentation.md), and aggregation period.

| Tool | What it does |
| - | - |
| `get_settings` | Get branding, experimentation, and aggregation period settings |
| `update_settings` | Update branding, experimentation, and aggregation period settings |

## Example prompts

Use natural language — your agent picks the right tool and parameters:

```text theme={null}
Create an XP system called 'Kudos' that grants 10 points for each workout completed.
```

```text theme={null}
Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro').
```

```text theme={null}
List all milestones, completion rates and rarity in my Trophy account.
```

```text theme={null}
Get the top 20 rankings for leaderboard weekly-workouts this week.
```

```text theme={null}
Summarize the Kudos points distribution for pro users.
```

```text theme={null}
What are the current streak lengths for users user_123 and user_456?
```

```text theme={null}
Grant two streak freezes to user user_123.
```

```text theme={null}
user_123 wants their streak back, restore it to its previous length.
```

```text theme={null}
Reset the streaks for user_123 and user_456 to zero.
```

```text theme={null}
Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday.
```

```text theme={null}
What is our current streak configuration, and set freezes to start with 1 and max out at 3?
```

```text theme={null}
Create a milestone called 'First Workout' that unlocks when users complete 1 workout.
```

```text theme={null}
Update our brand color to #0F766E and set the aggregation period to weekly.
```

## Scope and safety

* Access is scoped to the Trophy organization you authorize during OAuth.
* Tools act on a specific [environment](/platform/environments.md). If the account has only one, tool calls default to it (normally `production`). If there are multiple, pass the `environment` key you want—or use `read_environments` to list them and choose.
* When [multi-tenancy](/platform/multi-tenancy.md) is enabled, tools can also be scoped to a [tenant](/platform/multi-tenancy.md). If there is only one active tenant, tool calls can default to it. If there are multiple, pass the `tenant` id you want, or use `read_tenants` to list them and choose.
* Write tools can change live configuration. Prefer a staging or sandbox [environment](/platform/environments.md) when iterating.
* Most tools cannot delete resources. The exception is `delete_streak_pauses`, which removes streak pauses by ID.
* `reset_streaks` sets users' current streaks to zero. Use `restore_streaks` if you need to bring a streak back afterwards.

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