MCP server
How to connect MTWSPY to Claude, Claude Code and Cursor over MCP — server URL, key, available tools and what they cost.
MCP (Model Context Protocol) is how AI assistants call external tools. Through the MTWSPY MCP server an assistant can search creatives, open cards, get landing page links and check your remaining views.
Server URL
https://mcp.mtwspy.com/mcp, Streamable HTTP transport. It takes the same mtw_live_… key
as the REST API (Authentication), but in the X-API-Key header.
Connecting
- Open Settings → Connectors and add your own connector (Add custom connector).
- Name it
MTWSPYand set the URL tohttps://mcp.mtwspy.com/mcp. - Under Advanced settings → Request headers, add the
X-API-Keyheader with your key. - Turn the connector on in a chat from the tools menu.
Anyone with the key can spend your account's views. Don't commit a config with the key in it.
Tools
| Tool | What it does | Views |
|---|---|---|
search_creatives | Search with the same filters as /creatives. 20 cards by default | 1 per card |
get_creative | One card by id, like /creatives/{id} | Free |
get_landing_download_url | Temporary link to the landing archive, like /creatives/{id}/landing | Free; 30 per hour |
get_usage | Plan, request limit and remaining views, like /usage | Free |
get_referral_balance | Referral balance, like /balance | Free |
The same search_creatives request repeated within 2 hours isn't charged again. Before a
large pull, ask the assistant to call get_usage.
Example prompts
- "Find 10 nutra video creatives targeting Poland from the last week, sorted by reach."
- "Open card 2255582 and show where the ad button leads."
- "Download the landing page for this creative."
- "How many views do I have left?"
Errors
Error codes are the same as in the REST API (full list in the overview). When views run
out you get quota_exhausted. On rate_limited, wait retry_after seconds.
missing_api_key means the connection has no X-API-Key header.