Skip to main content

YaparAI MCP Server — Generate images, videos, and music with AI directly from Claude Desktop, Cursor, and Windsurf

Project description

YaparAI MCP Server

Generate AI images, videos, and music directly from Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI assistants.

PyPI License Python

What is YaparAI?

YaparAI is an all-in-one AI content creation platform with 16+ AI models:

  • Image Generation — Flux, SDXL, Imagen 4 (text-to-image, image-to-image)
  • Video Generation — Veo 3.1, Kling (text-to-video, image-to-video)
  • Music Generation — Suno v4 (full songs with vocals, instrumentals)
  • Image Editing — Background removal, face swap, style transfer
  • E-commerce — Virtual try-on, AI mannequin for product photos
  • Avatar — Lip sync talking avatars from photos

Quick Start

1. Install

pip install yaparai

2. Get your API Key

  1. Sign up at yaparai.com (100 free credits)
  2. Go to Settings > API Keys
  3. Create a new key — copy it (shown only once!)

3. Configure Claude Desktop

Edit your Claude Desktop config (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "yaparai": {
      "command": "yaparai",
      "env": {
        "YAPARAI_API_KEY": "yap_live_your_key_here"
      }
    }
  }
}

4. Use it!

In Claude Desktop, just ask:

"Generate an image of a sunset over Istanbul"

"Create a 30-second lo-fi music track"

"Make a video of a cat walking on a beach"

"Remove the background from this image: https://example.com/photo.jpg"

"Check my credit balance"

Available Tools (13)

Generation

Tool Description Cost
generate_image Generate images from text prompts (Flux, SDXL, Imagen 4) ~6 credits
generate_video Generate videos from text or images (Veo 3.1, Kling) ~350 credits
generate_music Generate music from text descriptions (Suno v4) ~14 credits
generate_music_video Generate music + matching video combined ~364 credits

Image Editing

Tool Description Cost
transform_image Transform an image using AI (img2img style transfer) ~6 credits
remove_background Remove background from any image ~2 credits
swap_face Swap faces in an image ~6 credits

E-commerce

Tool Description Cost
virtual_try_on Virtual clothing try-on on a person's photo ~6 credits
generate_mannequin Generate AI mannequin/model for product photos ~6 credits

Avatar

Tool Description Cost
lip_sync Create talking avatar from a photo ~14 credits

Utility

Tool Description Cost
check_balance Check your credit balance Free
list_models List all available models and costs Free
get_job_status Check status of a running job Free

Configuration

Env Variable Description Default
YAPARAI_API_KEY Your API key (required)
YAPARAI_BASE_URL API base URL https://api.yaparai.com

Cursor / Windsurf

Same configuration format — add to your MCP settings:

{
  "yaparai": {
    "command": "yaparai",
    "env": {
      "YAPARAI_API_KEY": "yap_live_your_key_here"
    }
  }
}

Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "yaparai": {
      "command": "yaparai",
      "env": {
        "YAPARAI_API_KEY": "yap_live_your_key_here"
      }
    }
  }
}

Python SDK Usage

You can also use YaparAI as a Python library:

import asyncio
from yaparai.client import YaparAIClient

async def main():
    client = YaparAIClient(api_key="yap_live_your_key_here")

    # Generate an image
    job = await client.generate({
        "type": "image",
        "prompt": "A futuristic city at sunset",
    })

    # Wait for result
    result = await client.wait_for_result(job["job_id"])
    print(result["result_url"])

    # Check balance
    balance = await client.get_balance()
    print(f"Credits: {balance['balance']}")

asyncio.run(main())

Pricing

Credits are deducted from your YaparAI account balance:

  • 100 free credits on signup (no credit card required)
  • Image generation: 6 credits ($0.50)
  • Video generation: 350 credits ($3-5)
  • Music generation: 14 credits ($1)
  • Background removal: 2 credits ($0.15)
  • Credits never expire

View pricing

Links

License

Apache 2.0 — see LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yaparai-0.2.0.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yaparai-0.2.0-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file yaparai-0.2.0.tar.gz.

File metadata

  • Download URL: yaparai-0.2.0.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for yaparai-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2ecdc71ec419359228df97349460c43aea845a86ce773ce209fa11c873d1edb6
MD5 22e664d1dca367ece29dc1f2ab163994
BLAKE2b-256 b5520eb28e18064581f55320c80ee4f15b9ee8d04ec7dfc829b8eaae1f8a4876

See more details on using hashes here.

File details

Details for the file yaparai-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: yaparai-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 13.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for yaparai-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a74c120d120af224eb167295cfb47dacdc5435774a43fac0340aefa311c6e6fc
MD5 a150fb83443ce3e7a0548709bb37e465
BLAKE2b-256 6528742b95c360902d03eacd43940bdfc79f2523dcc0d016b066715df096be59

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page