使用说明
Dynamoi MCP Server
Music promotion and distribution, built for AI agents.
Dynamoi's MCP server lets your AI assistant promote music for independent artists, labels and managers. Ask it how a campaign is doing, build free Smart Links, and, with the artist's explicit consent, launch real Spotify and YouTube ad campaigns. It works with whatever distributor the artist already uses.
https://dynamoi.com/mcp
The server is hosted, so there is nothing to install. Add the URL to any MCP client that supports remote Streamable HTTP and OAuth, then sign in with your Dynamoi account.
Connect
Each client opens the Dynamoi sign-in page the first time you use it.
Claude Code
claude mcp add --transport http dynamoi https://dynamoi.com/mcp
Run /mcp in Claude Code to sign in. For the plugin with Dynamoi skills,
see agent plugins.
Claude (web and desktop)
Open Settings → Connectors, choose Add custom connector, and enter
https://dynamoi.com/mcp.
ChatGPT
Open the Dynamoi app in the ChatGPT directory.
In developer mode you can instead add a custom app with the URL
https://dynamoi.com/mcp and OAuth sign-in.
Codex CLI
codex mcp add dynamoi --url https://dynamoi.com/mcp
codex mcp login dynamoi
Cursor
Or add this to ~/.cursor/mcp.json:
{ "mcpServers": { "dynamoi": { "url": "https://dynamoi.com/mcp" } } }
VS Code
Or add this to .vscode/mcp.json:
{ "servers": { "dynamoi": { "type": "http", "url": "https://dynamoi.com/mcp" } } }
Gemini CLI
gemini extensions install https://github.com/getDynamoi/agent-plugins --auto-update
Then run /mcp auth dynamoi.
OpenClaw
openclaw mcp add dynamoi --url https://dynamoi.com/mcp --transport streamable-http --auth oauth \
--oauth-client-metadata-url https://dynamoi.com/api/oauth/clients/openclaw \
--oauth-scope "offline_access dynamoi:read dynamoi:mcp.full dynamoi:billing.read dynamoi:campaign.launch dynamoi:campaign.write dynamoi:distribution.apply dynamoi:distribution.read dynamoi:platform.read dynamoi:platform.write dynamoi:smart_links.write"
openclaw mcp login dynamoi
openclaw skills install @getdynamoi/dynamoi
The last line adds the dynamoi skill, which teaches
the agent Dynamoi's workflows and safety rules.
Any other MCP client
Add https://dynamoi.com/mcp as a remote Streamable HTTP server. The client
must handle the OAuth 401 challenge. Stdio-only clients need a
remote-to-stdio bridge. Per-client notes and OAuth scopes are in
Connect your AI agent.
What you can ask
How did the Smart Campaign for my new single do last week? Which countries brought the most Spotify listeners?
Make a Smart Link for this Spotify album and give me the link to share.
Import my Spotify catalog as Smart Links and show me the artist hub.
Run a growth audit on my artist profile. What are the three things to fix first?
Launch a $15/day Smart Campaign for my single in the US and Canada.
My YouTube channel wants subscribers. Which campaign strategy fits, and what would $150 get me started with?
Am I eligible for Dynamoi distribution yet?
What Dynamoi does
Dynamoi is a music promotion platform for independent artists, labels, managers and YouTube creators, on any distributor.
- Smart Campaigns. The Dynamoi team runs Instagram and Facebook ads for each release, optimized for listeners who go on to Spotify, not for likes.
- YouTube campaigns. Google video ads optimized for the goal the channel picks: subscribers, organic views or measured AdSense return.
- Free tools. Smart Links, analytics and growth audits on every plan.
- Distribution, if you want it. Eligible artists can release to 100+ stores and keep their masters and 90% of net receipts. Artists who prefer their current distributor keep it and use everything else.
Campaigns run on official Meta and Google ad networks, never bots, fake streams or playlist pitching. Results are measured and shown as they are, including what did not work.
Money and permissions
- Smart Links are free. Starter is $25/month per artist, and the plan includes monthly campaign credit. Campaigns run from $10 a day. See pricing.
- Nothing is charged without consent. Every launch, budget change or
card-funded resume needs the artist to accept the exact consent text, which
the agent passes back as a version and hash. Without it the server refuses
the call and charges nothing. The consent values are exported from
@dynamoi/mcp/consent. - Agents never see payment details. Plans and cards are set up only in the Dynamoi dashboard. Shop checkout tools return an unpaid Stripe link; the user pays on Stripe.
- Each client gets one of two tool sets, chosen from the identity it signs
in with. Reviewed clients and apps that sign in on your own computer
(Claude Code, Codex, Cursor, VS Code, Gemini CLI, OpenClaw and the
dynamoiCLI) get All 57 tools. ChatGPT, Claude added from its directory listing and other web apps get 24 review-safe advertised tools: reads, Smart Links, distribution applications and About, with no billing, launches or checkout. - Sign-in is OAuth 2.1, and every call still checks its scopes and the user's role for that artist. See client permissions.
Tools
"Reads" tools are read-only; "Changes data" tools write to Dynamoi or start a provider action. Full descriptions and input schemas come from tools/list.
| 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 campaign analytics; full profile also includes qualified artist-wide Smart Link totals and up to ten top links | 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_onboard_artist |
Search or preview Spotify artists; intake Spotify or YouTube artists with workspace caps and claim checks | Changes data | Full |
dynamoi_get_platform_status |
Spotify, Meta, and YouTube connection status and setup blockers | Reads | Both |
dynamoi_get_distribution_status |
Application, agreement, scoped catalog and latest release status; artist attestation and store delivery stay in web/app | Reads | Full |
dynamoi_prepare_distribution_release |
Private 30-minute metadata, track and split proposal handoff; the artist reviews and submits on web | Changes data | Full |
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_smart_link_controls |
Native catalog sync, availability, tracking and promote analytics | 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_action_center |
Artist Action Center revision, task states and distinct actions | Reads | Full |
dynamoi_get_earnings |
Authenticated payee own-USD earnings, month axis, filtered detail pages, rankings, geographic views and statement export data; no payout/tax authority | Reads | Full |
dynamoi_get_team |
Organization members and pending invitations; organization authority required. | Reads | Full |
dynamoi_get_artist_billing_country |
Read current billing country; not tax residency. | Reads | Full |
dynamoi_manage_team |
Change organization member roles, remove members or revoke pending invitations with web authority and owner protections. | Changes data | Full |
dynamoi_get_audit_log |
Sanitized artist/organization audit events with scope-bound cursors, plus your 12 recent account activity entries. | Reads | Full |
dynamoi_claim_referral_code |
Claim or change your own referral code. Accept program terms yourself in the app or web. | Changes data | Full |
dynamoi_get_referrals |
Your referral snapshot; no attribution or commission writes. Pending and available amounts are not approved or paid payouts. | Reads | Full |
dynamoi_get_billing |
Billing status, credit balance, promo limits and masked payment-method display | Reads | Full |
dynamoi_add_campaign_funds |
Create the unpaid Add campaign funds Stripe Checkout link, after the user approves the amount and currency | Changes data | 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_campaign |
Launch a Smart Campaign or YouTube campaign | Changes data | Full |
dynamoi_update_campaign |
Pause, resume, or change a campaign's budget or end date | Changes data | Full |
dynamoi_smart_campaign_ad_copy |
Read/save Smart Campaign creation-draft copy with shared validation and revision checks; never submits or launches | Changes data | Full |
dynamoi_manage_smart_campaign_creative |
All 9 native draft creative operations: read generation/source audio, start/retry/clear asynchronous generation (poll with read), select creatives, and start/status/complete/abort direct MP3 multipart upload or import_source_audio from a public Dropbox share link on a draft; Google Drive unsupported (Google API key required); no approval or submission | Changes data | Full |
dynamoi_manage_youtube_draft |
Inspect an interrupted YouTube launch draft, or discard it when the user asks | Changes data | Full |
dynamoi_start_meta_connection |
Start the Facebook Page and Instagram connection in the browser | Changes data | Full |
dynamoi_start_youtube_channel_link |
Start the YouTube channel connection in the browser | Changes data | Full |
dynamoi_contact_support |
Send a support request or feedback to Dynamoi | Changes data | Full |
dynamoi_delete_account |
Preview eligibility and explicitly start irreversible account deletion; cleanup is asynchronous and required records may be retained | Changes data | Full |
dynamoi_update_account_profile |
Preview or explicitly confirm a display name or preferred language change | Changes data | Full |
dynamoi_set_artist_billing_country |
Preview or explicitly confirm an artist checkout-currency suggestion country; existing currency stays fixed | Changes data | Full |
dynamoi_shop_list_orders |
Read your authorized artist’s newest Shop order status and fulfillment timestamps | Reads | Full |
dynamoi_shop_get_quote |
Estimate a one-off YouTube promotion | Reads | Full |
dynamoi_shop_create_checkout |
Create an unpaid Stripe Checkout link for that promotion | Changes data | Full |
The full-only Studio tools (dynamoi_update_smart_link_release_settings and
dynamoi_update_smart_link_artist_hub_settings) are never listed in the
directory profile. Previously approved directory clients may keep calling
dynamoi_update_smart_link with its approved schema and the same checks.
FAQ
Do I have to switch distributors?
No. Campaigns, Smart Links and analytics work with music released through any distributor. Distribution through Dynamoi is optional and application-based: it opens at 1,000 Spotify followers and 10,000 monthly listeners, and the artist decides whether to apply.
Can the assistant spend money on its own?
No. Paid calls are refused unless the artist accepted the consent text for that exact budget. Keep your client's approval prompt on for tools that change data, and no tool starts a subscription.
Why does ChatGPT see fewer tools than Claude Code?
Directory-listed and web clients get the review-safe set. Apps that sign in on your own computer get the full set. The server decides from the OAuth client identity, not from what the client says about itself.
Which MCP versions does it support?
MCP 2026-07-28 (stateless, with server/discover) and 2025-11-25 and earlier
initialize-based revisions, over Streamable HTTP POST. The server keeps no
sessions, so GET and DELETE return 405. Details:
MCP server docs.
Can I use this package as a library?
Yes, if you are building against the Dynamoi MCP contract. Most people should connect to the hosted server instead.
npm install @dynamoi/mcp
The package is ESM-only and built on MCP TypeScript SDK v2.
| Entry point | Main exports |
|---|---|
@dynamoi/mcp |
createDynamoiMcpServer, handleMcpHttpRequest, getDynamoiToolDefinitions, DynamoiMcpToolProfile, Phase3Adapter, tool schemas, About exports, result types, DYNAMOI_MCP_VERSION |
@dynamoi/mcp/auth |
DYNAMOI_BETTER_AUTH_MCP_SCOPES, DYNAMOI_MCP_TOOL_SCOPES, buildWwwAuthenticateHeader |
@dynamoi/mcp/consent |
Current and previous budget-funding consent versions, copy and hashes, plus isCurrentProspectiveBudgetFundingConsent and isRenewableProspectiveBudgetFundingConsent |
A host supplies a Phase3Adapter that connects each tool to its services, and
authenticates the request and checks scopes before calling
handleMcpHttpRequest({ request, parsedBody, createServer }). This package
does not verify tokens. Every request builds a new server.
Where do I get help?
dynamoi.com/support or support@dynamoi.com.
We reply within 24 hours. Agents can also send a request with
dynamoi_contact_support.
Links
- MCP server docs and agent overview (
llms.txt) - MCP Registry entry and npm
- Changelog, capability map and issues
MIT licensed. See LICENSE.
Part of Dynamoi · MCP server · CLI · Agent plugins · Homebrew tap · Chrome extension · dynamoi.com · Docs · Support
