The Motion MCP exposes Motion Creative Analytics data through a read-only MCP server with 13 tools across five categories, accessible from any MCP-compatible client. Once authenticated via OAuth 2.0, your AI tool can query creative performance, competitor analysis, saved reports, brand context, and workspace taxonomy directly.
Think of it as a bridge between Motion and the AI tools you already use. Ask a question, get an answer powered by your actual account data. No copy-pasting, no context switching.
MCP (Model Context Protocol) is an open standard that works across AI platforms. Connect once and you're good to go.
What you can do with the Motion MCP
The MCP connects your AI tool to 13 specialized tools across five categories. Here's what that unlocks:
Analyze your creative performance
Ask about your top ads, sort by any metric (ROAS, spend, CPA, CTR, and more), filter by date range, and get AI-generated summaries of what's working. Drill into individual creatives for detailed breakdowns, pull video transcripts to analyze hooks, and see demographic performance splits by age and gender.
Research competitors and brands
Browse any competitor's ad library, understand their creative strategy, messaging angles, and brand positioning. Search for any brand by name or domain. You're not limited to brands you already track in Motion.
Work with your saved reports and taxonomy
Access your saved Motion reports and your full glossary of creative tags. This lets the AI understand your team's taxonomy so it can filter and analyze creatives using the categories and labels you've already set up.
Generate briefs and concepts grounded in real data
Because the AI has access to both your performance data and competitor analysis, it can help you write creative briefs, suggest new concepts, or identify trends, all informed by what's actually working in market.
Before you connect
Make sure you've got the following:
A Motion account. When you authenticate the MCP, you'll log in with your existing Motion credentials. Don't have an account yet? You can sign up during the authentication flow and get a 14-day trial.
The right permissions. Only Owners, Admins, and Collaborators can use the MCP. If you don't have access, ask your workspace admin to update your role.
A connected data source (recommended). To get the most out of the MCP, connect at least one ad platform data source in Motion so there's actual performance data to analyze.
MCP Server URL
All connections use the same server URL:
https://projects.motionapp.com/mcp
You can also find this in your Motion account under My Account → My Integrations.
Get set up
Within your workspace settings under your Account-level settings you will find the My Integrations tab. Within this you will find instructions for Claude, ChatGPT, Cursor, and Command Line connections.
Connect to Claude
Claude supports the Motion MCP through its Connectors feature. There are two steps: an admin adds the connector to the Claude workspace, then individual users connect.
Admin setup (one-time)
A Claude workspace admin needs to add Motion as a connector for the organization first. This makes it available for everyone in the workspace.
User setup
In Claude, go to Settings → Connectors (or go to claude.ai/settings/connectors directly)
Select Add Custom Connector
Name the connection (e.g., "Motion") and paste the MCP Server URL into the URL field:
https://projects.motionapp.com/mcpClick Add
You'll be refreshed into the Claude Connectors page where you'll now see the Motion MCP. Select Connect
When prompted by your browser, select Open Claude
Complete the Motion authentication flow in the browser window that opens
Once you're connected, start asking Claude questions about your Motion data!
Connect to ChatGPT
ChatGPT supports MCP connections through its Apps settings.
In ChatGPT, go to Settings → Apps (or go to chatgpt.com/#settings/Connectors directly)
Select Advanced Settings
Turn on Developer mode to create an app
Click Create App
Name the connection (e.g., "Motion") and paste the MCP Server URL into the URL field:
https://projects.motionapp.com/mcpClick Create
You'll be prompted to authenticate the connection in your browser. Select Allow
Return to ChatGPT and select the Motion app again
Click Connect
When prompted, click Continue to Motion and complete the authentication
Connect to Cursor
Cursor has a one-click setup.
In Motion, go to My Account → My Integrations
Find the Cursor section and click Add to Cursor
Cursor will open and prompt you to confirm the MCP server connection
Complete the Motion authentication flow
You can also add the server manually through Cursor's MCP tools page by searching for the Motion MCP server URL.
Connect via command line (other MCP clients)
For any MCP-compatible client not listed above, you can connect by providing the server URL. Most clients accept a configuration like:
{ "mcpServers": { "motion": { "url": "https://projects.motionapp.com/mcp" } }}
Or just prompt your AI client directly:
I need to add this MCP server, give me the CLI command: https://projects.motionapp.com/mcp
Your client will walk you through the authentication flow from there.
Authentication and permissions
When you connect the Motion MCP for the first time, you'll go through an OAuth flow where you log in to your Motion account. This securely grants your AI tool access to your data without sharing your password.
Keep in mind:
You need to authenticate with an existing Motion account, or sign up for a new one (14-day trial included).
Only Owners, Admins, and Collaborators have MCP access. Users with other roles won't be able to authenticate.
Once authenticated, you'll have access to all workspaces across all organizations where you have permissions. The same data you can see in the Motion app.
Each user authenticates individually. Your AI tool only sees data you have permission to access.
Available tools
The Motion MCP gives your AI tool access to 13 tools organized into five categories. Your AI tool calls these automatically based on your questions. You don't need to reference tool names directly.
Auth and context
Tool | What it does |
Auth Context ( | Returns your organizations and workspaces. Called automatically as the first step in any session. If you only have one workspace, it's selected by default. |
Creative performance (your own ads)
Tool | What it does |
Creative Insights ( | The primary analytics tool. Returns your creatives ranked by performance. Sort by spend, ROAS, purchases, CPA, CPC, CTR, hook rate, scaling status, or purchase value. Supports date filtering, custom conversion metrics, and AI tag filtering. |
Creative Summary ( | Gets an AI-generated digest for a single creative: detected format, plain-language summary, best hook/headline, and CTAs. Use this when you want to understand what a specific ad is doing. |
Creative Transcript ( | Pulls the spoken transcript of a video creative with timed segments. The first 1-3 seconds represent the hook. Includes language detection and English translation for non-English content. Video format only. |
Demographic Breakdown ( | Breaks down ad performance by age (18-24 through 65+) and gender. Metrics include spend, ROAS, purchase value, cost per purchase, and thumbstop ratio. Defaults to the last 7 days. |
Workspace context
Tool | What it does |
Workspace Brand ( | Returns your brand's positioning, voice, and visual identity as configured in Motion. Pull this before generating concepts or briefs. |
Workspace Competitors ( | Lists the competitor brands you're tracking in Motion: names, domains, categories, follower counts, and active ad counts. Your starting point for competitive analysis. |
Competitor and brand intelligence (Inspo)
Tool | What it does |
Search Brands ( | Search for any brand by name or domain. Returns matching brands with IDs, logos, and industry info. Use this when you want to look up a brand that isn't in your tracked competitors. |
Brand by Domain ( | Resolves a brand from a website URL or domain. Handy when you have a URL and want to pull up that brand's ad library or context. |
Inspo Creatives ( | Retrieves creatives from a brand's ad library: format, copy, headline, CTA, launch date, status, days active, landing page, and file URLs. Sort by newest/oldest, filter by date or status, and apply AI tags. Note: this shows creative metadata, not performance metrics (those are only available for your own ads). |
Inspo Brand Context ( | Returns deep brand intelligence: positioning, voice, tone, messaging angles, product info, and customer voice analysis. The strategic layer for understanding a brand's approach. |
Saved reports
Tool | What it does |
Reports ( | Two modes: call without a report ID to list all your saved reports, or with a report ID to get the full configuration including filters, attribution windows, metrics, and comparison settings. Supports filtering by report type (top ads, creative comparison, sprints). |
AI Tags
Tool | What it does |
AI Tag Values ( | Returns your workspace's AI Tags. Common category examples include Asset Type, Visual Format, Messaging Angle, Hook Tactic, Headline Tactic, Intended Audience, Seasonality, and Offer Type. Can map tags back to specific creatives and filter to custom or specific categories. |
Thought starters to get you going
Below are prompts organized around the creative strategy flywheel, the same way you work in Motion. Copy any of these directly into your AI tool, or use them as jumping-off points.
Analyze
Creative Analytics
Look at my top performing ads from the last 30 days and tell me what is and isn't working right now
Look at my top performing ads from the last 30 days and identify the recurring themes, hooks, and creative patterns that are winning
Review our ads to understand what is working, what is not working, and why. Look at performance across all ads first, then break it down by product. From this analysis, create two short reports: one for the creative team that explains which types of ads are winning or losing and what to make or test next, and one for senior leadership that gives a high-level view of creative performance, key trends, and business impact. Both reports should be very visual, easy to understand, and focused only on the most important insights and next steps.
Break down what's working and what's not in this report. For the top performers, explain why they're winning. For the underperformers, explain what's holding them back.
Prepare talking points for my team review based on this report. Cover the highlights, lowlights, key learnings, and recommended next steps I should present.
Analyze the top performing ads in this report and identify the creative patterns they share. What formats, hooks, visual styles, or messaging approaches are the common threads?
Which ads in this report should I consider pausing or turning off? Look at the underperformers and tell me which ones aren't worth the spend, and why.
Which ads in this report show the strongest signals for scaling? Identify the ones that deserve more budget and explain what makes them good candidates.
Inspo
Break down this {competitorName} ad. Identify the hook, offer, messaging structure, creative format, and why it likely grabs attention in-feed.
Determine whether this {competitorName} ad is top, mid, or bottom funnel and explain the signals (message, proof, CTA, offer framing) that indicate that stage.
Analyze the offer and CTA in this {competitorName} ad. Explain the value proposition, urgency mechanics, and how the call-to-action drives the next step.
Critique this {competitorName} ad like a strategist. Identify weak points in message clarity, differentiation, trust signals, and execution that we could beat.
Compare this {competitorName} ad approach to my current creative strategy. Highlight the biggest gaps and 3 high-confidence tests I should run next.
Research
Creative Analytics
Analyze this brand's ad library and reverse engineer their creative strategy. What formats, hooks, testing velocity?
Explore what other brands in my category are doing right now. Show common ad themes, formats, and messages, and highlight anything that looks new or different.
Help define our main audiences, potential growth audiences, and their biggest pain points. Explain who each audience is, what they care about, and what problem our product solves for them.
Inspo
Analyze this {competitorName} ad and infer the target audience, buyer intent, pain points, and objections it is designed to overcome.
Extract repeatable creative patterns in this {competitorName} ad (hook style, pacing, proof, framing, visuals) and explain how to reuse them in new concepts.
Analyze {brandName}'s ad library and reverse engineer their creative strategy. What formats are they using? What hooks? What's their testing velocity?
Look at {brandName}'s recent ads and tell me what creative concepts, formats, and hooks they're currently testing.
Analyze what {brandName} is testing and identify gaps and opportunities I can explore for my own creative strategy.
Break down the different ad formats {brandName} is using. What mix of static, video, carousel, and UGC are they running?
Based on {brandName}'s ads, who are they targeting? What customer personas and pain points are they addressing?
Analyze {brandName}'s ad copy and messaging. What tone do they use? What benefits do they highlight? What CTAs work for them?
How has {brandName}'s creative strategy evolved over time? What changes have they made to their ad approach?
What winning creative patterns from {brandName} could I adapt for my own brand? Give me actionable takeaways.
Compare {brandName}'s creative strategy to what I'm running in my ad account. Where are the key differences and what can I learn?
How fast is {brandName} testing new creatives? What's their launch cadence and how many variations are they running?
What offers and promotions is {brandName} running in their ads? How are they structuring their deals and incentives?
Ideate & Brief
Creative Analytics
Think outside the box and give me some unconventional, creative ad concepts that could stand out in the feed.
Generate fresh hook ideas based on my top performing ads and creative patterns.
Help me write this week's creative briefs, with a mix of new ideas and iterations. Use recent performance learnings to guide what we should make, and keep the briefs simple and execution-ready.
Based on the performance data in this report, what types of ads should I create next? Give me specific creative directions, formats, and angles to test.
Use the top performing ads from this report to write a creative brief for my next round of production. Include the winning patterns, formats, and messaging approaches to replicate.
Based on this report's winners and losers, build me a creative testing plan. What hypotheses should I test next, what formats to try, and what to iterate on?
Inspo
Give me 5 ways to adapt this {competitorName} ad concept for my brand while preserving the core mechanism that makes it effective.
Generate 15 fresh hooks inspired by this {competitorName} ad's angle, split across curiosity, problem-solution, social proof, and contrarian styles.
Build a testing matrix from this {competitorName} ad: 5 hook variations x 3 offer framings x 2 CTA styles, with a one-line hypothesis for each.
Turn this {competitorName} ad into a production-ready creative brief with concept, message hierarchy, shot ideas, script direction, and success criteria.
Remix the core idea from this {competitorName} ad into 4 formats: UGC video, founder talk-to-camera, static image, and carousel. Include what changes in each format.
Generate fresh hook ideas based on {brandName}'s top performing ads and creative patterns.
Think outside the box and give me some unconventional, creative ad concepts inspired by {brandName}'s best work.
Based on {brandName}'s best performing ads, generate UGC-style concepts I could adapt for my brand.
Look at {brandName}'s video ads and give me ideas for static ads I could create based on their best moments and frames.
Feedback
Build me an onboarding pack for an agency or for UGC creators, anyone external. It should be a one-pager of what we're about, key learnings, dos and don'ts, etc.
Tips for better results
Start broad, then drill in. Begin with a high-level question like what are my top creatives by ROAS this month? and then follow up on specific creatives that catch your eye.
Mention time ranges. The MCP supports date filtering, so specifying last 7 days, this month, or a custom date range will give you more relevant results.
Use your AI tags. If your team has set up a creative taxonomy in Motion, reference those categories in your prompts. For example: show me my top performing UGC ads or which hook styles have the best thumbstop ratio?
Combine performance data with competitor research. One of the most powerful workflows is analyzing what's working for you, then comparing it against what competitors are running. This is gold for identifying gaps and opportunities.
Give the AI your brand context. If you're generating briefs or concepts, ask the AI to pull your brand context first. This grounds its output in your actual positioning and voice.
Be patient with async responses. Some tools (Creative Insights, Creative Summary, Demographic Breakdown) may return a "waiting" status while the report generates. The AI will automatically retry, just give it a moment.
Troubleshooting
I can't authenticate the MCP connection.
Make sure you're logging in with a Motion account that has Owner, Admin, or Collaborator permissions. Users with other roles won't be able to connect. If you're signing up for a new account, you'll receive a 14-day trial.
The AI says it can't access my data.
Check that you completed the OAuth flow fully. If you were interrupted during authentication, disconnect and reconnect the MCP from your AI tool's settings. Also verify you have the correct permissions in your Motion workspace.
I'm getting "waiting" responses.
This is expected! Some analytics tools generate reports asynchronously. The AI will automatically retry after a short delay. If it persists, try narrowing your query with a smaller date range or fewer filters.
I only see data from one workspace.
The MCP gives you access to all workspaces where you have permissions. If you have multiple workspaces, you may need to specify which one you're asking about. Try something like: switch to [workspace name] or show me data from [workspace name].
The AI isn't using the right tools or giving inaccurate results.
Try being more specific in your prompts. Mention the metric you care about, the date range, and whether you're asking about your own ads or a competitor's. The more context you give, the better the results.
Competitor data shows creative details but no performance metrics.
This is expected. Performance metrics (ROAS, spend, etc.) are only available for your own ads. Competitor analysis through Inspo shows creative details like format, copy, launch date, and status, but not performance data.
Security and data privacy
The Motion MCP uses OAuth 2.0 for authentication. Your credentials are never shared with or stored by your AI tool.
Each user authenticates individually and can only access data they have permissions for in Motion.
The MCP is read-only. It retrieves data from Motion but doesn't modify your account, creatives, or settings.
You can disconnect the MCP at any time from your AI tool's settings to revoke access immediately.
FAQs
Do I need a paid Motion account?
You need an active Motion account. If you don't have one, you can sign up during the MCP authentication flow and get a 14-day trial. To get the most out of the MCP, we recommend connecting at least one ad platform data source.
Which AI tools are supported?
The Motion MCP works with any AI tool that supports the Model Context Protocol, including Claude, ChatGPT, Cursor, and many others. Setup instructions for the most popular tools are above.
Can multiple team members connect?
Yes! Each team member authenticates individually and has access based on their own permissions in Motion. An admin doesn't need to set up the connection for each user (except for Claude, where a workspace admin must first add the connector).
What data can the AI access?
The AI can access the same data you see in Motion: your creative performance analytics, competitor ad libraries and brand intelligence, saved reports, and your workspace's AI tags and taxonomy. It cannot access billing information, account settings, or data from workspaces where you don't have permissions.
Is the MCP available on all Motion plans?
The MCP is currently in Alpha and available to users with Owner, Admin, or Collaborator roles. Plan-specific availability may change as we move toward general availability.
How do I disconnect?
Remove the Motion connector from your AI tool's settings (e.g., Settings → Connectors in Claude, or Settings → Apps in ChatGPT). This immediately revokes the AI tool's access to your Motion data.