MCP serverio.github.wilzer/aidelly

Register a competitor root domain to track in the workspace.

Register a creator handle on a specific platform to track.

Add content items to the end of a distribution queue. Items publish in the queue's next available time slots, so adding them schedules content for publishing. Retry-safe: a repeat

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 p

Cancel one post so it does not publish: its status becomes canceled and the record is kept. Posts that are already completed, failed, or canceled are rejected with 409. Pending aut

Cancel a scheduled calendar post in the workspace and its pending auto-recycle entries (reposts and reshares waiting on it). Statuses become canceled and the records are kept. Requ

Create an asynchronous job to schedule 1-200 supplied social posts in the selected workspace. Each post specifies its platform, caption, and scheduledAt time with an offset, plus i

Create a magic-link review portal where a client reviews workspace content without an Aidelly account. The raw access token appears once, in this response, and cannot be read again

Create an OAuth connect link for the workspace.

Create a content automation rule from the configuration in body. Supports scheduled content generation and YouTube repurposing rules. Active rules generate content and can schedule

Create a destination preset: a saved set of channels with per-platform transformations, used to fan one post out across multiple channels. Saving a preset publishes nothing.

Create a draft: work-in-progress content that is saved but never publishes. Requires platform or a non-empty platforms array; draft_planned_for is a planning date only and schedule

Create a new idea on the workspace's idea board, optionally seeded with an initial body or topic.

Create an automatic reply rule for a connected Instagram account or Facebook Page. Requires platformAccountId and message, plus keyword for comment triggers. Rules are enabled by d

Create a media record and a signed Supabase Storage URL that the client uploads raw bytes to with an HTTP PUT. Works only for clients with direct network access to Supabase storage

Upload a photo to a connected platform's media gallery (separate from posts). Today only google_business is wired.

Accept a post for immediate asynchronous publishing or future scheduling on a connected account. HTTP 201 and ok=true mean accepted, not delivered: delivery is confirmed when aidel

Create a comment on a post. Text body is required; @mention parsing is automatic. Replies require parent_comment_id pointing to the root comment.

Create a content distribution queue with recurring weekly time slots. Content added with aidelly_add_queue_items publishes in those slots; creating the queue publishes nothing.

Create a report for a date range and synchronously build its analytics snapshot from the workspace's connected accounts. Retry-safe: a repeat call with the same idempotency_key ret

Create a shareable link to a workspace report, either a fixed snapshot or a live view refreshed on a cadence. aidelly_revoke_report_link disables it. Retry-safe: a repeat call with

Create a new report schedule. Soft-capped at 10 active schedules per workspace.

Run a synchronous repurpose job: extract source content, distill, and generate output for one (medium, shape) target.

Schedule a post for a future time, with optional auto-recycle entries (up to 3 reposts and 3 reshares). Scheduled posts publish automatically at their time; when Team Approvals is

Create a manual short link on the workspace.

Create a new task in the workspace.

Create a webhook subscription for post lifecycle events.

Create a new workspace owned by the API key owner. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Delete a calendar event by id from the selected workspace. Removes the stored event, or cancels the post when the calendar uses scheduled posts as its backing store. Returns the de

Permanently delete a calendar share link so its public /calendar/share/<token> URL stops working. Irreversible; disabling the link in the Aidelly app is the reversible alternative.

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 keep

Delete a content automation rule by id. Removes the saved rule so it no longer runs on future triggers; returns the deletion result. Retry-safe: a repeat call with the same idempot

Delete a draft by id. Drafts are work-in-progress content that never publishes.

Delete an inbox automatic reply rule by id. Removes its configuration so the rule no longer handles future triggers; returns the deletion result. Retry-safe: a repeat call with the

Soft delete a comment. Only the author or workspace owner can delete comments.

Soft-delete a report schedule (sets active=false, idempotent).

Permanently delete a short link: the /l/<slug> redirect stops working and the link's click history is deleted with it. Irreversible. Link ids come from aidelly_list_short_links. Re

Soft-delete a task (hidden but can be restored).

Delete a webhook subscription by ID.

Soft-delete a workspace. confirm_name has to match the workspace name exactly. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Disconnect a connected store: deletes the stored connection and its credential, stops future syncs, and removes the products imported from it. Irreversible; reconnecting the store

Generate and save AI analytics insights for workspace_id, optionally limited to platforms. regenerate=true forces a fresh analysis even when insights already exist. aidelly_get_ana

