YaparAI MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YAPARAI_ORG_ID | No | Organization ID (for enterprise tools) | |
| YAPARAI_API_KEY | Yes | Your API key (required) | |
| YAPARAI_BASE_URL | No | API base URL | https://api.yaparai.com |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | 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. |
| generate_videoA | Generate a video using AI. Text-to-video or image-to-video. Models: Veo 3.1, Kling. Cost: ~350 credits per video. |
| generate_musicC | 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. |
| generate_music_videoA | 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). |
| transform_imageA | 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. |
| remove_backgroundA | 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. |
| swap_faceA | 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. |
| virtual_try_onA | 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. |
| generate_mannequinA | 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. |
| lip_syncA | 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. |
| list_templatesA | 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. |
| get_template_detailA | 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. |
| execute_templateA | 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. |
| generate_textB | Generate text content using Gemini AI. Create scripts, storyboards, song lyrics, marketing copy, and more. Powered by Google Gemini. Cost: ~2 credits. |
| analyze_imageA | 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. |
| list_chatbotsA | 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. |
| chat_with_botA | 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. |
| list_organizationsA | 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. |
| list_social_accountsA | List connected social media accounts (Instagram, Facebook, TikTok, etc.). Shows all social accounts linked to your organization. Requires enterprise subscription. No credits charged. |
| create_social_postA | 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. |
| list_social_postsA | List published and scheduled social media posts. Returns all posts for the organization, with optional filtering by platform or specific account. Requires enterprise subscription. |
| get_social_quotaA | Get social media quota and usage limits. Returns remaining post quota, message limits, and billing period info. Useful to check before running bulk operations. |
| generate_captionA | Generate an AI-powered social media caption. Creates engaging, platform-optimized captions using AI. Supports multiple languages and tones. |
| generate_hashtagsB | Generate AI-optimized hashtags for a social media post. Creates relevant, trending hashtags based on your caption content. |
| list_inboxA | List social media inbox conversations (DMs, comments). Shows all incoming messages from Instagram, Facebook, WhatsApp, etc. Requires enterprise subscription. No credits charged. |
| read_conversationA | Read messages in a social media conversation. Get the full message history of a DM or comment thread. |
| reply_to_messageA | Reply to a social media message/DM. Send a reply in an existing conversation on Instagram, Facebook, WhatsApp, or other connected platforms. |
| ai_reply_suggestionA | 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. |
| list_customersA | 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. |
| get_customerA | Get detailed customer information. Returns full customer profile including contact details, tags, notes, conversation history, and order info. |
| extract_customer_infoA | 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. |
| send_shipping_infoA | 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. |
| bulk_messageA | 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. |
| sync_customers_from_inboxA | 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. |
| list_competitorsA | 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. |
| get_competitorB | Get detailed info for a single competitor. |
| compare_competitorsA | 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. |
| list_org_productsA | 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. |
| create_org_productB | Create a new product in your organization's catalog. |
| update_product_stockA | 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. |
| check_balanceA | Check your YaparAI credit balance. Returns your current credit balance, total credits used, and the currency (credits). No credits are charged for this operation. |
| list_modelsA | 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. |
| get_job_statusA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ilhankilic/yaparai-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server