Adlark

Guide

Use Adlark from Claude Code, Cursor and other MCP clients

Connect the Adlark MCP server to Claude Code or Cursor with one command, then generate ad images, copy, scripts and voiceovers from chat.

· 5 min read

Adlark runs a remote MCP (Model Context Protocol) server, so an AI assistant can call the studio's tools for you: "write three hooks for this product and make a 9:16 image for the best one". This guide connects it to Claude Code and Cursor, lists the tools, and covers credits and key safety. Adlark is not affiliated with Anthropic or Cursor.

What you need

  • An Adlark account with credits (a Pro plan or a pack, see pricing).
  • An API key from Account -> API keys. It starts with adl_.
  • An MCP client that supports Streamable HTTP servers with a custom header.

The endpoint is https://adlark.alexshipit.com/api/mcp (Streamable HTTP, POST), authenticated with Authorization: Bearer adl_..., the same key the REST API uses.

Claude Code

One command adds the server:

claude mcp add --transport http adlark https://adlark.alexshipit.com/api/mcp --header "Authorization: Bearer adl_..."

Replace adl_... with your key. Run claude mcp list to check it connected, or type /mcp inside a session to see the server and its tools. By default the server is added for the current project only; add --scope user to make it available in every project.

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json inside a project:

{
  "mcpServers": {
    "adlark": {
      "url": "https://adlark.alexshipit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer adl_your_key_here"
      }
    }
  }
}

Restart Cursor or toggle the server in Settings -> MCP. Other clients that accept a URL plus a bearer header work the same way; clients that only support local stdio servers will not connect directly.

The tools

ToolWhat it doesAPI credits
generate_imageAd images from a prompt, with model, size, aspect and count9 per FLUX.2 klein 1K image, 5 per schnell draft
write_ad_copyAngles, hooks, headlines, primary texts, descriptions and CTAs6 per set
write_ugc_scriptA scene-by-scene UGC script for 15, 30 or 60 seconds6 per script
voiceoverText to speech in one of six voices15 per 1,000 characters
get_creditsYour current balance and rankFree
list_jobsRecent jobs and their outputsFree

MCP calls are billed like the REST API: studio credits plus 10%, rounded up. Ad analysis and captions need a file upload, which is easier through the studio or the REST API than through chat.

Prompts that work well

  • "Check my Adlark credits, then write ad copy for our insulated bottle: keeps drinks cold 24 hours, 750 ml, for hikers, offer is free engraving. Platform Instagram."
  • "Write a 30 second UGC script for the same bottle with a problem then solution angle. Then turn the first scene's line into a voiceover with the helena voice."
  • "Make two 4:5 FLUX.2 klein images of a steel water bottle on a mountain trail at sunrise, condensation on the bottle, space at the top for a headline."
  • "List my last five Adlark jobs and give me the image links from the most recent one."

Be specific about model, aspect and count. Assistants tend to be generous; if you do not say count: 1, you may get four images when you wanted one. Claude Code asks for permission before each tool call by default, which is a useful checkpoint for anything that spends credits.

Inside a coding project

MCP is handy when you build a store or landing page: ask the assistant to write hero copy with write_ad_copy, generate a matching image, and wire both into the page in one session. Generated files are private URLs that need your bearer header, so ask the assistant to download them into the project (for example with curl -H "Authorization: Bearer $ADLARK_KEY") rather than hotlinking them.

Keep the key safe

  • Do not commit .cursor/mcp.json or any file containing the key. Add it to .gitignore, or use the user-level config.
  • Make a separate key for each tool or teammate, so you can revoke one without breaking the others.
  • If a key leaks, delete it in Account -> API keys right away; requests with it stop immediately.
  • Keep an eye on spend with get_credits. A 402 error means the balance ran out.

Troubleshooting

SymptomLikely cause
401 or "unauthorized"Header missing, or Bearer prefix missing, or key deleted
402Not enough credits for that call
429Too many calls at once; wait a few seconds
503An image or text provider is busy; try again shortly
Server shows no toolsClient does not support remote HTTP servers with headers

Video tools are not in the MCP server yet because video generation is still coming soon; see video generation API. More on the server is on the MCP page, and the REST equivalent is covered in Build with the API in Python.

Make your next ad today

Pro is $39.99 a month with 3,000 credits. Cancel anytime.