Generate a brand-aware set of interview questions for capturing the brand's story and voice (8 by default, 4 to 20 with count; steer biases the set). Returns the questions. Retry-s

Generate an AI reply draft for an inbox item by id. Returns suggested reply text and attempts to save it on the item, replacing any earlier AI draft. Spends AI credits. Sends nothi

Read a cross-workspace agency summary, the same data as the dashboard Command Center: today's queue and next scheduled post, failures in the last 24 hours, pending approvals, inbox

Get workspace AI credit balance snapshot, including plan credits, trial grants, and purchased credits.

Read saved analytics insights for the workspace. May return an empty list. Reading generates nothing (aidelly_generate_analytics_insights does), and saved insights are not limited

Summarize workspace analytics for a timeframe (for example 30d) or a startDate/endDate range, for workspace_id. summary.platformMetrics holds the per-channel metrics used to compar

Read unified social analytics rows for workspace_id, combining stored and live provider metrics. Requires from and to as YYYY-MM-DD dates, not timestamps; optionally filter platfor

Read one content approval batch by id, including its generated content and review status. Read-only. It does not approve, reject, or schedule content.

Read the workspace's approval settings for member submissions and owner review. Read-only.

List content approval batches for workspace_id. Use status=pending for pending work and page/limit for pagination (maximum 50). Summary status and content counts describe the curre

Get the workspace's link-in-bio page configuration and blocks.

Read the workspace brand profile and voice. The profile's socialConnections and aiSummary can be historical: aidelly_list_social_connections reports current connection status, and

Read aggregated brand settings context for the selected workspace. Use this to inspect existing brand configuration before planning content or changing settings; it does not modify

Read the status of a previously created bulk calendar fill job by jobId. Returns job progress or completion status; a successful job creation response alone does not mean all posts

List content calendar events for the selected workspace, including timing, status, and content details. Use returned cursors to read additional pages. This only reads the calendar.

Read one saved content automation rule by id, including its configuration. Read-only. It does not run the automation.

List saved content automation rules for the selected workspace. Returns rule configuration and activity state; follow next_cursor for additional pages. Does not run or change rules

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.

Read one connected e-commerce store by id. Read-only.

List configured social inbox automation rules for the selected workspace, including their trigger and response settings. Reading rules does not enable them or send messages.

List social inbox messages and comments available in the selected workspace. Returns inbox items for triage or selecting an item to reply to; follow next_cursor for additional page

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.

Read performance metrics for one post (views, impressions, likes, comments, shares, saves), with an optional daily breakdown. Read-only.

Retrieve a single report by ID (workspace-scoped).

Retrieve a single report schedule by ID (workspace-scoped).

Get a single repurpose job by id.

Read one scheduled post, including its recycle plan and approval state. Read-only.

Get full details of a task including attachments and activity history.

Get usage metrics and current plan-aware limits for the API key.

Read the agency's white-label branding configuration, including custom-domain verification status and DNS instructions. Custom domains are changed and verified in the Aidelly app,

Read one workspace the API key can access. Read-only.

Invite a member or client to a workspace. Returns the invitation URL and, by default, emails the invitation to the invitee; send_email=false creates the invitation without sending

List every postable account in a workspace as a flat list, including sub-accounts such as Facebook Pages, Instagram Business accounts, and LinkedIn company pages. Requires workspac

List workspace activity audit trail with optional filtering and cursor pagination.

List the workspace's client review links with view count, last viewed time, and revoked status. Read-only.

List tracked competitor domains for the workspace.

List social connections made through an OAuth connect link.

List the workspace's OAuth connect links.

List recent social-connect (OAuth) attempts in a workspace, including failed ones, with the platform, initiator, outcome, and error code. Requires workspace_id. Useful for diagnosi

List tracked creator handles for the workspace.

List the workspace's destination presets for multi-channel fan-out. Read-only.

List workspace drafts with optional platform filtering. Drafts are saved as work-in-progress content and never publish.

List products across the workspace's connected stores, filtered by store or searched by title or SKU. Read-only.

List the Shopify, WooCommerce, Etsy, and Wix stores connected to the workspace. Read-only.

List ideas on the workspace's idea board, freshest first (pinned first).

List the workspace's saved AI-generated and edited image outputs, freshest first.

List posts waiting for team sign-off in the workspace, plus the viewer's role and a canReview flag. These are individual posts in Team Approvals; aidelly_get_approvals lists batche

