MCP Server

Use August Ads as a tool in Claude Desktop, Cursor, or any MCP-compatible AI agent.

What is MCP?

Model Context Protocol (MCP) lets AI assistants like Claude connect to external tools. With the August Ads MCP server, you can generate video ads and images by talking to your AI assistant in natural language.

For example, you can say "Generate a 12-second product video for my wireless earbuds" in Claude Desktop, and it will call the August Ads API directly.

Setup — Claude Desktop

Add this to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "augustai": {
      "command": "npx",
      "args": ["@augustai/mcp-server"],
      "env": {
        "AUGUST_API_KEY": "aug_live_YOUR_KEY_HERE"
      }
    }
  }
}

Replace aug_live_YOUR_KEY_HERE with your actual API key from Settings → API.

Setup — Cursor

Add to your .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "augustai": {
      "command": "npx",
      "args": ["@augustai/mcp-server"],
      "env": {
        "AUGUST_API_KEY": "aug_live_YOUR_KEY_HERE"
      }
    }
  }
}

Available Tools

generate_videoprompt, duration, aspect_ratio, style

Generate a video ad. Returns video ID.

get_videovideo_id

Check video status and get download URL.

generate_imageprompt, size, quality

Generate an image. Returns image ID.

get_imageimage_id

Check image status and get download URL.

get_creditsnone

Check your credit balance and plan.

Example Conversation

You:

Generate a 12-second vertical video ad for my new wireless earbuds. Make it sleek and modern.

Claude:

I'll generate that video for you. [Calls generate_video with your prompt] The video has been queued (ID: abc123). It used 6 credits. Let me check the status... [Calls get_video] It's still processing. I'll check again... Done! Here's your video: [download link]