Skip to main content
Glama
YaparAI Enterprise MCP Server

YaparAI Enterprise MCP Server

by enis1998

YaparAI Enterprise MCP Server

Enterprise Social Media & CRM management — directly from Claude Desktop, Cursor, Windsurf, and other MCP-compatible AI assistants.

License Python

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_organizations

List your organizations and find your org_id

📱 Social Media (12)

Tool

Description

list_social_accounts

List connected Instagram/Facebook/TikTok/X accounts

create_social_post

Publish or schedule a post

list_social_posts

Browse published and scheduled posts

delete_social_post

Delete a post

get_social_analytics

Engagement stats, reach, follower growth

generate_caption

AI-generated post caption (TR/EN)

generate_hashtags

AI-optimized hashtags

list_inbox

Read social media DMs and comments

read_conversation

Full message history of a conversation

reply_to_message

Reply to a DM or comment

ai_reply_suggestion

AI-suggested reply for a conversation

get_social_quota

Check posting quota and limits

👥 CRM (8)

Tool

Description

list_customers

Browse CRM customers (filter by tag, platform, search)

get_customer

Get full customer profile

create_customer

Manually add a new customer

update_customer

Update customer info (name, phone, email, tags)

add_customer_note

Add a note to a customer record

extract_customer_info

AI extracts name/phone/email from conversation

send_shipping_info

Send tracking notification via social DM

bulk_message

Mass message by tag, platform, or customer list

sync_customers_from_inbox

Import customers from inbox conversations

Quick Start

1. Install

pip install git+https://github.com/enis1998/yaparai-enterprise-mcp.git

2. Get API Key & Org ID

  1. Sign up at kurumsal.yaparai.com

  2. Go to Settings > API Keys and create a key

  3. Use list_organizations tool to find your org_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

YAPARAI_API_KEY

✅ Yes

Your API key

YAPARAI_ORG_ID

✅ Yes (or per-call)

Organization ID

YAPARAI_BASE_URL

❌ No

API base URL (default: https://api.yaparai.com)

Development

git clone https://github.com/enis1998/yaparai-enterprise-mcp.git
cd yaparai-enterprise-mcp
pip install -e ".[dev]"
pytest tests/ -v

License

Apache 2.0

Available Tools

22 tools
add_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

    A3.9/5.0

    Scored across 22 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers