---
name: agency-agency
description: Agency admin actions of the Favorited Agency Dashboard MCP server (14): agency.settings, agency.settings.update, audit.actions, audit.list, members.add, members.candidates, members.changeRole, members.list, members.remove, roles.catalog, roles.create, roles.delete, roles.list, roles.update.
metadata:
  area: agency
  actions: 14
  server: https://mcp.agency.preprod.favorited.app/mcp
---

# Agency admin 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/agency.settings

The agency's profile: name, legal name, description.

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

### agency/agency.settings.update

Edit the agency's name, legal name or description.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `agency.settings.manage`.
- REST equivalent: `PATCH /api/v1/agency/settings`.
- Parameters:
  - `description` (string)
  - `legalName` (string)
  - `name` (string)

### agency/audit.actions

The normalized action names the Activity log can filter on.

- Class: `read`.
- Requires: `agency.audit.get`.
- REST equivalent: `GET /api/v1/agency/audit/actions`.
- Parameters: none.

### agency/audit.list

The Activity log (admin action trail).

- Class: `read`.
- Requires: `agency.audit.get`.
- REST equivalent: `GET /api/v1/agency/audit`.
- Parameters:
  - `action` (string)
  - `from` (string)
  - `limit` (integer)
  - `memberId` (string)
  - `offset` (integer)
  - `operation` (`create` | `update` | `delete` | `login` | `logout` | `webhook`)
  - `to` (string)

### agency/members.add

Add a member with a role.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `agency.members.manage`.
- REST equivalent: `POST /api/v1/agency/members`.
- Parameters:
  - `roleId` (string, required)
  - `userId` (string, required)

### agency/members.candidates

Users who could be added as members.

- Class: `read`.
- Requires: `agency.members.manage`.
- REST equivalent: `GET /api/v1/agency/members/candidates`.
- Parameters:
  - `q` (string)

### agency/members.changeRole

Change a member's role.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `agency.members.manage`.
- REST equivalent: `PATCH /api/v1/agency/members/{userId}`.
- Parameters:
  - `roleId` (string, required)
  - `userId` (string, required)

### agency/members.list

Agency members and their roles.

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

### agency/members.remove

Remove a member from the agency.

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

### agency/roles.catalog

The permission catalog roles are built from.

- Class: `read`.
- Requires: `agency.roles.get`.
- REST equivalent: `GET /api/v1/agency/permission-catalog`.
- Parameters: none.

### agency/roles.create

Create a custom role (Custom Roles feature).

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `agency.roles.manage` and the customRoles feature.
- REST equivalent: `POST /api/v1/agency/roles`.
- Parameters:
  - `name` (string, required)
  - `permissions` (array, required)

### agency/roles.delete

Delete a custom role that no member holds.

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

### agency/roles.list

Roles and their permissions.

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

### agency/roles.update

Edit a custom role's name or permissions.

- Class: `write` — requires the Write scope, writes enabled for the account, and `confirm: true` after the user approved.
- Requires: `agency.roles.manage` and the customRoles feature.
- REST equivalent: `PATCH /api/v1/agency/roles/{roleId}`.
- Parameters:
  - `name` (string, required)
  - `permissions` (array, required)
  - `roleId` (string, required)