Quelta Video Ad Analyzer

Score short vertical video ads by link: hook, story, offer, audience, picture and sound.

View on quelta.ai

Hosted MCP Server

npx add-mcp 'https://quelta.ai/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Setup

How to connect

One URL for every client. On first use the assistant asks you to sign in with your Quelta account (Google). No API keys.

  • Claude

    claude.ai and Claude Desktop
    1. Open Settings → Connectors. 2. Choose “Add custom connector” and paste the server URL. 3. Sign in with your Quelta account and allow access. https://quelta.ai/mcp Copy The Free plan allows one custom connector; Pro, Max, Team and Enterprise allow more.

  • Claude Code

    Terminal
    1. Run the command below. 2. Type /mcp in Claude Code, choose quelta and sign in.
    claude mcp add --transport http quelta https://quelta.ai/mcp

  • ChatGPT

    chatgpt.com
    1. When Quelta appears in the ChatGPT apps directory, connect it from there. 2. Until then: if your workspace has developer mode, add a custom app with the server URL. https://quelta.ai/mcp Copy

  • Cursor

    ~/.cursor/mcp.json
    1. Add the server to the config file. 2. Sign in when Cursor asks.
    {
  "mcpServers": {
    "quelta": {
      "url": "https://quelta.ai/mcp"
    }
  }
}

  • VS Code

    .vscode/mcp.json
    1. Add the server to the workspace config. 2. Start the server and sign in when VS Code asks.
    {
  "servers": {
    "quelta": {
      "type": "http",
      "url": "https://quelta.ai/mcp"
    }
  }
}

  • Other MCP clients

    Streamable HTTP + OAuth
    1. Add a remote server with the server URL. 2. The client finds the sign-in page by itself (OAuth 2.1). https://quelta.ai/mcp Copy

Tools

What the assistant can do

Five tools. The assistant picks them by itself: just ask in plain words.

  • analyze_video_ad

    Free Starts the preliminary check of a short vertical video ad by a public link.

    Parameters

    url Link to a public post: TikTok, Instagram Reels, YouTube Shorts, X, Snapchat or Facebook. platform optional Where the ad will run: tiktok, reels, shorts, x, snapchat or other. If omitted, it is taken from the link. country optional Target market, a two-letter code, one of 30 markets. Default: US. audience optional Audience age: gen-z (13–29), millennials (29–45), gen-x (45–61), boomers (61–80) or any. language optional Report language: en, fr, es, de, kk or ru.

    Returns

    A score range 20 points wide, the review of the first 3 seconds, weak spots and a link to the report on quelta.ai. Usually takes about a minute; if the check is not ready in about 40 seconds, returns an analysis id to ask about later.

  • get_analysis

    Free Status and results of a check. While it is running, waits up to about 40 seconds.

    Parameters

    analysis_id The id from analyze_video_ad or list_my_analyses. wait optional Wait up to about 40 seconds while the check is still running (on by default).

    Returns

    The results as soon as they are ready: the preliminary check or, if it was run, the full check.

  • upgrade_to_full_review

    Uses 1 full check Runs the full check on a finished preliminary one. The assistant asks you to confirm first.

    Parameters

    analysis_id A finished preliminary check.

    Returns

    The exact 0–100 score, six category scores, every mistake with a timecode and severity, the fixes in order of impact and what already works.

  • list_my_analyses

    Free Your recent checks in your Quelta account: from the website and from AI assistants.

    Parameters

    limit optional How many checks to show.

    Returns

    The checks with their scores and links to the reports.

  • get_account

    Free Your Quelta account.

    Parameters

    No parameters

    Returns

    Your email, preliminary checks left today and full checks on your balance.

Examples

What to ask

  • Score this TikTok ad for Germany, millennials: <link> Copy
  • Compare these three ads and tell me which one has the strongest hook: <link>, <link>, <link> Copy
  • Run the full check on my last video and list the fixes with timecodes Copy
  • Check this Reels ad for the US, Gen Z, and answer in Spanish: <link> Copy

Directories

Where to find Quelta

We are submitting Quelta to the main directories. Until it is listed, connect by the server URL.

  • Claude directory Coming soon
  • ChatGPT apps Coming soon
  • Official MCP Registry Coming soon

Questions and answers

Can Claude watch TikTok videos?

Not on its own: Claude cannot watch a video by a link. With the Quelta MCP server it gets what it needs: Quelta downloads the public video, watches and listens to it, and returns the analysis to Claude. Then Claude can explain it, compare ads or write a new script.

Can ChatGPT analyze a video ad?

ChatGPT does not watch a TikTok or Reels ad by a link on its own. Connect Quelta, and ChatGPT gets a score for the platform, the market and the audience age, the review of the first 3 seconds and, with the full check, every mistake with a timecode.

Is it free?

The preliminary check is free: up to 5 videos a day per account, shared with the website. The full check uses one full check from your balance; a new account gets the first one free. Packs of full checks are in early access.

Which platforms and videos does it support?

Vertical ads up to 3 minutes: TikTok, Instagram Reels, YouTube Shorts, X, Snapchat and Facebook. The score takes into account the platform, one of 30 markets and the audience age.

Does it work with unpublished videos?

The assistant can pass only a public link. To check a draft, upload the file on quelta.ai while signed in with the same account, then ask the assistant to show your checks.

Do I need an API key?

No. When the assistant connects, you sign in with your Quelta account (Google) and allow access. The assistant gets access only to the Quelta tools. To end it, disconnect Quelta in the assistant.