airbrush.ai
Tools Video Go viral Pricing FAQ Log in

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

  1. Get a research keyIt starts with mxk_ and is shown once, so store it safely.
  2. 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 (or X-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

How an MCP client reaches the research tools An MCP client such as Claude or Cursor connects over Streamable HTTP to api.airbrush.ai/v1/mcp, which exposes ten research tools. MCP client Claude, Cursor ... Airbrush MCP /v1/mcp HTTP search_outliers get_trends search_ads predict_views + 6 more tools
One remote server, ten tools, the same key and credits as the REST API.
ToolWhat it does
search_outliersBreakout videos for a keyword, scored against a creator or niche median
get_trendsEmerging, peaking or cooling hooks, formats, hashtags and sounds
search_adsLong-running ads for a keyword or brand
search_productsShop listings with estimated 7-day units, saturation and look-alikes
lookup_creatorCreator median views, posting cadence, breakouts and best posts
run_researchFull research report with insights, outliers, hooks, formats and rising searches
predict_viewsLikely views range for a post link or script, with suggested fixes
get_report, get_insight, get_jobRe-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.

Developers

Put live research in your assistant