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 MCP plugins, 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

Connect your account

Use OAuth for ChatGPT custom MCP plugins and Claude connectors. ChatGPT's current flow is Plugins → Add → Add custom MCP server, with Name Aidelly, Server URL below, and Authentication OAuth. Keep advanced discovery defaults, review the trust notice, create the plugin, and sign in.

https://app.aidelly.ai/mcp

No manually generated integration key is needed for these OAuth connections. For clients using API-key authentication, create a key at Aidelly API Keys, then send:

Authorization: Bearer YOUR_API_KEY

API-key access requires an eligible plan. Alternative headers depend on the server's auth mode; OAuth mode requires Bearer authentication. OAuth reference

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 exposes the public /api/public/v1 operations as tools. Examples:

aidelly_list_workspaces — list your workspaces; call it first and pass the id as workspace_id
aidelly_create_post — request post creation or scheduling; acceptance does not confirm delivery
aidelly_list_posts — list posts with filters
aidelly_get_post — fetch a single post
aidelly_update_post — update a post
aidelly_get_brand_settings_context — get brand context
aidelly_list_social_connections — list connected social accounts
aidelly_get_post_analytics — fetch analytics for a post
aidelly_review_approval_items — approve or reject generated content (REST and CLI; the hosted MCP server does not expose approval actions)

See Tool Reference for the full generated list, with the scope each tool needs and where it is available.

Rate limits

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

MCP Overview