Capabilities

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 that drive streaks, achievements, 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 and 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

Achievements Tools

Configure Achievements 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 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 systems, including Triggers, Levels, and 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 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

If multi-tenancy is not enabled on your account, these tools will not function.

Environments Tools

List the Environments 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 actions for users, including granting Streak Freezes, creating Streak Pauses, restoring streaks, 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
`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 Branding, Experimentation, 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:

Create an XP system called 'Kudos' that grants 10 points for each workout completed.

Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro').

List all achievements, completion rates and rarity in my Trophy account.

Get the top 20 rankings for leaderboard weekly-workouts this week.

Summarize the Kudos points distribution for pro users.

What are the current streak lengths for users user_123 and user_456?

Grant two streak freezes to user user_123.

user_123 wants their streak back, restore it to its previous length.

Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday.

What is our current streak configuration, and set freezes to start with 1 and max out at 3?

Create an achievement called 'First Workout' that unlocks when users complete 1 workout.

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. 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 is enabled, tools can also be scoped to a tenant. 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 when iterating.
Most tools cannot delete resources. The exception is delete_streak_pauses, which removes streak pauses by ID.

Get Support

Want to get in touch with the Trophy team? Reach out to us via email. We’re here to help!

Getting Started

Docs MCP Server

Account MCP Server

Tool Reference

Metrics Tools

Attributes Tools

Achievements Tools

Leaderboards Tools

Points Tools

Tenants Tools

Environments Tools

Streaks Tools

Settings Tools

Example Prompts

Scope and Safety

Get Support

​Tool Reference

​Metrics Tools

​Attributes Tools

​Achievements Tools

​Leaderboards Tools

​Points Tools

​Tenants Tools

​Environments Tools

​Streaks Tools

​Settings Tools

​Example Prompts

​Scope and Safety

​Get Support

Tool Reference

Metrics Tools

Attributes Tools

Achievements Tools

Leaderboards Tools

Points Tools

Tenants Tools

Environments Tools

Streaks Tools

Settings Tools

Example Prompts

Scope and Safety

Get Support