YaparAI Enterprise 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.

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