eWeWasl Docs

eWasl Developer Docs

Build with eWasl — REST API, MCP server, and ready-to-paste SDK snippets for Arabic-first social scheduling.

Welcome to the eWasl developer documentation. Pick a path below — every link on this page lands on a working endpoint or an MCP-compatible client config.

العربية: اقرأ التوثيق بالعربية — use the EN ⇄ ع switcher in the top bar on any page.

Quick start

Create an API key

Mint a Bearer token in your dashboard, copy it once, and start posting in 60 seconds.

Schedule your first post

POST one JSON payload to /v1/posts/schedule and we handle the rest — Twitter, Instagram, TikTok, LinkedIn, Facebook, YouTube.

Connect an AI agent

Plug eWasl into Claude, Cursor, ChatGPT, or any MCP-compatible client — via one-click OAuth or an API key. Tools span posts, connections, analytics, webhooks, and ads.

Use the CLI

npx @ewasl/cli — publish, schedule, and manage ads from your terminal or CI, with --json output for scripting.

Core REST API

Introduction

Base URL, error envelope, rate limits, idempotency.

Authentication

Generate, rotate, revoke API keys. Bearer header format.

Create post

POST /v1/posts — publish now or schedule across platforms.

Schedule post

POST /v1/posts/schedule — staggered delivery + per-platform captions.

List posts

GET /v1/posts — paginated, filter by status / platform.

List connections

GET /v1/connections — connected social accounts + token health.

API keys

Create, list, and revoke keys programmatically.

Webhooks

post.published / post.failed events with HMAC verification.

MCP for AI agents

MCP overview

What the eWasl MCP server is and the tools it exposes, mapped 1:1 to the V1 API.

Claude Desktop

stdio bridge via mcp-remote — copy-paste config.

Cursor

Native HTTP MCP — paste the URL, generate a key.

ChatGPT

Custom GPT Action setup using the OpenAPI schema.

Windsurf

Cascade MCP server config.

SLA & support

On this page