Model Context Protocol

Claude Desktop Integration

Generate images, videos, and music directly in your Claude conversations. No code required.

Quick Setup

1 Install Dependencies

Make sure you have Python and httpx installed:

Terminal
pip install httpx

2 Configure Claude Desktop

Edit your Claude Desktop configuration file:

  • Linux/Mac: ~/.config/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

claude_desktop_config.json
{
  "mcpServers": {
    "vap": {
      "command": "python",
      "args": ["/path/to/VAP/mcp/vape_mcp_proxy.py"],
      "env": {
        "VAPE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Don't have an API key?

Get one in seconds: Quick Start Guide. No credit card required to register.

3 Restart Claude Desktop

Close and reopen Claude Desktop. VAP tools will appear automatically in your conversation. Just ask Claude to generate media!

Available Tools (13)

Generation
generate_image $0.18
Generate AI images from text prompts
generate_video $1.96
Generate AI videos using Google Veo 3.1 (Tier 2+)
generate_music $0.68
Generate AI music using Suno v5 Pro (Tier 2+)
Operations (Edit & Enhance)
inpaint $0.15
AI-powered image editing with natural language
background_remove $0.10
Remove background from any image instantly
upscale $0.15
Enhance image resolution 2x or 4x
get_operation Free
Check operation status and retrieve result
Utilities
get_task Free
Check task status and get result URL
list_tasks Free
List your recent generation tasks
check_balance Free
Check account balance and tier status
estimate_cost Free
Estimate cost before generating

Multi-asset presets

For preset execution (streaming_campaign, full_production), use the REST API /v3/execute endpoint. MCP tools are optimized for single-asset generation.

Resources

MCP resources provide read-only access to your account data:

URI Description
vap://account/info Account details, tier, and daily limits
vap://account/balance Balance breakdown (available, reserved, usable)
vap://pricing/current Current pricing for all generation types
vap://tasks/recent Last 10 tasks with status and result URLs

Example Usage

Just ask Claude naturally:

Claude conversation
"Generate an image of a sunset over mountains"

Claude will automatically:

1 Call generate_image
2 Get task ID
3 Poll status
4 Return image URL

Environment Variables

Variable Default Description
VAPE_API_KEY (required) Your VAP API key
VAPE_API_URL https://api.vapagent.com/mcp API endpoint URL
VAPE_DEBUG 0 Enable verbose logging

Troubleshooting

Enable Debug Mode

claude_desktop_config.json
{
  "mcpServers": {
    "vap": {
      "command": "python",
      "args": ["/path/to/vape_mcp_proxy.py"],
      "env": {
        "VAPE_API_KEY": "your_key",
        "VAPE_DEBUG": "1"
      }
    }
  }
}

Common Issues

  • "VAPE_API_KEY not set" — Add your API key to the env section in config
  • Connection errors — Check internet connection and firewall settings
  • Auth errors — Verify API key is valid and has sufficient balance
  • Tools not appearing — Fully restart Claude Desktop (not just reload)

Need Help?