Metadata-Version: 2.4
Name: yaparai-enterprise-mcp
Version: 0.1.0
Summary: YaparAI Enterprise MCP Server — Social Media & CRM tools for Claude, Cursor, Windsurf
Project-URL: Homepage, https://github.com/enis1998/yaparai-enterprise-mcp
Project-URL: Repository, https://github.com/enis1998/yaparai-enterprise-mcp
Project-URL: Bug Tracker, https://github.com/enis1998/yaparai-enterprise-mcp/issues
Author: Enis Kaan Keskin
License: Apache-2.0
License-File: LICENSE
Keywords: ai,claude,crm,enterprise,mcp,social-media,yaparai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-mock>=3.12; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# YaparAI Enterprise MCP Server

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

[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org)

## What is this?

This is a dedicated **MCP (Model Context Protocol) server** for the [YaparAI Enterprise](https://kurumsal.yaparai.com) 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](https://github.com/ilhankilic/yaparai-mcp).

## 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

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

### 2. Get API Key & Org ID

1. Sign up at [kurumsal.yaparai.com](https://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

```json
{
  "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

```bash
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

