mcp

# Dynamoi MCP Server

**Music marketing for AI agents.**

[![npm version](https://img.shields.io/npm/v/@dynamoi/mcp?label=npm)](https://www.npmjs.com/package/@dynamoi/mcp)
[![license](https://img.shields.io/npm/l/@dynamoi/mcp)](./LICENSE)
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.getDynamoi%2Fdynamoi-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.getDynamoi/dynamoi)
[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=dynamoi&config=eyJ1cmwiOiJodHRwczovL2R5bmFtb2kuY29tL21jcCJ9)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dynamoi&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdynamoi.com%2Fmcp%22%7D)

The Dynamoi MCP server connects ChatGPT, Claude, Cursor, and other AI agents
to [Dynamoi](https://dynamoi.com), the music marketing platform for artists,
labels, and managers. Agents can create free Spotify Smart Links, run managed
YouTube and Meta promotion campaigns, read campaign and Smart Link analytics,
check platform status, and apply for music distribution. Use the hosted MCP
server, or use this package as a library.

```txt
https://dynamoi.com/mcp
```

The hosted server needs no install. Point any MCP client that supports remote
Streamable HTTP and OAuth at that URL, and the user signs in with their
Dynamoi account.

## About Dynamoi

Dynamoi is a music marketing platform founded in 2021 by Trevor Loucks. It
runs managed Meta and YouTube ad campaigns, music distribution, and royalty
analytics for independent artists, labels, managers, and YouTube creators,
alongside free Smart Links and analytics.

- **Free Smart Links:** release pages and artist hubs built from Spotify
  URLs, with link analytics, themes, validated pixel IDs, and team seats.
- **Managed Smart Campaigns:** Meta ads that promote Spotify tracks, albums,
  and playlists.
- **YouTube campaigns:** managed Google Ads campaigns for YouTube channel
  growth.
- **Music distribution:** opt-in delivery to 100+ stores. Applications are
  scored against five requirements, and approval is not guaranteed.
- **YouTube promotion Shop:** one-off YouTube video promotion with no
  subscription.

Campaigns run on Dynamoi's own managed Meta and Google ad infrastructure. They
reach real people through official ad networks, never bots, fake streams, or
paid playlist placement. Results vary and are never guaranteed.

Dynamoi is based in Sioux Falls, South Dakota, and is operated by humans,
assisted by AI. People make the decisions and are accountable for every
campaign and support reply. AI helps with ad creative, campaign monitoring,
reporting, and routine tasks.

Smart Links are free. Starter is $25/month with a $50 launch campaign credit,
and campaign budgets start at $10/day. See
[pricing](https://dynamoi.com/pricing).

Agents can read the same overview before sign-in through the `dynamoi_about`
tool or the `dynamoi://about` resource.

## Connect

Each client opens the Dynamoi sign-in page on first use.

### ChatGPT

Open the [Dynamoi app in the ChatGPT directory](https://chatgpt.com/plugins/plugin_asdk_app_69ceb0e849788191aa3fd4d416204a9d).
In developer mode you can instead add a custom app with the MCP server URL
`https://dynamoi.com/mcp` and OAuth authentication. ChatGPT gets the
[directory catalog](#which-tools-a-client-sees).

### Claude (web and desktop)

Open **Settings → Connectors**, choose **Add custom connector**, and enter
`https://dynamoi.com/mcp`.

### Claude Code

```bash
claude mcp add --transport http dynamoi https://dynamoi.com/mcp
```

Then run `/mcp` in Claude Code to sign in.

The Dynamoi plugin from the
[agent plugins repository](https://github.com/getDynamoi/agent-plugins)
bundles Dynamoi skills with the directory catalog on
`https://dynamoi.com/mcp/directory`:

```txt
/plugin marketplace add getDynamoi/agent-plugins
/plugin install dynamoi@dynamoi
```

### Cursor

Use the **Add to Cursor** badge above, or add Dynamoi to `~/.cursor/mcp.json`
(or `.cursor/mcp.json` in a project):

```json
{
  "mcpServers": {
    "dynamoi": {
      "url": "https://dynamoi.com/mcp"
    }
  }
}
```

### VS Code

Use the **Install in VS Code** badge above, or add Dynamoi to
`.vscode/mcp.json`:

```json
{
  "servers": {
    "dynamoi": {
      "type": "http",
      "url": "https://dynamoi.com/mcp"
    }
  }
}
```

### Gemini CLI

Install the Dynamoi extension from the
[agent plugins repository](https://github.com/getDynamoi/agent-plugins):

```bash
gemini extensions install https://github.com/getDynamoi/agent-plugins
```

### Codex CLI

```bash
codex mcp add dynamoi --url https://dynamoi.com/mcp
codex mcp login dynamoi
```

Or add the server to `~/.codex/config.toml` and run `codex mcp login dynamoi`:

```toml
[mcp_servers.dynamoi]
url = "https://dynamoi.com/mcp"
```

### Other MCP clients

Use `https://dynamoi.com/mcp` as a remote Streamable HTTP server. The client
must handle an OAuth 401 challenge (MCP authorization). Stdio-only clients
need a remote-to-stdio bridge.

## Which tools a client sees

The server has two tool catalogs. It picks one from the OAuth client that
signed in, not from anything the client claims about itself.

| Catalog | Who gets it | What it includes |
| --- | --- | --- |
| **Directory** | Every client on `https://dynamoi.com/mcp/directory` (used by agent-directory listings such as the Dynamoi Claude plugin), the published ChatGPT app on `/mcp`, and requests made before sign-in | 24 review-safe advertised tools: reads, Smart Links, distribution, and About. No billing, campaign launch or campaign changes, platform connection starters, or Shop checkout. |
| **Full** | Every other signed-in client on `https://dynamoi.com/mcp`, such as Claude custom connectors, Claude Code, Cursor, VS Code, Gemini CLI, Codex CLI, and custom agents | All 37 tools, plus the Dynamoi prompts and reference resources |

Signing in does not skip permission checks. Every tool call still needs its
OAuth scopes, and the user's role must allow access to the artist, campaign,
or Smart Link.

## Tools

"Reads" tools are marked read-only. "Changes data" tools write to Dynamoi or
start an action with an outside provider.

| Tool | What it does | Access | Catalog |
| --- | --- | --- | --- |
| `dynamoi_about` | What Dynamoi is and how to start. Works before sign-in. | Reads | Both |
| `dynamoi_open_workspace` | Open a read-only workspace for the authorized artist roster; supported hosts can browse campaigns and Smart Links | Reads | Both |
| `dynamoi_get_account_overview` | Signed-in account, access counts and suggested next steps | Reads | Both |
| `dynamoi_list_artists` | Artist roster, or one artist's profile and readiness | Reads | Both |
| `dynamoi_search` | Find artists, campaigns, and Smart Links by name | Reads | Both |
| `search` / `fetch` | ChatGPT deep research search and fetch | Reads | Both |
| `dynamoi_list_campaigns` | An artist's campaigns, with type and status filters | Reads | Both |
| `dynamoi_get_campaign` | One campaign, with optional analytics, delivery status, and countries | Reads | Both |
| `dynamoi_get_artist_analytics` | Artist-level analytics across campaigns | Reads | Both |
| `dynamoi_get_growth_audit` | Spotify growth score, recommendations, listener trends, and playlist reach with status and coverage evidence | Reads | Both |
| `dynamoi_get_playlist_analytics` | Tracked playlist placements, reach, and movement with freshness and snapshot dates | Reads | Both |
| `dynamoi_get_audience_analytics` | Streaming audience by date range, country, service, and paid/free tier | Reads | Both |
| `dynamoi_get_youtube_channel_data` | Observed YouTube channel data by dataset, with coverage and campaign dates | Reads | Both |
| `dynamoi_get_platform_status` | Spotify, Meta, and YouTube connection status and setup blockers | Reads | Both |
| `dynamoi_get_distribution_application` | The five distribution requirements and application status | Reads | Both |
| `dynamoi_apply_for_distribution` | Submit a distribution application for manual review | Changes data | Both |
| `dynamoi_preview_smart_link_themes` | Visual preview of the Smart Link themes | Reads | Both |
| `dynamoi_create_smart_link_from_spotify` | Create a free Smart Link from a Spotify album or track | Changes data | Both |
| `dynamoi_create_smart_links_from_spotify_artist` | Import an artist's catalog as free Smart Links and return the artist hub | Changes data | Both |
| `dynamoi_list_smart_links` | An artist's Smart Links and public URLs | Reads | Both |
| `dynamoi_get_smart_link` | One Smart Link, with optional analytics and artist settings | Reads | Both |
| `dynamoi_update_smart_link_description` | Update one Smart Link's public description | Changes data | Directory |
| `dynamoi_update_smart_link_artist_settings` | Update an artist's Smart Link theme or validated pixel settings | Changes data | Directory |
| `dynamoi_update_smart_link` | Prior multi-action schema for description or artist settings | Changes data | Full |
| `dynamoi_update_smart_link_release_settings` | Update one Smart Link's release video or destination visibility | Changes data | Full |
| `dynamoi_update_smart_link_artist_hub_settings` | Update an artist's hub introduction, official profile links or service order | Changes data | Full |
| `dynamoi_get_billing` | Billing status, credit balance, and promo limits | Reads | Full |
| `dynamoi_get_resume_funding` | Campaign resume-funding breakdown, refusal, and consent requirements | Reads | Full |
| `dynamoi_list_available_countries` | Countries a Smart Campaign or YouTube campaign can target | Reads | Full |
| `dynamoi_get_campaign_readiness` | Check launch inputs before creating anything | Reads | Full |
| `dynamoi_list_media_assets` | Uploaded images and videos that a launch can reuse | Reads | Full |
| `dynamoi_launch_