Connect Aidelly to any MCP-compatible AI client via the hosted streamable HTTP endpoint.

The Aidelly MCP server exposes the full public API as callable tools, letting any MCP-compatible AI client (Claude, ChatGPT, Cursor, etc.) post to social media, manage your inbox, and pull analytics directly from a conversation.

Two transports

Transport	Best for
Hosted HTTP (`https://app.aidelly.ai/mcp`)	Claude.ai Connectors, ChatGPT Apps, any remote MCP client
Local stdio (npm run mcp:aidelly)	Claude Desktop, Cursor, local MCP clients

Hosted endpoint

https://app.aidelly.ai/mcp

Aliases: /api/mcp and /api/mcp/public-api resolve to the same server.

The endpoint supports:

MCP JSON-RPC over HTTP POST
JSON-RPC batch requests
CORS preflight (OPTIONS)
HEAD probes for connector health checks
Protocol versions: 2024-11-05, 2025-03-26, 2025-06-18 and future YYYY-MM-DD versions

Authentication

The hosted server accepts two auth headers:

Authorization: Bearer aidelly_live_xxx
x-aidelly-api-key: aidelly_live_xxx

API keys require an active paid plan. Generate a key at Settings → API Keys in your Aidelly dashboard.

Workspace and brand routing

Pass optional routing headers to scope tool calls:

x-aidelly-workspace-id: <workspace-uuid>
x-aidelly-brand-id: <brand-uuid>

Available tools

The MCP server provides 36 tools covering full /api/public/v1 coverage. Examples:

aidelly_create_post — create and publish or schedule a post
aidelly_get_posts — list posts with filters
aidelly_get_post — fetch a single post
aidelly_patch_posts_id — update a post
aidelly_post_approvals_items_action — approve or reject a draft
aidelly_get_brand_settings_context — get brand context
aidelly_get_social_connections — list connected social accounts
aidelly_get_analytics — fetch post analytics

See Tool Reference for the full list.

Rate limits

MCP tool calls share the same rate limits as the underlying API key. See Rate Limits for per-plan limits.

MCP Overview