List the Pinterest boards available in a workspace. A Pinterest post created with aidelly_create_post takes one of these board ids as content.platform_specific.board_id. Read-only.

Read the approval audit timeline for one post: submitted, approved, rejected, returned-to-draft, and commented events. Read-only.

List comments on a post with cursor pagination. Comments are threaded; replies are returned alongside root comments.

List posts with optional platform, status, and date-range filters.

List reusable prompt templates available in the selected workspace. Returns templates to inspect and select before execution; use limit (1-50) and cursor for pagination. Does not r

List the workspace's content queues with their slot schedules and channel assignments. Read-only.

List the workspace's report share links, optionally filtered by mode (snapshot or live). Read-only.

List all report schedules in the workspace with pagination and active status filtering.

List all reports in the workspace with pagination.

List recent repurpose jobs for the workspace.

List workspace scheduled posts with from/to timestamps, status, platform, and cursor pagination (maximum 100 per page). Returns items with scheduled_at and approval_status; an empt

List the workspace's first-party short links (active only by default).

List available social connections for publishing.

List workspace tasks with optional filtering by status, assignee, or ownership. Supports offset pagination.

List discovered viral trends for the workspace, ordered by virality score.

List delivery attempts for one webhook, to check whether events arrived. status is one of pending, delivered, failed (retried at next_attempt_at), or dead_letter (retries exhausted

List webhook subscriptions for post lifecycle events.

List a workspace's active members and pending invitations. Read-only.

List the workspaces this API key can access, with their ids. A workspace's id is the workspace_id other tools take, which directs content to that exact workspace. Read-only.

Preview how a destination preset transforms a source post for each of its channels. Returns the transformed variants and publishes nothing.

Remove a member from a workspace, ending their access to it. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Send a reply to the social message or comment behind an inbox item, with the reply text in body.message. Sends externally through the connected account, where the recipient sees it

Revoke a client review link so its review portal can no longer be opened.

Revoke an OAuth connect link, preventing further use.

Revoke a report share link so it stops working. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Revoke a pending workspace invitation so it can no longer be accepted. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Run a saved prompt template by id with its template variables in input_values. Generates an AI result, spends the applicable AI credits, and saves the prompt run. Template ids come

Re-sync a connected store's product catalog: fetches the store's products and upserts them into the workspace. Retry-safe: a repeat call with the same idempotency_key returns the o

Run a saved content automation rule by id on demand. Starts content generation with the rule's configuration, and the results can be scheduled or published according to its approva

Update the recorded state of an analytics insight in workspace_id. Supply insightId and action (view, dismiss, or act_upon). Marks the insight as viewed, dismissed, or acted upon;

Update the workspace's approval settings for member submissions and owner review. Only the workspace owner can change owner review. Retry-safe: a repeat call with the same idempote

Update workspace brand profile fields such as brand_voice, writing_style, and target_audience. Overwrites the supplied fields. Retry-safe: a repeat call with the same idempotency_k

Update an existing calendar event by id. Supply changed fields in body, such as scheduled_at, timezone, event_title, or scheduled_content_text. Overwrites stored event fields and c

Update an OAuth connect link's title or enabled status.

Update the saved content automation rule identified by id using the configuration in body. Overwrites the settings that control future generation, destinations, and approval behavi

Update a draft; set draft_planned_for to null to clear the planned date. Drafts never publish.

Update an inbox automatic reply rule by id, overwriting the supplied settings: message, trigger, connected account, guardrails, or enabled state. Enabled rules reply automatically

Update an existing mutable scheduled post by id. Supply changed content, scheduled_at, timezone, or metadata in body. Overwrites those fields and re-enqueues publication unless app

Edit a comment's text. Only the author can edit their own comments.

Update a report schedule (idempotent).

Update the caption, schedule, or recycle plan of a scheduled post. Overwrites the supplied fields; a new time changes when the post publishes. Retry-safe: a repeat call with the sa

Update task fields (title, description, status, priority, assignee, due date, or links).

Update the agency's white-label branding, email settings, and visibility toggles. Returns the updated configuration with the current domain status. Custom domains are changed and v

Update a workspace's name, archive state, kind, or mode. Retry-safe: a repeat call with the same idempotency_key returns the original result.

Change a workspace member's role, which changes what they can access. Retry-safe: a repeat call with the same idempotency_key returns the original result.

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, Cla