Skip to main content

YaparAI Enterprise MCP Server

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

PyPI version 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 yaparai-enterprise-mcp

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

Metadata

Release files for yaparai-enterprise-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yaparai-enterprise-mcp 0.1.1
File Size Uploaded Provenance Actions
yaparai_enterprise_mcp-0.1.1.tar.gz 13.4 kB Without provenance Details for yaparai_enterprise_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for yaparai-enterprise-mcp 0.1.1
File Interpreter ABI Platform Actions
yaparai_enterprise_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for yaparai_enterprise_mcp-0.1.1-py3-none-any.whl

Total release size: 28.2 kB

Release files / yaparai_enterprise_mcp-0.1.1.tar.gz

Download URL yaparai_enterprise_mcp-0.1.1.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
eb827acc035a65f2e7b4c3afe861f89c68d8ecbf0d2cb05962d0a5fec2a2c780
BLAKE2b-256 checksum
How to use checksums
6816010afe4220696f3207b4d27f6c4b1761a51d948cdc5397dde642ebaab3d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / yaparai_enterprise_mcp-0.1.1-py3-none-any.whl

Download URL yaparai_enterprise_mcp-0.1.1-py3-none-any.whl
Size 14.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9234673a990c240c7b809325ff8db011f0b8a1cb5fa4b81d9995713a9fee801a
BLAKE2b-256 checksum
How to use checksums
34c0474b9d5199e53598385a5084098eb01352414d07e6c401abb21164be2d2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for yaparai-enterprise-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page