Enables posting to Facebook, managing inbox messages, and AI-generated replies through YaparAI's social media enterprise tools.
Provides access to Flux image generation models for text-to-image and image-to-image creation through YaparAI's content generation platform.
Provides tools for posting to Instagram, managing inbox/DMs, generating captions and hashtags, and AI-suggested replies through YaparAI's social media platform.
Integrates with Suno v4 for AI music generation, enabling creation of full songs with vocals and instrumentals through YaparAI's content generation tools.
Allows posting to TikTok and managing social media content through YaparAI's enterprise social media tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@YaparAI MCP Server generate an image of a sunset over Istanbul"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
All-in-one AI content creation + enterprise social media, CRM & competitor intel — directly from Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI assistants.
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)
Related MCP server: social-neuron
pip install yaparaiSign up at yaparai.com (100 free credits)
Go to Settings > API Anahtarları
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
Create the key and copy it (shown only once!)
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_IDenv var is optional — only needed if you want to override the bound org or use a personal key for enterprise actions.
> "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"Tool | Description | Cost |
| Flux / SDXL / Imagen 4 ( | ~6 credits |
| Veo 3.1 or Kling (text-to-video, image-to-video) | ~350 credits |
| Suno v4 (vocals or instrumental) | ~14 credits |
| Music + video combined | ~364 credits |
Tool | Description | Cost |
| Image-to-image style transfer | ~6 credits |
|
| ~2 credits |
| Face swap — | ~6 credits |
Tool | Description | Cost |
| Virtual clothing try-on | ~6 credits |
| AI mannequin for product photos | ~6 credits |
Tool | Description | Cost |
| Talking avatar from photo | ~14 credits |
Tool | Description | Cost |
| Browse 448+ templates | Free |
| Get template inputs/details | Free |
| Run template (supports | Varies |
Tool | Description | Cost |
| Gemini text generation (scripts, lyrics, storyboard) | ~2 credits |
| Gemini Vision image analysis | ~2 credits |
Tool | Description | Cost |
| List available chatbots | Free |
| Chat with a YaparAI chatbot | Varies |
Requires an enterprise API key (org-bound) or YAPARAI_ORG_ID.
Tool | Description | Cost |
| List connected social accounts | Free |
| Post to Instagram/Facebook/TikTok/X (supports | Free |
| v0.4.0 — list published & scheduled posts | Free |
| v0.4.0 — check platform quota & usage | Free |
| AI-generate post caption | Free |
| AI-generate hashtags | Free |
| Read social media inbox/DMs | Free |
| Read conversation messages | Free |
| Reply to a DM/message | Free |
| Get AI-suggested reply | Free |
Tool | Description | Cost |
| Browse CRM customers (filter by platform/tag) | Free |
| Get customer details | Free |
| AI-extract info from conversations | Free |
| Send tracking notification | Free |
| Mass message — supports | Free |
| Import customers from inbox | Free |
Tool | Description | Cost |
| List tracked competitors (PageSpeed, followers, product count) | Free |
| Get detailed competitor info | Free |
| Compare 2–4 competitors — KPI snapshot for SWOT analysis | Free |
Tool | Description | Cost |
| List org products with SKU, price, category, stock | Free |
| Add new product to catalog | Free |
| Toggle | Free |
Tool | Description | Cost |
| List your organizations | Free |
| Check credit balance | Free |
| List models and costs | Free |
| Check job status | Free |
Env Variable | Description | Default |
| Your API key (required) | — |
| Organization ID — optional if your key is org-bound | — |
| API base URL |
|
Scenario | Scope |
Just me, for generation/editing | Personal — default |
I'm part of a company on YaparAI and want enterprise tools | Enterprise — pick org during key creation |
Multiple orgs, one key | Use a personal key + pass |
Same configuration format in MCP settings:
{
"yaparai": {
"command": "yaparai",
"env": {
"YAPARAI_API_KEY": "yap_live_your_key_here"
}
}
}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())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
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
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
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
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.
Apache 2.0 — see LICENSE
Get an AI-generated reply suggestion for a social media conversation.
The AI reads the conversation context and suggests an appropriate reply. You can customize the AI behavior with a system prompt.
Inputs: conversation_id (required), account_id (required), system_prompt, org_id. Returns: object
Analyze an image using Gemini Vision AI.
Upload an image and ask questions about it. Can identify objects, read text, describe scenes, analyze compositions, and more. Cost: ~2 credits.
Inputs: image_url (required), prompt. Returns: object
Send a message to multiple customers at once.
Broadcast promotions, announcements, or updates to a list of customers via their respective social platforms. You can target by specific IDs, a customer tag, or a platform.
Inputs: message (required), customer_ids, tag, platform, +2 more. Returns: object
Send a message to a YaparAI chatbot and get a response.
Each chatbot is specialized for different tasks (customer support, product recommendations, etc.). Use list_chatbots() to discover available bots. Provide conversation_id to continue a conversation.
Inputs: slug (required), message (required), conversation_id. Returns: object
Check your YaparAI credit balance.
Returns your current credit balance, total credits used, and the currency (credits).
No credits are charged for this operation.
Inputs: no named parameters. Returns: object
Compare 2–4 competitors on key metrics.
Returns latest metric snapshots for each competitor including PageSpeed score, total followers, posts in last 30 days, and product count. Use this as the basis for SWOT analysis or positioning decisions.
Inputs: competitor_ids (required), org_id. Returns: object
Create a new product in your organization's catalog.
Inputs: name (required), sku, price, currency, +5 more. Returns: object
Create and publish a social media post.
Post to Instagram, Facebook, TikTok, Twitter/X and other platforms. Supports text, images, and videos. Requires enterprise subscription.
Inputs: text (required), platform (required), account_id (required), media_urls, +2 more. Returns: object
Execute a ComfyUI template to generate content.
Runs a pre-built AI workflow with your inputs. Each template has different capabilities — use get_template_detail() first to see what inputs are accepted. Credits are deducted based on the template.
Inputs: slug (required), prompt (required), image_url, width, +2 more. Returns: object
Extract contact information from conversation history using AI.
The AI reads through all messages with this customer and extracts their name, phone number, email address, and physical address. Great for auto-filling CRM records from chat conversations.
Inputs: customer_id (required), org_id. Returns: object
Generate an AI-powered social media caption.
Creates engaging, platform-optimized captions using AI. Supports multiple languages and tones.
Inputs: topic (required), platform, language, tone, +1 more. Returns: object
Generate AI-optimized hashtags for a social media post.
Creates relevant, trending hashtags based on your caption content.
Inputs: caption (required), platform, language, org_id. Returns: object
Generate an image using AI.
Supports 3 AI models: Flux, SDXL, Imagen 4. Smart routing automatically picks the best model for your prompt. Cost: ~6 credits per image.
Inputs: prompt (required), model, negative_prompt, width, +2 more. Returns: object
Generate an AI mannequin / model photo for products.
Upload a product image (clothing, accessory) and the AI will generate a realistic mannequin/model wearing or displaying it. Great for e-commerce product listings. Cost: ~6 credits.
Inputs: prompt (required), image_url (required). Returns: object
Generate music using AI (powered by Suno v4).
Create full songs with vocals or instrumental tracks from text descriptions. Supports Turkish and English lyrics. Cost: ~14 credits per track.
Inputs: prompt (required), style, instrumental. Returns: object
Generate a music video — AI music + video combined.
Creates both an original music track and a matching video in one go. The AI composes music and generates visuals that match the mood. Cost: ~364 credits (music + video).
Inputs: prompt (required), style. Returns: object
Generate text content using Gemini AI.
Create scripts, storyboards, song lyrics, marketing copy, and more. Powered by Google Gemini. Cost: ~2 credits.
Inputs: prompt (required), sub_mode, temperature, max_tokens. Returns: object
Generate a video using AI.
Text-to-video or image-to-video. Models: Veo 3.1, Kling. Cost: ~350 credits per video.
Inputs: prompt (required), image_url, model, style. Returns: object
Get detailed info for a single competitor.
Inputs: competitor_id (required), org_id. Returns: object
Get detailed customer information.
Returns full customer profile including contact details, tags, notes, conversation history, and order info.
Inputs: customer_id (required), org_id. Returns: object
Check the status of a generation job.
Use this to check on long-running jobs (especially video and music) or to retrieve the result URL of a completed job. No credits charged.
Inputs: job_id (required). Returns: object
Get social media quota and usage limits.
Returns remaining post quota, message limits, and billing period info. Useful to check before running bulk operations.
Inputs: org_id. Returns: object
Get full details of a template including its input parameters.
Returns the template's input fields (what you need to provide), output format, description, and credit cost. Use this before executing a template to understand its requirements. No credits charged.
Inputs: slug (required). Returns: object
Create a talking avatar from a photo using AI lip sync.
Upload a face photo and provide the text/speech description. The AI will animate the face to appear as if it's speaking. Great for presentations, social media, and content creation. Cost: ~14 credits.
Inputs: prompt (required), image_url (required). Returns: object
List all available chatbots on YaparAI.
Returns active chatbots with their slug, name, description, and configuration. Use the slug to chat with a specific bot. No credits charged.
Returns: List of chatbot configs with slug, name, description, avatar_url.
Inputs: no named parameters. Returns: object
List competitors tracked under your organization.
Competitor tracking includes website crawling (PageSpeed, SEO), social media metrics (followers, engagement), and marketplace product prices (Hepsiburada, Trendyol).
Requires enterprise subscription with an org-bound API key.
Inputs: limit, offset, org_id. Returns: object
List CRM customers with optional filtering.
Browse your customer database built from social media conversations. Supports search, platform filtering, and tag-based filtering. Requires enterprise subscription. No credits charged.
Inputs: search, platform, tag, org_id. Returns: object
List social media inbox conversations (DMs, comments).
Shows all incoming messages from Instagram, Facebook, WhatsApp, etc. Requires enterprise subscription. No credits charged.
Inputs: org_id. Returns: object
List all available AI generation models and their credit costs.
Returns a list of models with their mode identifier, description, credit cost, and type (image/video/music).
Useful for understanding what you can generate and how much it costs. No credits are charged for this operation.
Inputs: no named parameters. Returns: object
List your organizations on YaparAI.
Returns organizations you're a member of, with their IDs, names, and your role. Use the org ID for enterprise tools (social media, CRM, chatbots). You can set YAPARAI_ORG_ID env var to skip passing org_id to every call. No credits charged.
Returns: List of organizations with id, name, role, and member count.
Inputs: no named parameters. Returns: object
List product catalog for your organization.
Returns org's product list with SKU, price, category, image, stock status (in_stock / out_of_stock / preorder). Used for automated social media posts, chatbot product lookup, or inventory management from AI assistants.
Inputs: limit, offset, org_id. Returns: object
List connected social media accounts (Instagram, Facebook, TikTok, etc.).
Shows all social accounts linked to your organization. Requires enterprise subscription. No credits charged.
Inputs: org_id. Returns: object
List published and scheduled social media posts.
Returns all posts for the organization, with optional filtering by platform or specific account. Requires enterprise subscription.
Inputs: platform, account_id, org_id. Returns: object
Browse 448+ ready-made AI templates.
Discover pre-built workflows for common tasks: logo creation, product photography, portrait retouching, ad generation, and more. Each template has predefined inputs — just fill in prompts and images. No credits charged for browsing.
Inputs: category, media_type, search, featured. Returns: object
Read messages in a social media conversation.
Get the full message history of a DM or comment thread.
Inputs: conversation_id (required), account_id (required), org_id. Returns: object
Remove the background from an image using AI.
Upload an image and get back a version with the background removed. Works great for product photos, portraits, and any image where you need a clean cutout. Cost: ~2 credits.
Inputs: image_url (required), output_format. Returns: object
Reply to a social media message/DM.
Send a reply in an existing conversation on Instagram, Facebook, WhatsApp, or other connected platforms.
Inputs: conversation_id (required), account_id (required), message (required), org_id. Returns: object
Send shipping/tracking information to a customer via social media.
Automatically sends a tracking message through the same social platform the customer contacted you on.
Inputs: customer_id (required), carrier (required), tracking_code (required), org_id. Returns: object
Swap a face in an image using AI.
Provide a target image and a source face image. The AI replaces the face in the target image with the face from the source image while keeping the rest of the image intact. Cost: ~6 credits.
Inputs: image_url (required), face_url (required), prompt. Returns: object
Import customers from social media inbox conversations.
Scans all inbox conversations and creates CRM customer records for anyone who has messaged you. New customers are auto-tagged by platform. Existing customers are not duplicated.
Inputs: org_id. Returns: object
Transform an existing image using AI (image-to-image).
Uses the source image as a reference and applies the prompt to create a new variation. Great for style transfer, modifications, and enhancements. Cost: ~6 credits.
Inputs: prompt (required), image_url (required), negative_prompt, width, +2 more. Returns: object
Update a product's stock status.
Use this to quickly mark products as out of stock when inventory runs out, or to flip back to in_stock after restocking. For variant-level stock counts, see v0.6.0 roadmap.
Inputs: product_id (required), stock_status (required), org_id. Returns: object
Virtual clothing try-on using AI.
Upload a photo of a person and describe the clothing to try on. The AI will generate a realistic image of the person wearing the described outfit. Perfect for e-commerce and fashion. Cost: ~6 credits.
Inputs: prompt (required), image_url (required). Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 43 tools
Each tool targets a specific functionality with clear descriptions that distinguish overlapping areas (e.g., generate_caption vs generate_text, ai_reply_suggestion vs chat_with_bot). No two tools serve the same purpose, making selection unambiguous.
The vast majority of tools follow a consistent verb_noun pattern (e.g., generate_image, list_customers, remove_background). Only a few minor exceptions (ai_reply_suggestion, lip_sync, virtual_try_on) exist, but they are still intuitive and do not break the overall consistency.
With 43 tools covering a wide range of features (content generation, social media, CRM, products, competitors, templates), the count is large but justifiable for a comprehensive platform server. It is slightly heavy but not excessive for the scope.
Core workflows for content generation and social media interaction are well-covered, but there are notable gaps in CRUD operations for entities like social posts, customers, products, and competitors (no update/delete tools). This limits the ability to fully manage resources via tools alone.
On-brand AI image and video campaigns with persistent characters and products, from any MCP client.
Social media management, multi-platform publishing, AI generation, and cross-channel analytics.
Post and schedule to TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads and Bluesky from your AI agent. Video included, you approve every post, and MCP is on the free plan.
Direct AI video, image, music and storyboard production from any MCP client.
