---
name: agency-overview
description: Overview actions of the Favorited Agency Dashboard MCP server (5): overview.get, overview.health, overview.leaderboard, overview.timeseries, overview.topGifters.
metadata:
  area: overview
  actions: 5
  server: https://mcp.agency.preprod.favorited.app/mcp
---

# Overview 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/overview.get

The Overview page's headline tiles: revenue, active creators, streams and gifters with vs-previous deltas.

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

### agency/overview.health

The agency's health score and the signals behind it (Agency Health feature).

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

### agency/overview.leaderboard

The top creators of the period by revenue.

- Class: `read`.
- Requires: `overview.get`.
- REST equivalent: `GET /api/v1/overview/leaderboard`.
- Parameters:
  - `limit` (integer)
  - `month` (string)
  - `offset` (integer)

### agency/overview.timeseries

A daily series over the last 30 days for one metric (revenue, streams, hours, gifters, active creators).

- Class: `read`.
- Requires: `overview.get`.
- REST equivalent: `GET /api/v1/overview/timeseries`.
- Parameters:
  - `days` (integer)
  - `metric` (`revenue` | `creatorGrev` | `streamActivity`)

```json
{
  "action": "agency/overview.timeseries",
  "params": {
    "metric": "revenue"
  }
}
```

### agency/overview.topGifters

The gifters supporting the roster this month (Top Gifters feature).

- Class: `read`.
- Requires: `overview.get` and the topGifters feature.
- REST equivalent: `GET /api/v1/overview/top-gifters`.
- Parameters:
  - `limit` (integer)
  - `month` (string)
  - `offset` (integer)