MCP Integration
Use eWasl from Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant.
What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI assistants to interact with external tools and services. eWasl's MCP integration lets you manage social media through natural conversation with your AI.
What You Can Do
- "Post this to Twitter and LinkedIn" — Create and publish posts instantly
- "Show me my connected accounts" — List social accounts with connection status
- "Schedule this for Monday at 9am" — Schedule posts with intelligent delivery
- "What posts did I publish this week?" — List and filter your post history
Supported AI Clients
| Client | Transport | Status |
|---|---|---|
| Claude Code (CLI) | HTTP | Supported |
| Claude Desktop | stdio via mcp-remote | Supported |
| Cursor | HTTP | Supported |
| ChatGPT | HTTP | Supported |
| Any MCP client | HTTP | Supported |
Quick Start
- Create an API key with
posts:createandposts:readpermissions. - Add the MCP server config to your AI client (see Setup Guide).
- Start managing social media through conversation.
Available Tools
eWasl exposes 37 tools over MCP, each gated by the scope on your API key. Below are the most commonly used ones; every tool maps 1:1 to a documented REST endpoint.
| Tool | Description |
|---|---|
create_post | Create, schedule, or publish a post |
list_posts | List posts with filters and pagination |
schedule_post | Schedule a post for future delivery |
list_connections | View connected social accounts |
get_kpi_summary | Ad KPIs (spend, ROAS, CTR…) with deltas |
list_campaigns | List ad campaigns across Meta + Google |
pause_campaign / resume_campaign | Pause/resume a campaign (requires ads:write) |
ask_copilot | Run the Arabic-aware Marketing Copilot (requires copilot) |
Marketing Copilot tools
With the copilot scope, your AI client can drive eWasl's agent directly —
multi-step planning, brand-voice-aware analysis, and live todo plans:
ask_copilotcopilotRun the copilot for one instruction and get back its answer plus the live plan it produced. Returns a sessionId to continue the plan.
messagestringrequired— The instruction/question (Arabic or English).sessionIdstring— Continue an existing session.locale'ar' | 'en'— Reply language (default ar).list_copilot_sessionscopilotList your recent copilot sessions, newest first.
limitnumber— Max sessions (default 20, max 50).get_copilot_sessioncopilotGet a session's metadata, transcript, and current plan.
sessionIdstringrequired— Session UUID.list_copilot_todoscopilotGet the ordered plan (todos) the copilot produced for a session.
sessionIdstringrequired— Session UUID.Ad write tools (pause_campaign, resume_campaign, set_auto_pilot) — and
the copilot's ability to use them — require the ads:write scope in addition
to copilot. A copilot-only key can plan and analyse but never change a live
ad platform.
For detailed setup instructions and configuration examples, visit the MCP Setup Guide.