YaparAI Enterprise MCP Server
Manage Facebook business accounts: schedule and publish posts, view analytics, read and reply to inbox messages and comments, and access CRM features.
Manage Instagram business accounts: schedule and publish posts, view analytics, read and reply to DMs and comments, and access CRM features.
Manage TikTok business accounts: schedule and publish posts, view analytics, read and reply to inbox messages, and access CRM features.
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 Enterprise MCP Server Show me all unread DMs on Instagram"
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.
YaparAI Enterprise MCP Server
Enterprise Social Media & CRM management — directly from Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI assistants.
What is this?
This is a dedicated MCP (Model Context Protocol) server for the YaparAI Enterprise platform. It exposes 21 tools covering Social Media management and CRM directly inside Claude, Cursor, or any MCP-compatible assistant.
For the full YaparAI MCP (image generation, video, music, templates, etc.) see the main yaparai-mcp repo.
Related MCP server: PostMCP MCP Server
Tools (21)
🏢 Utility (1)
Tool | Description |
| List your organizations and find your org_id |
📱 Social Media (12)
Tool | Description |
| List connected Instagram/Facebook/TikTok/X accounts |
| Publish or schedule a post |
| Browse published and scheduled posts |
| Delete a post |
| Engagement stats, reach, follower growth |
| AI-generated post caption (TR/EN) |
| AI-optimized hashtags |
| Read social media DMs and comments |
| Full message history of a conversation |
| Reply to a DM or comment |
| AI-suggested reply for a conversation |
| Check posting quota and limits |
👥 CRM (8)
Tool | Description |
| Browse CRM customers (filter by tag, platform, search) |
| Get full customer profile |
| Manually add a new customer |
| Update customer info (name, phone, email, tags) |
| Add a note to a customer record |
| AI extracts name/phone/email from conversation |
| Send tracking notification via social DM |
| Mass message by tag, platform, or customer list |
| Import customers from inbox conversations |
Quick Start
1. Install
pip install git+https://github.com/enis1998/yaparai-enterprise-mcp.git2. Get API Key & Org ID
Sign up at kurumsal.yaparai.com
Go to Settings > API Keys and create a key
Use
list_organizationstool to find yourorg_id
3. Configure Claude Desktop
{
"mcpServers": {
"yaparai-enterprise": {
"command": "yaparai-enterprise",
"env": {
"YAPARAI_API_KEY": "yap_live_your_key_here",
"YAPARAI_ORG_ID": "your-org-id-here"
}
}
}
}4. Use it!
"Show me all unread DMs on Instagram"
"Generate an AI reply for the last customer complaint"
"Send shipping info to customer Ahmet — Yurtici, tracking ABC456"
"Post our summer campaign to Instagram and Facebook"
"Send a bulk message to all VIP customers"
"How many posts did we make last month? What was the engagement rate?"
Environment Variables
Variable | Required | Description |
| ✅ Yes | Your API key |
| ✅ Yes (or per-call) | Organization ID |
| ❌ No | API base URL (default: |
Development
git clone https://github.com/enis1998/yaparai-enterprise-mcp.git
cd yaparai-enterprise-mcp
pip install -e ".[dev]"
pytest tests/ -vLicense
Apache 2.0
Available Tools
22 toolsadd_customer_noteB
Add a note to a customer's record.
Notes are visible in the customer profile and help your team track important context (order issues, preferences, follow-ups, etc.).
Inputs: customer_id (required), note (required), org_id. Returns: object
ai_reply_suggestionA
Get an AI-generated reply suggestion for a conversation.
The AI reads the full conversation context and suggests an appropriate, personalized reply. Customize with a system prompt.
Inputs: conversation_id (required), account_id (required), system_prompt, org_id. Returns: object
bulk_messageA
Send a message to multiple customers at once.
Broadcast promotions, announcements, or updates. Target by specific IDs, a customer tag, or a platform. At least one of customer_ids, tag, or platform is required.
Inputs: message (required), customer_ids, tag, platform, +2 more. Returns: object
create_customerA
Manually create a new CRM customer record.
Add a customer who may not have come through the social inbox. Useful for migrating existing customers or adding offline contacts.
Inputs: name (required), platform (required), phone, email, +4 more. Returns: object
create_social_postA
Create and publish (or schedule) a social media post.
Supports text, images, and videos on Instagram, Facebook, TikTok, X. Use scheduled_at to queue posts for a future time.
Inputs: text (required), platform (required), account_id (required), media_urls, +2 more. Returns: object
delete_social_postA
Delete a social media post.
Deletes the post from both the YaparAI platform and the social media platform (if supported by the platform's API). Scheduled posts are cancelled.
Inputs: post_id (required), org_id. Returns: object
extract_customer_infoA
Extract contact information from conversation history using AI.
The AI reads all messages with this customer and extracts their name, phone number, email, and address. Great for auto-filling CRM records.
Inputs: customer_id (required), org_id. Returns: object
generate_captionA
Generate an AI-powered social media caption.
Creates engaging, platform-optimized captions using AI. Supports Turkish and English, multiple tones.
Inputs: topic (required), platform, language, tone, +1 more. Returns: object
generate_hashtagsB
Generate AI-optimized hashtags for a social media post.
Creates relevant, trending hashtags based on caption content.
Inputs: caption (required), platform, language, org_id. Returns: object
get_customerA
Get detailed information about a specific customer.
Returns full customer profile including contact details, tags, notes, conversation history summary, and order information.
Inputs: customer_id (required), org_id. Returns: object
get_social_analyticsA
Get social media analytics and performance metrics.
Returns engagement stats, follower growth, reach, and impressions for your social media accounts over a given time period.
Inputs: platform, account_id, period, org_id. Returns: object
get_social_quotaA
Get social media quota and usage limits for the current billing period.
Returns remaining post quota, message limits, and when the period resets. Useful before running bulk operations.
Inputs: org_id. Returns: object
list_customersA
List CRM customers with optional filtering.
Browse the customer database built from social media conversations. Filter by name/email/phone search, platform source, or tags.
Inputs: search, platform, tag, org_id. Returns: object
list_inboxA
List social media inbox conversations (DMs and comments).
Shows all incoming messages from Instagram, Facebook, WhatsApp, etc. Optionally filter by platform or unread status.
Inputs: platform, unread_only, org_id. Returns: result
list_organizationsA
List all organizations associated with your API key.
Use this to find your Organization ID (org_id) required for all social media and CRM tools. You can also set YAPARAI_ORG_ID env var to avoid passing it every time.
Returns: List of organizations with id, name, plan, and member count.
Inputs: no named parameters. Returns: result
list_social_accountsA
List connected social media accounts (Instagram, Facebook, TikTok, X/Twitter).
Shows all social accounts linked to the organization with their status, username, and follower count. Requires enterprise subscription.
Inputs: org_id. Returns: result
list_social_postsA
List published and scheduled social media posts.
Returns all posts for the organization with engagement stats. Supports filtering by platform, account, or post status.
Inputs: platform, account_id, status, org_id. Returns: object
read_conversationA
Read all 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
reply_to_messageA
Reply to a social media DM or message.
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_infoA
Send shipping and tracking information to a customer.
Automatically sends a tracking message through the same social platform the customer used to contact you (Instagram DM, WhatsApp, etc.).
Inputs: customer_id (required), carrier (required), tracking_code (required), org_id. Returns: object
sync_customers_from_inboxA
Import customers from social media inbox conversations.
Scans all inbox conversations and creates CRM customer records for everyone who has messaged you. New customers are auto-tagged by platform. Existing customers are not duplicated.
Inputs: org_id. Returns: object
update_customerA
Update an existing customer's information.
Partially update a customer record — only provided fields are changed. Tags replace the existing tag list completely.
Inputs: customer_id (required), name, phone, email, +3 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Each tool targets a distinct action and resource. For example, customer tools (create, get, update, list, note) are separate from social posting (create, delete, list, caption, hashtags) and inbox management (list, read, reply, bulk, AI suggestion). Even overlapping domains like AI reply suggestion vs. reply_to_message are clearly distinguished by generation vs. sending.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_customer, list_social_posts, get_social_analytics). No mixing of camelCase or other conventions. The pattern is predictable across all 22 tools.
22 tools is slightly above the typical 3-15 range for a well-scoped server, but each tool has a clear purpose and the number is justified by the breadth of functionality (CRM, social posting, inbox, analytics, organization management). It is not excessive and avoids redundancy.
The tool set covers core CRUD for customers and social posts, inbox interaction, analytics, and AI-assisted features. Minor gaps like missing update for social posts, tag management, or message deletion exist, but the main workflows are well-supported. Agents can accomplish most tasks without dead ends.
Maintenance
Related MCP Connectors
LinkedIn, WhatsApp, Telegram and Instagram inboxes, profiles and outreach for your AI assistant.
Lets AI agents post and reply on Instagram, TikTok, Threads and more, with a human approval queue.
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Draft, schedule and publish social media posts from your AI assistant.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceEnables AI assistants to interact with Instagram and Facebook accounts through their APIs, supporting messaging, post management, commenting, and content creation.14-

PostMCP MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.736 npmMIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to draft, schedule, and publish social media content, generate AI text and image variations, analyze performance, and automate social workflows.MIT
- AlicenseAqualityCmaintenanceEnables AI assistants and autonomous agents to connect to social media accounts and manage, generate, schedule, upload media for, and publish content across Facebook Pages, YouTube, TikTok, Instagram, and X, plus maintain a content pipeline.14MIT