io.github.elestirelbilinc-sketch/vap-e

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "vap-e": {
      "url": "https://api.vapagent.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• generate_image

  Generate an AI image from text prompt using VAP (Flux2 Pro). Returns a task ID for async tracking. Cost: $0.18

  Parameters:

  • prompt (required) — string — Detailed description of the image to generate. Note: If aspect ratio is mentioned in the prompt (e.g., '16:9', 'widescreen', 'portrait'), also pass it in the aspect_ratio parameter for guaranteed correct dimensions.
  • quality — string — Generation quality (high costs 1.5x)
  • aspect_ratio — string — Output image aspect ratio. If the user mentions a specific ratio like '16:9' or 'widescreen' in their prompt, extract and pass it here explicitly for best results.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_task

  Get the status and result of a generation task. Returns image URL when completed.

  Parameters:

  • task_id (required) — string — Task UUID returned from generate_image

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_tasks

  List recent generation tasks with optional status filter.

  Parameters:

  • limit — integer — Maximum number of tasks to return
  • status — string — Filter by task status

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• check_balance

  Check VAP account balance. Returns available, reserved, and usable balances.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• estimate_cost

  Estimate the cost of an image generation before executing. Cost: $0.18

  Parameters:

  • quality — string — Generation quality level
  • num_outputs — integer — Number of images to generate

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• generate_video

  Generate an AI video from text prompt using VAP (P-Video). Returns a task ID for async tracking. Cost: $1.96. IMPORTANT: Send ONLY the video description. Do NOT include any instructions, guidelines, or meta-text. Just the pure visual description.

  Parameters:

  • prompt (required) — string — ONLY the visual description of the video. Do NOT include instructions or guidelines. Example: 'Cinematic aerial shot of a coastal cliff at golden hour, warm sunlight, gentle waves, camera slowly drifting forward'
  • duration — integer — Video duration in seconds (4, 6, or 8)
  • resolution — string — Video resolution. 1080p recommended for enterprise (+33% cost)
  • aspect_ratio — string — Video aspect ratio. 16:9 for landscape/widescreen, 9:16 for portrait/vertical (TikTok, Reels). Extract from user's prompt if mentioned.
  • generate_audio — boolean — Generate audio with the video (costs more)
  • negative_prompt — string — What to avoid in the video generation

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• estimate_video_cost

  Estimate the cost of a video generation. Cost: $1.96 (P-Video)

  Parameters:

  • duration — integer — Video duration in seconds
  • resolution — string — Video resolution. 1080p adds +33% cost
  • generate_audio — boolean — Whether audio will be generated

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• generate_music

  Generate AI music from text description using VAP. Returns a task ID for async tracking. Cost: $0.68. IMPORTANT: Send ONLY the music description. Do NOT include any instructions or meta-text. Describe: genre, mood, instruments, tempo, vocal style (or specify instrumental). Example prompt: "Upbeat indie folk song with acoustic guitar, warm vocals, and light percussion. Feel-good summer vibes.

  Parameters:

  • prompt (required) — string — Music description (200-500 chars recommended). Include genre, mood, instruments, tempo.
  • duration — integer — Target duration in seconds (30-480, default 120 = 2 min)
  • audio_format — string — Output format. WAV for enterprise/lossless (+$0.10)
  • instrumental — boolean — Generate without vocals (instrumental only)
  • loudness_preset — string — Loudness normalization. streaming=-14 LUFS (YouTube/Spotify), apple=-16 LUFS, broadcast=-23 LUFS (TV/EBU R128)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• estimate_music_cost

  Estimate the cost of music generation. Cost: $0.68

  Parameters:

  • duration — integer — Music duration in seconds
  • audio_format — string — Output format. WAV adds +$0.10

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• inpaint

  Remove or replace objects in an image using AI inpainting. Cost: $0.15. Requires Tier 1+.

  Parameters:

  • media_url (required) — string — URL of the image to edit
  • prompt (required) — string — What to remove, replace, or change in the image
  • mask_url — string — Optional mask image URL (white = edit area, black = keep)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• ai_edit

  Edit images using AI with natural language prompts. Supports single and multi-image editing. Cost: $0.15. Requires Tier 1+.

  Parameters:

  • media_url (required) — string — URL of the primary image to edit
  • prompt (required) — string — Natural language instruction for editing
  • seed — integer — Random seed for reproducible results
  • aspect_ratio — string — Output aspect ratio (default: match input image)
  • additional_images — array — Up to 2 additional reference image URLs

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• background_remove

  Remove the background from an image, leaving only the subject with transparency. Cost: $0.10. Requires Tier 1+.

  Parameters:

  • media_url (required) — string — URL of the image to process

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• upscale

  Upscale/enhance an image to higher resolution using AI. Cost: $0.15. Requires Tier 1+.

  Parameters:

  • media_url (required) — string — URL of the image to upscale
  • scale — integer — Upscale factor (2x or 4x)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• video_trim

  Trim a video to a specific time range. Cost: $0.05. Requires Tier 1+.

  Parameters:

  • media_url (required) — string — URL of the video to trim
  • start_time (required) — number — Start time in seconds
  • end_time (required) — number — End time in seconds

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• video_merge

  Merge multiple video clips into one continuous video. Cost: $0.05. Requires Tier 1+.

  Parameters:

  • media_urls (required) — array — URLs of videos to merge (in playback order)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_operation

  Get the status and result of an operation. Returns output URL when completed.

  Parameters:

  • operation_id (required) — string — Operation UUID returned from an operation tool

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.