# 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