Apps
Create, list, and manage apps and their users via MCP tools.
Apps represent a specific platform build within a project. Each app has a platform (apple, android, web, backend) and an optional bundle identifier — required for non-backend platforms, immutable after creation. Creating an app auto-generates a client_secret API key for SDK use.
list-apps
List all apps accessible to this agent.
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | UUID | No | Filter by team ID |
Returns { apps: [...] } with each app's id, name, platform, bundle_id, client_secret, project_id, and timestamps. Each app also carries latest_app_version, latest_app_version_updated_at, and latest_app_version_source ("app_store" or "computed") — compare these against an event's app_version to tell whether the data is from the current release. See Latest Version Detection.
get-app
Get an app by ID, including its client_secret for SDK configuration.
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | UUID | Yes | The app ID |
create-app
Create a new app under a project. Returns a client_secret for SDK use. Requires apps:write permission.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | App name |
platform | string | Yes | apple, android, web, or backend |
project_id | UUID | Yes | Parent project ID |
bundle_id | string | Conditional | Required for non-backend platforms. Immutable after creation. |
{
"name": "iOS App",
"platform": "apple",
"project_id": "550e8400-...",
"bundle_id": "com.example.myapp"
}Backend apps omit bundle_id:
{
"name": "API Server",
"platform": "backend",
"project_id": "550e8400-..."
}update-app
Update an app's name. Requires apps:write permission.
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | UUID | Yes | The app ID |
name | string | Yes | New app name |
list-app-users
List users for a specific app. Supports search, filtering, and pagination.
| Parameter | Type | Required | Description |
|---|---|---|---|
app_id | UUID | Yes | The app ID |
search | string | No | Search by user ID |
is_anonymous | string | No | "true" or "false" to filter by anonymous status |
billing_status | string | No | Comma-separated billing tiers to include: paid, trial, free. Derived from RevenueCat-synced user properties. Omit or pass all three for no filter. |
cursor | string | No | Pagination cursor |
limit | number | No | Max results (default 50, max 200) |