Skip to main content

vap-mcp

VAP MCP Server - Media generation tools for Claude Desktop via Model Context Protocol.

Generate AI images, videos, and music directly in Claude Desktop conversations.

Quick Install

# Using uvx (recommended)
uvx vap-mcp

# Or using pipx
pipx install vap-mcp

# Or using pip
pip install vap-mcp

Claude Desktop Configuration

Add to your Claude Desktop config (~/.config/Claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "vap": {
      "command": "uvx",
      "args": ["vap-mcp"],
      "env": {
        "VAP_API_KEY": "vap_your_api_key_here"
      }
    }
  }
}

Get your API key at vapagent.com

Available Tools

Image Generation

  • generate_image: Generate AI images using Z-Image-Turbo (~$0.002 per image)

Video Generation (Veo 3.1)

  • generate_video: Generate AI videos with optional audio
    • 4 seconds: $2.40 (with audio) / $1.20 (without)
    • 6 seconds: $3.60 (with audio) / $1.80 (without)
    • 8 seconds: $4.80 (with audio) / $2.40 (without)

Music Generation (Suno V5)

  • generate_music: Generate AI music from text prompts
    • Describe mood, genre, instruments, tempo
    • 30-60 seconds: $0.50
    • 120 seconds: ~$0.70
    • 180 seconds: ~$0.90
    • 240 seconds: $1.10
    • Optional instrumental-only mode

Task Management

  • get_task: Check task status and retrieve results
  • list_tasks: List recent generation tasks

Utilities

  • check_balance: Check your account balance
  • estimate_cost: Estimate image generation cost
  • estimate_video_cost: Estimate video generation cost
  • estimate_music_cost: Estimate music generation cost

Usage Examples

Once configured, you can ask Claude:

"Generate an image of a sunset over mountains"

"Create a 4-second video of ocean waves"

"Generate a 60-second upbeat electronic track with synths"

"Create instrumental jazz music, smooth and relaxing, 2 minutes"

"Check my balance"

Environment Variables

Variable Description Default
VAP_API_KEY Your VAP API key (required) -
VAP_API_URL MCP API endpoint https://api.vapagent.com/mcp
VAP_API_BASE_URL Base API URL https://api.vapagent.com
VAP_DEBUG Enable debug logging false

Running Standalone

# Run the MCP server directly
vap-mcp

# With debug logging
VAP_DEBUG=1 vap-mcp

Links

License

MIT License - see LICENSE for details.

Metadata

Release files for vap-mcp 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vap-mcp 0.2.1
File Size Uploaded Provenance
vap_mcp-0.2.1.tar.gz 8.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for vap-mcp 0.2.1
File Interpreter ABI Platform
vap_mcp-0.2.1-py3-none-any.whl Python 3 none any Details

Total release size: 17.2 kB

Release files / vap_mcp-0.2.1.tar.gz

Download URL vap_mcp-0.2.1.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
b6c6c5b2fac1ca22103fc11dc76b5de0ba4402fb313cef04d2770ce28a2e24a7
BLAKE2b-256 checksum
How to use checksums
739d43892499ea85bf19643b83d86cdce9c00d64d5aae6c55c5668c50b38dbeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / vap_mcp-0.2.1-py3-none-any.whl

Download URL vap_mcp-0.2.1-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e17e4eab23da89248e87d4c50bac18b48c37df65d8a5eb18415f4ed5bc1f9e36
BLAKE2b-256 checksum
How to use checksums
498e53b8b0721038590d56328b6fa5382a757e4fdae494c5c4fde059b7d9611e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for vap-mcp 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page