YaparAI MCP Server

All-in-one AI content creation + enterprise social media, CRM & competitor intel — directly from Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI assistants.

What is YaparAI?

YaparAI is an all-in-one AI platform with 43 tools across content generation, e-commerce, and enterprise operations:

• 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

• 448+ Templates — Pre-built ComfyUI workflows (logos, ads, product photos...)

• AI Text & Vision — Gemini-powered text generation and image analysis

• Chatbots — Interact with AI chatbots via API

• Social Media — Post, caption, hashtag, inbox, AI auto-reply, quota (Enterprise)

• CRM — Customer management, AI info extraction, shipping, bulk messaging (Enterprise)

• Competitor Analysis — Track competitors, compare KPIs, SWOT snapshots (Enterprise, v0.5.0)

• Product Catalog — Org product CRUD, stock management (Enterprise, v0.5.0)

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 Anahtarları

3. Choose scope:

   • Personal — your credits, your data (default)

   • Enterprise — if you're a member of an organization, select it to enable competitor/product/inbox/CRM tools scoped to that org

4. Create the key and 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"
      }
    }
  }
}

Org-bound keys (v0.5.0+) — if your key is bound to an organization during creation, enterprise tools (competitors, products, inbox, CRM) automatically use that org. The old YAPARAI_ORG_ID env var is optional — only needed if you want to override the bound org or use a personal key for enterprise actions.

4. Use it!

> "Generate an image of a sunset over Istanbul"
> "List available templates for logo design"
> "Which competitors have the lowest PageSpeed score?"
> "Add a new product to our catalog: Summer T-Shirt, 149 TL"
> "Show me unread DMs on Instagram"
> "Send shipping info to customer #123 — Yurtiçi, tracking ABC456"

Available Tools (43)

Content Generation (4)

Image Editing (3)

E-commerce (2)

Avatar (1)

Templates (3)

AI Tools (2)

Chatbot (2)

Enterprise: Social Media (10)

Requires an enterprise API key (org-bound) or YAPARAI_ORG_ID.

Enterprise: CRM (6)

Enterprise: Competitor Analysis — v0.5.0 (3)

Enterprise: Product Catalog — v0.5.0 (3)

Utility (4)

Configuration

Which key should I create?

Cursor / Windsurf / Claude Code

Same configuration format in MCP settings:

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

Python SDK Usage

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"})
    result = await client.wait_for_result(job["job_id"])
    print(result["result_url"])

    # Compare competitors (v0.5.0 — org-bound API key)
    comparison = await client.enterprise_compare_competitors(
        ["uuid-1", "uuid-2", "uuid-3"]
    )
    print(comparison)

    # Add a product (v0.5.0)
    product = await client.enterprise_create_org_product({
        "name": "Summer T-Shirt",
        "price": 149,
        "stock_status": "in_stock",
        "category": "apparel",
    })
    print(product)

asyncio.run(main())

Reliability (v0.4.0+)

• Exponential backoff retry — 3 retries on network errors (1s → 2s → 4s + jitter), rate-limit aware (429 → 5s/10s/15s)

• Literal type annotations on platform, model, style, output_format — IDE auto-complete catches wrong values early

• Structured logging — logging.getLogger("yaparai") for debug traceability

• 32 unit tests on HTTP client, generation, editing, social, CRM, org resolution

• CI on Python 3.10 / 3.11 / 3.12 + ruff lint

Pricing

• 100 free credits on signup (no credit card required)

• Image: 6 credits ($0.50)

• Video: 350 credits ($3–5)

• Music: 14 credits ($1)

• Enterprise features: included with subscription

• Credits never expire

View pricing

Links

• Website: yaparai.com

• Enterprise Portal: kurumsal.yaparai.com

• Gallery: yaparai.com/gallery

• API Keys: yaparai.com/settings (personal) · kurumsal.yaparai.com/settings?tab=api-keys (org-bound)

• Support: destek@yaparai.com

Release Notes

• v0.5.0 (2026-04-21) — 6 new enterprise tools (competitor analysis + product catalog), org-bound API keys

• v0.4.0 (2026-04-21) — 2 new tools, retry + logging, Literal types, full test suite. Community contribution by @enis1998

• v0.3.1 — FastMCP 3.x compatibility

• v0.3.0 — 30 tools, full platform coverage

• v0.2.0 — 13 tools, PyPI ready

Full history: CHANGELOG.md

Contributors

Thanks to everyone who has contributed to YaparAI MCP!

• @ilhankilic — Creator & maintainer

• @enis1998 — v0.4.0: 2 new tools, retry mechanism, type safety, test suite

Want to contribute? Check out CONTRIBUTING.md.

License

Apache 2.0 — see LICENSE