Soundlink
Connect Meta ads to Spotify listening: compare attributed listeners, cost per listener, campaign and creative performance, and repeat listening with read-only Soundlink analytics.
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://api.getsoundlink.com/mcp'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
MCP server
Connect Claude or Cursor to your Soundlink organization. Read-only tools over a hosted MCP server.
Soundlink hosts an MCP server. An AI client calls it over Streamable HTTP and gets read-only access to your organization. It does not create campaigns, change budgets, or import videos.
https://api.getsoundlink.com/mcp
Pick a client
[card] Claude
Install from the Claude Directory. Browser login — no OAuth app.
[card] Cursor
Install the Soundlink plugin and paste an API key.
[card] Other clients
Any Streamable HTTP or CIMD client via the MCP URL.
Credentials at a glance
| Path | When to use |
|---|---|
| Claude Directory / CIMD | Claude and other clients that open a browser login with a Client ID Metadata Document. You do not create an OAuth app. |
| API key | Cursor plugin and any client that can send Authorization: Bearer sk_.... |
| OAuth app | Clients that ask for a client id and secret and do not use CIMD. |
Owners and admins create keys and OAuth apps in Settings. A credential that should read everything the server exposes needs campaigns:read, metrics:read, soundlinks:read, and wallet:read. get_pixels also needs pixels:read.
Soundlink does not support RFC 7591 dynamic client registration. Clients that try to register at runtime still need an API key or an OAuth app.
Any CIMD client can connect. If Soundlink does not recognize the app, the consent screen says it is not verified and shows the host it will send you back to. Check that host before you approve.
One connection is one organization. To use another org, disconnect and approve that org on the next consent screen.
[card] API keys
Settings → Developer → API keys. Sign in first. Soundlink opens the keys page for your current organization.
[card] OAuth apps
Settings → Developer → OAuth apps. Same shortcut. Use this when the client asks for a client id and secret.
Check the connection
Ask the client to call ping. A working credential returns {"status":"ok"}. ping does not require a specific scope.
Then ask for a campaign list. If a tool fails with an authorization error, the key or app is missing the scope in the table below. Create a new key, or edit the OAuth app, and reconnect.
Tools
| Tool | Public API | Scope |
|---|---|---|
ping | GET /v1/ping | any valid credential |
get_campaigns | GET /v1/campaigns | campaigns:read |
get_campaign | GET /v1/campaigns/{campaignId} | campaigns:read |
get_campaign_tiers | GET /v1/campaigns/{campaignId}/tiers | campaigns:read |
get_campaign_activity | GET /v1/campaigns/{campaignId}/activity | campaigns:read |
get_campaign_metrics_overview | GET /v1/campaigns/{campaignId}/metrics/overview | metrics:read |
get_campaign_metrics_creatives | GET /v1/campaigns/{campaignId}/metrics/creatives | metrics:read |
get_campaign_metrics_creative_daily | GET /v1/campaigns/{campaignId}/metrics/creative-daily | metrics:read |
get_campaign_metrics_breakdown | GET /v1/campaigns/{campaignId}/metrics/breakdown | metrics:read |
get_campaign_metrics_engagement | GET /v1/campaigns/{campaignId}/metrics/engagement | metrics:read |
get_campaign_metrics_breakdown_export | GET /v1/campaigns/{campaignId}/metrics/breakdown/export | metrics:read |
get_campaign_metrics_engagement_export | GET /v1/campaigns/{campaignId}/metrics/engagement/export | metrics:read |
get_soundlinks | GET /v1/soundlinks | soundlinks:read |
get_soundlink | GET /v1/soundlinks/{soundlinkId} | soundlinks:read |
get_soundlink_metrics_overview | GET /v1/soundlinks/{soundlinkId}/metrics/overview | soundlinks:read |
get_soundlink_metrics_breakdown | GET /v1/soundlinks/{soundlinkId}/metrics/breakdown | soundlinks:read |
get_soundlink_metrics_engagement | GET /v1/soundlinks/{soundlinkId}/metrics/engagement | soundlinks:read |
get_soundlink_metrics_breakdown_export | GET /v1/soundlinks/{soundlinkId}/metrics/breakdown/export | soundlinks:read |
get_soundlink_metrics_engagement_export | GET /v1/soundlinks/{soundlinkId}/metrics/engagement/export | soundlinks:read |
get_strategies | GET /v1/strategies | campaigns:read |
get_wallet | GET /v1/wallet | wallet:read |
get_pixels | GET /v1/pixels | pixels:read |
get_campaign_tiers only succeeds for a wallet campaign. Each tier includes learningStatus (LEARNING, FAIL, SUCCESS, or null). get_campaign_activity is a page of creative adds, budget changes, and other campaign events. Omit startDate to page the full history. get_campaign_metrics_creative_daily is one row per day and Meta ad creative, not the lifetime groups from get_campaign_metrics_creatives. Engagement tools take an optional engagementContext of catalog or playlist. Exports default to the last 90 days and return JSONL, not the JSON envelope. get_soundlinks does not include soundlinks created for a campaign.
Field definitions: Campaign metrics, Soundlink metrics, JSONL exports.
Next
Claude · Cursor · Other clients · SDK overview · Authentication · OAuth
This documentation is built and hosted on Mintlify, a developer documentation platform.