MCP server
Airbrush MCP server
Give Claude, Cursor or any MCP client live social video research: what is breaking out, which hooks are rising, which ads keep running and what a draft is likely to get.
Setup
Connect in two steps
- Get a research keyIt starts with
mxk_and is shown once, so store it safely. - Add the server to your clientUse the details below. Never commit a key to a repository.
- Server URL
https://api.airbrush.ai/v1/mcp- Transport
- Streamable HTTP (remote)
- Auth
Authorization: Bearer YOUR_KEY(orX-API-Key)
Claude Code
claude mcp add --transport http airbrush https://api.airbrush.ai/v1/mcp \
--header "Authorization: Bearer YOUR_KEY"
Cursor or any client with a JSON config
{
"mcpServers": {
"airbrush": {
"url": "https://api.airbrush.ai/v1/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Replace YOUR_KEY with your key.
Tools
The ten tools
| Tool | What it does |
|---|---|
search_outliers | Breakout videos for a keyword, scored against a creator or niche median |
get_trends | Emerging, peaking or cooling hooks, formats, hashtags and sounds |
search_ads | Long-running ads for a keyword or brand |
search_products | Shop listings with estimated 7-day units, saturation and look-alikes |
lookup_creator | Creator median views, posting cadence, breakouts and best posts |
run_research | Full research report with insights, outliers, hooks, formats and rising searches |
predict_views | Likely views range for a post link or script, with suggested fixes |
get_report, get_insight, get_job | Re-read a report or insight card, or check a long-running job |
Answers list their sources and a confidence score, and estimated fields are labelled as estimates.
Try it
Things to ask your assistant
"Find breakout videos about standing desks from the last 30 days and summarize the common hooks."
"What hooks and sounds are rising in the kitchen gadget niche?"
"Check this script and tell me the likely views range and what to fix."
Credits and limits
Billed like the REST API
For example 10 credits for outliers, 2 for trends, 32 for a full report. Cached answers cost 1 credit, polling a job is free, and failed calls are refunded. Too many requests return 429 with a Retry-After header. See the full cost table. Included in all plans.
MCP FAQ
Questions about the MCP server
What is the Airbrush MCP server URL?
https://api.airbrush.ai/v1/mcp. It is a remote server using Streamable HTTP, authenticated with the same Bearer key as the REST API.
Which tools does it provide?
run_research, get_report, get_insight, search_outliers, get_trends, search_ads, search_products, lookup_creator, predict_views and get_job.
Can it generate images?
Not over MCP. The MCP server exposes the research tools. Image generation is available through the REST API at POST /v1/images.
Which plans include it?
The MCP server is part of the API, which is included in all plans.
How are MCP calls billed?
MCP calls are billed like the matching REST calls, in credits. Cached answers cost 1 credit, polling a job is free and failed calls are refunded.