aidelly

Agent-operated social media for agencies — www.aidelly.ai.

CommunityDegradedNo sign-inGlobalFreeCan modify data

What it can do

What data it sees

Do you need an account

No: the server works without sign-in

Agent-operated social media for agencies — www.aidelly.ai. Post, approve, analyze on 11 networks.

How to connect

How to connect aidelly to Claude

The server address to paste into Claude settings:

https://app.aidelly.ai/api/mcp/public-api

Open Claude (claude.ai or the desktop app).
Go to Settings → Connectors.
Click Add custom connector.
Paste the server address copied below into Remote MCP server URL and click Add.
In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect aidelly to ChatGPT

The server address to paste into ChatGPT settings:

https://app.aidelly.ai/api/mcp/public-api

Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
Open Settings → Connectors and click Create.
Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect aidelly to Cursor

The server address to paste into Cursor settings:

https://app.aidelly.ai/api/mcp/public-api

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (139)

Raw names from tools/list. Only developers need these.

aidelly_action_post_approval	POST /posts/approvals — approve, reject (with reason), return to draft, or comment on one or many pending posts. Owner/admin only. Public API preview.
aidelly_add_competitor	Register a competitor root domain to track in the workspace.
aidelly_add_creator	Register a creator handle on a specific platform to track.
aidelly_add_queue_items	POST /queues/{id}/items — add content items to queue tail for distribution at next available slots.
aidelly_bulk_create_posts	Create up to 50 scheduled posts in one call. Each item takes the same shape as aidelly_create_post. Returns HTTP 201 when every item was accepted and 207 when some failed, with a per-item results array carrying index, status, and either the created post or an error — inspect it rather than assuming the whole batch succeeded. Acceptance is not delivery: poll aidelly_get_post for each created id. Rate limit is charged per post, not per request, so a 20-post batch costs 20 write units — it saves round trips, not quota. The whole batch is rejected before anything is written if it would exceed your daily scheduling limit. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.
aidelly_cancel_post	Cancel a scheduled post.
aidelly_cancel_scheduled_post	DELETE /scheduled-posts/{id} — cancel a scheduled post (and its pending recycles). Public API preview.
aidelly_connect_ecommerce_store	POST /ecommerce/stores — connect a new Shopify / WooCommerce / Etsy / Wix store. Verifies credentials then kicks off initial sync. Public API preview.
aidelly_create_bulk_fill_job	POST /calendar/bulk-fill
aidelly_create_client_review_link	POST /client-review-links — create a magic-link review portal. Returns the raw token exactly once; store it securely.
aidelly_create_connect_link	Create an OAuth connect link for the workspace.
aidelly_create_destination_preset	POST /destination-presets — create a multi-channel fan-out preset with per-platform transformations.
aidelly_create_draft	Create a draft — saved as work-in-progress content that never publishes. The draft_planned_for field is a planning date only. Existing API keys need the new `drafts:write` scope added to gain draft access; no implicit grant occurs. Requires `platform` or a non-empty `platforms` array.
aidelly_create_idea	Create a new idea on the workspace's idea board, optionally seeded with an initial body or topic.
aidelly_create_media_upload_url	Create a signed upload URL and media record for shell-capable clients that can PUT raw bytes to the returned Supabase URL (for example Claude Code or a local CLI). Do NOT use this from browser-sandboxed chat clients such as ChatGPT or Claude.ai: their sandboxes block network egress to Supabase storage, so the byte upload will fail. Those clients must use aidelly_upload_media instead (this tool is hidden automatically for known chat clients).
aidelly_create_photo	Upload a photo to a connected platform's media gallery (separate from posts). Today only google_business is wired.
aidelly_create_post	Accept a post for immediate asynchronous publishing or future scheduling. HTTP 201 and ok=true mean accepted, not delivered. For immediate posts, poll aidelly_get_post and only report publication when status is completed and provider_post_id is non-null. Use aidelly_list_pinterest_boards before Pinterest posts and pass content.platform_specific.board_id. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.
aidelly_create_post_comment	Create a comment on a post. Text body is required; @mention parsing is automatic. Replies require parent_comment_id pointing to the root comment.
aidelly_create_queue	POST /queues — create a new content distribution queue with recurring weekly time slots.
aidelly_create_report	Create a report for a date range and synchronously build its analytics snapshot from the workspace connected accounts. Requires an Idempotency-Key header.
aidelly_create_report_link	POST /report-links — create a shareable report link (snapshot or live with cadence).
aidelly_create_report_schedule	Create a new report schedule. Soft-capped at 10 active schedules per workspace.
aidelly_create_repurpose_job	Run a synchronous repurpose job: extract source content, distill, and generate output for one (medium, shape) target.
aidelly_create_scheduled_post	POST /scheduled-posts — schedule a post with optional auto-recycle entries (up to 3 reposts + 3 reshares). When Team Approvals is on, member submissions land as pending. Public API preview. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.
aidelly_create_short_link	Create a manual short link on the workspace.
aidelly_create_task	Create a new task in the workspace.
aidelly_create_webhook	Create a webhook subscription for post lifecycle events.
aidelly_create_workspace	POST /workspaces — create a new workspace for the API key owner.
aidelly_delete_calendar_events_id	DELETE /calendar/events/{id}
aidelly_delete_calendar_share_link	Permanently delete a calendar share link so its public /calendar/share/<token> URL stops working. This is irreversible — disable the link in-app instead if you may need it back. Returns 404 for unknown ids and for links in another workspace alike.
aidelly_delete_campaign	Delete a content campaign. Campaigns with no scheduled or published posts are removed outright; campaigns that publish history still references are soft-deleted so the history keeps its grouping (the response's soft_deleted flag says which happened). Either way the campaign stops appearing anywhere. Returns 404 for unknown ids and for campaigns in another workspace alike.
aidelly_delete_content_automations_id	DELETE /content-automations/{id}
aidelly_delete_draft	Delete a draft by ID. Drafts are work-in-progress content that never publish. Existing API keys need the new `drafts:write` scope added to gain draft access; no implicit grant occurs.
aidelly_delete_inbox_automations_id	DELETE /inbox/automations/{id}
aidelly_delete_post_comment	Soft delete a comment. Only the author or workspace owner can delete comments.
aidelly_delete_report_schedule	Soft-delete a report schedule (sets active=false, idempotent).
aidelly_delete_short_link	Permanently delete a short link. The /l/<slug> redirect stops working and the link's click history is deleted with it, so prefer this only when the link should disappear entirely. Call aidelly_list_short_links first to get the link id. Returns 404 for unknown ids and for links in another workspace alike.
aidelly_delete_task	Soft-delete a task (hidden but can be restored).
aidelly_delete_webhook	Delete a webhook subscription by ID.
aidelly_delete_workspace	DELETE /workspaces/{workspaceId} — soft-delete a workspace. Requires confirm_name to match the workspace name.
aidelly_disconnect_ecommerce_store	DELETE /ecommerce/stores/{id} — revoke the provider credential and stop future syncs. Imported products remain. Public API preview.
aidelly_generate_brand_interview_questions	POST /ideas/interview/questions — generate a brand-aware track of interview questions. Default count 8. Public API preview.
aidelly_get_agency_overview	GET /agency/overview — cross-workspace agency summary (same data as the dashboard Command Center) — today's queue + next scheduled post, last-24h failures, pending approvals, inbox split by comments/DMs, and credit burn per workspace. Needs a workspace-unscoped key.
aidelly_get_ai_credit_balance	Get workspace AI credit balance snapshot, including plan credits, trial grants, and purchased credits.
aidelly_get_analytics_insights	GET /analytics/insights
aidelly_get_analytics_summary	GET /analytics/summary
aidelly_get_analytics_unified	GET /analytics/unified
aidelly_get_approval_settings	GET /workspaces/{workspaceId}/approval-settings — read member and owner-review approval settings. Public API preview.
aidelly_get_approvals	GET /approvals
aidelly_get_approvals_id	GET /approvals/{id}
aidelly_get_bio_page	Get the workspace's link-in-bio page configuration and blocks.
aidelly_get_brand_profile	GET /brand/profile — retrieve the workspace brand profile, including brand voice.
aidelly_get_brand_settings_context	GET /brand/settings-context
aidelly_get_bulk_fill_job	GET /calendar/bulk-fill/{jobId}
aidelly_get_calendar_events	GET /calendar/events
aidelly_get_content_automations	GET /content-automations
aidelly_get_content_automations_id	GET /content-automations/{id}
aidelly_get_draft	Get a single post draft by id. Drafts are never published; draft_planned_for is a planning date only. Ids must be copied exactly from aidelly_list_drafts.
aidelly_get_ecommerce_store	GET /ecommerce/stores/{id} — read one connected store. Public API preview.
aidelly_get_inbox_automations	GET /inbox/automations
aidelly_get_inbox_items	GET /inbox/items
aidelly_get_post	Get one post by its UUID. Delivery is confirmed only when status is completed and provider_post_id is non-null. A failed status includes error_code and error.
aidelly_get_post_analytics	GET /posts/{id}/analytics — retrieve post performance metrics (views, impressions, likes, comments, shares, saves) with optional daily breakdown.
aidelly_get_report	Retrieve a single report by ID (workspace-scoped).
aidelly_get_report_schedule	Retrieve a single report schedule by ID (workspace-scoped).
aidelly_get_repurpose_job	Get a single repurpose job by id.
aidelly_get_scheduled_post	GET /scheduled-posts/{id} — read one scheduled post including its recycle plan and approval state. Public API preview.
aidelly_get_task	Get full details of a task including attachments and activity history.
aidelly_get_usage	Get usage metrics and current plan-aware limits for the API key.
aidelly_get_white_label_config	GET /white-label — retrieve the agency's white-label branding configuration including domain verification status and DNS instructions. Domain changes must go through the in-app verification flow to handle ownership validation.
aidelly_get_workspace	GET /workspaces/{workspaceId} — retrieve one accessible workspace.
aidelly_invite_workspace_member	POST /workspaces/{workspaceId}/invitations — invite a member or client to a workspace. Returns the invitation URL and queues the email by default.
aidelly_list_accounts	List all postable accounts in a workspace as a flat list, including sub-accounts such as Facebook Pages, Instagram Business accounts, and LinkedIn company pages. Requires `workspace_id`. Use the `id` field from each account as the `account_id` when creating a post. Call this before creating posts to discover available account IDs per platform.
aidelly_list_activity	List workspace activity audit trail with optional filtering and cursor pagination.
aidelly_list_client_review_links	GET /client-review-links — list workspace client review links with metadata (view count, last viewed, revoked status).
aidelly_list_competitors	List tracked competitor domains for the workspace.
aidelly_list_connect_link_connections	List social connections made through an OAuth connect link.
aidelly_list_connect_links	List the workspace's OAuth connect links.
aidelly_list_connection_attempts	List recent social-connect (OAuth) attempts in a workspace, including failed ones, with the platform, initiator, outcome, and error code. Requires `workspace_id`. Use this to diagnose why a client could not connect an account; use aidelly_list_accounts for accounts that actually connected.
aidelly_list_creators	List tracked creator handles for the workspace.
aidelly_list_destination_presets	GET /destination-presets — list workspace destination presets for multi-channel fan-out.
aidelly_list_drafts	List workspace drafts with optional platform filtering. Drafts are saved as work-in-progress content and never publish.
aidelly_list_ecommerce_products	GET /ecommerce/products — list products across the workspace's connected stores. Filter by store, search title/SKU. Public API preview.
aidelly_list_ecommerce_stores	GET /ecommerce/stores — list connected Shopify / WooCommerce / Etsy / Wix stores for the workspace. Public API preview.
aidelly_list_ideas	List ideas on the workspace's idea board, freshest first (pinned first).
aidelly_list_image_editor_outputs	List the workspace's saved AI-generated and edited image outputs, freshest first.
aidelly_list_pending_approvals	GET /posts/approvals — list posts pending sign-off for the current workspace, plus viewer role + canReview flag. Public API preview.
aidelly_list_pinterest_boards	List Pinterest boards available in a workspace. Call this before aidelly_create_post for Pinterest, then pass the selected board id as content.platform_specific.board_id.
aidelly_list_post_approval_events	GET /posts/approvals/{id}/events — read the approval audit timeline (submitted/approved/rejected/returned_to_draft/commented) for one post. Public API preview.
aidelly_list_post_comments	List comments on a post with cursor pagination. Comments are threaded; replies are returned alongside root comments.
aidelly_list_posts	List posts with optional platform, status, and date-range filters.
aidelly_list_prompts	GET /prompts
aidelly_list_queues	GET /queues — list workspace content queues with slot schedules and channel assignments.
aidelly_list_report_links	GET /report-links — list workspace report share links, optionally filtered by mode (snapshot or live).
aidelly_list_report_schedules	List all report schedules in the workspace with pagination and active status filtering.
aidelly_list_reports	List all reports in the workspace with pagination.
aidelly_list_repurpose_jobs	List recent repurpose jobs for the workspace.
aidelly_list_scheduled_posts	GET /scheduled-posts — list scheduled posts including compose-time auto-recycle entries and approval state. Public API preview.
aidelly_list_short_links	List the workspace's first-party short links (active only by default).
aidelly_list_social_connections	List available social connections for publishing.
aidelly_list_tasks	List workspace tasks with optional filtering by status, assignee, or ownership. Supports offset pagination.
aidelly_list_viral_trends	List discovered viral trends for the workspace, ordered by virality score.
aidelly_list_webhook_deliveries	List delivery attempts for one webhook so you can verify events actually arrived. status is one of pending, delivered, failed (will be retried at next_attempt_at), or dead_letter (retries exhausted or the webhook was removed — these will never be retried). Cursor-paginated: follow next_cursor until it is null. Call aidelly_list_webhooks first to get the webhook id.
aidelly_list_webhooks	List webhook subscriptions for post lifecycle events.
aidelly_list_workspace_members	GET /workspaces/{workspaceId}/members — list active members and pending invitations.
aidelly_list_workspaces	List workspace IDs available to this API key. Call this before creating posts when the user has multiple workspaces, then pass the chosen `id` as `workspace_id` so Aidelly posts to the exact workspace.
aidelly_patch_analytics_insights	PATCH /analytics/insights
aidelly_patch_calendar_events_id	PATCH /calendar/events/{id}
aidelly_patch_inbox_automations_id	PATCH /inbox/automations/{id}
aidelly_patch_posts_id	PATCH /posts/{id}
aidelly_post_analytics_insights	POST /analytics/insights
aidelly_post_approvals_id_action	POST /approvals/{id}/action
aidelly_post_approvals_items_action	POST /approvals/items/action
aidelly_post_content_automations	POST /content-automations
aidelly_post_content_automations_id_trigger	POST /content-automations/{id}/trigger
aidelly_post_inbox_automations	POST /inbox/automations
aidelly_post_inbox_items_id_ai_draft	POST /inbox/items/{id}/ai-draft
aidelly_post_inbox_items_id_respond	POST /inbox/items/{id}/respond
aidelly_preview_destination_preset	POST /destination-presets/{id}/preview — preview how a preset transforms a source post across channels.
aidelly_put_content_automations_id	PUT /content-automations/{id}
aidelly_remove_workspace_member	DELETE /workspaces/{workspaceId}/members — remove a workspace member.
aidelly_revoke_client_review_link	DELETE /client-review-links/{id} — revoke a client review link and block further access.
aidelly_revoke_connect_link	Revoke an OAuth connect link, preventing further use.
aidelly_revoke_report_link	DELETE /report-links/{id} — revoke a report share link.
aidelly_revoke_workspace_invitation	DELETE /workspaces/{workspaceId}/invitations — revoke a pending workspace invitation.
aidelly_run_prompt	POST /prompts/{id}/run
aidelly_sync_ecommerce_store	POST /ecommerce/stores/{id}/sync — re-sync the store's catalog. Incremental; only changed products are fetched. Public API preview.
aidelly_update_approval_settings	PATCH /workspaces/{workspaceId}/approval-settings — update member or owner-review approval settings. Owner review is owner-only. Public API preview.
aidelly_update_brand_profile	PUT /brand/profile — update workspace brand profile fields such as brand_voice, writing_style, and target_audience.
aidelly_update_connect_link	Update an OAuth connect link's title or enabled status.
aidelly_update_draft	Update a draft — set draft_planned_for to null to clear the planned date. Drafts never publish. Existing API keys need the new `drafts:write` scope added to gain draft access; no implicit grant occurs.
aidelly_update_post_comment	Edit a comment's text. Only the author can edit their own comments.
aidelly_update_report_schedule	Update a report schedule (idempotent).
aidelly_update_scheduled_post	PATCH /scheduled-posts/{id} — update caption, schedule, or recycle plan on a scheduled post. Public API preview.
aidelly_update_task	Update task fields (title, description, status, priority, assignee, due date, or links).
aidelly_update_white_label_config	PATCH /white-label — update the agency's white-label branding, email settings, and visibility toggles. Domain changes and verification must go through the in-app flow. Returns the updated configuration with current domain status.
aidelly_update_workspace	PATCH /workspaces/{workspaceId} — update workspace name, archive state, kind, or mode.
aidelly_update_workspace_member	PATCH /workspaces/{workspaceId}/members — update a workspace member role.
aidelly_upload_media	Default image-attach path for MCP: upload media in one step, server-side, with no client-to-Supabase connection required. Preferred for all browser-based chat clients (ChatGPT, Claude.ai) and safe for any client. Provide exactly one of source_url (a public HTTPS URL the server fetches — best for anything non-trivial and not subject to a payload size cap), data_url, or file_base64 (small inline images only; large payloads hit the MCP tool-call size limit). Returns media_id and read_url for aidelly_create_post content.media.