---
name: agency-creators
description: Creators actions of the Favorited Agency Dashboard MCP server (14): creators.drop, creators.get, creators.gifters, creators.history, creators.list, creators.managers.assign, creators.managers.facets, creators.managers.list, creators.managers.staff, creators.managers.unassign, creators.timeseries, grow.potential, live.now, recordings.list.
metadata:
  area: creators
  actions: 14
  server: https://mcp.agency.preprod.favorited.app/mcp
---

# Creators via the Favorited Agency MCP server

Connect to `https://mcp.agency.preprod.favorited.app/mcp` (Streamable HTTP, OAuth — see `https://mcp.agency.preprod.favorited.app/auth.md`). Call `whoami` first, then `agency.search` / `agency.describe` / `agency.execute` for the actions below, or the front-door tools where one exists.

## Actions

### agency/creators.drop

Remove a creator from the roster (immediate, irreversible from the dashboard).

- Class: `destructive` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `creators.drop`.
- REST equivalent: `DELETE /api/v1/creators/{userId}`.
- Parameters:
  - `userId` (string, required)

```json
{
  "action": "agency/creators.drop",
  "params": {
    "userId": "00000000-0000-0000-0000-000000000000"
  }
}
```

### agency/creators.get

One creator: profile, roster context and window stats.

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creators/{userId}`.
- Parameters:
  - `from` (string)
  - `to` (string)
  - `userId` (string, required)

```json
{
  "action": "agency/creators.get",
  "params": {
    "userId": "00000000-0000-0000-0000-000000000000",
    "window": "30d"
  }
}
```

### agency/creators.gifters

One creator's gifters (amounts only with the Revenue per Gifter feature).

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creators/{userId}/gifters`.
- Parameters:
  - `from` (string)
  - `limit` (integer)
  - `offset` (integer)
  - `to` (string)
  - `userId` (string, required)

### agency/creators.history

One creator's 24-month earning history.

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creators/{userId}/history`.
- Parameters:
  - `monthsBack` (integer)
  - `userId` (string, required)

### agency/creators.list

The roster: creators with revenue month-to-date, managers and join date; tabs all/roster/active/inactive/l4/dropped.

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creators`.
- Parameters:
  - `dir` (`asc` | `desc`)
  - `filter` (string)
  - `limit` (integer)
  - `managedByAgentId` (string)
  - `offset` (integer)
  - `sort` (`joined` | `followers` | `username` | `dropped` | `manager` | `revenue`)
  - `tab` (`all` | `roster` | `active` | `inactive` | `l4` | `dropped`)

```json
{
  "action": "agency/creators.list",
  "params": {
    "tab": "inactive",
    "sort": "revenue",
    "dir": "desc",
    "limit": 25
  }
}
```

### agency/creators.managers.assign

Assign a staff member as manager of a creator.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `creators.assign`.
- REST equivalent: `POST /api/v1/creator-managers`.
- Parameters:
  - `agentUserId` (string, required)
  - `creatorUserId` (string, required)

```json
{
  "action": "agency/creators.managers.assign",
  "params": {
    "creatorUserId": "…",
    "agentUserId": "…"
  }
}
```

### agency/creators.managers.facets

Manager filter facets (who manages how many).

- Class: `read`.
- Requires: `creators.get`.
- REST equivalent: `GET /api/v1/creator-managers/facets`.
- Parameters: none.

### agency/creators.managers.list

Manager assignments across the roster.

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creator-managers`.
- Parameters: none.

### agency/creators.managers.staff

Staff members who can be assigned as managers.

- Class: `read`.
- Requires: `creators.assign`.
- REST equivalent: `GET /api/v1/creator-managers/staff`.
- Parameters: none.

### agency/creators.managers.unassign

Remove a manager from a creator's assignments.

- Class: `destructive` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `creators.assign`.
- REST equivalent: `DELETE /api/v1/creator-managers/{creatorUserId}/{agentUserId}`.
- Parameters:
  - `agentUserId` (string, required)
  - `creatorUserId` (string, required)

### agency/creators.timeseries

One creator's daily series for a metric.

- Class: `read`.
- Requires: `creators.get or creators.getManaged`.
- REST equivalent: `GET /api/v1/creators/{userId}/timeseries`.
- Parameters:
  - `from` (string)
  - `metric` (`grev` | `streamActivity`)
  - `to` (string)
  - `userId` (string, required)

### agency/grow.potential

Potential earners and the estimated added revenue (Grow feature).

- Class: `read`.
- Requires: `grow.get` and the grow feature.
- REST equivalent: `GET /api/v1/grow/potential`.
- Parameters: none.

### agency/live.now

Creators streaming right now.

- Class: `read`.
- Requires: `live.get`.
- REST equivalent: `GET /api/v1/live-now`.
- Parameters: none.

### agency/recordings.list

Stream recordings, filterable by creator and title.

- Class: `read`.
- Requires: `recordings.get`.
- REST equivalent: `GET /api/v1/recordings`.
- Parameters:
  - `limit` (integer)
  - `offset` (integer)
  - `title` (string)
  - `userId` (string)