io.github.wilzer/aidelly
io.github.wilzer/aidellyAgent-operated social media for agencies — www.aidelly.ai. Post, approve, analyze on 11 networks.
Tools · 136
POST /posts/approvals — approve, reject (with reason), return to draft, or comment on one or many pending posts. Owner/admin only. Public API preview.
Register a competitor root domain to track in the workspace.
Register a creator handle on a specific platform to track.
POST /queues/{id}/items — add content items to queue tail for distribution at next available slots.
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 arra…
Cancel a scheduled post.
DELETE /scheduled-posts/{id} — cancel a scheduled post (and its pending recycles). Public API preview.
POST /ecommerce/stores — connect a new Shopify / WooCommerce / Etsy / Wix store. Verifies credentials then kicks off initial sync. Public API preview.
POST /calendar/bulk-fill
POST /client-review-links — create a magic-link review portal. Returns the raw token exactly once; store it securely.
Create an OAuth connect link for the workspace.
POST /destination-presets — create a multi-channel fan-out preset with per-platform transformations.
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 ac…
Create a new idea on the workspace's idea board, optionally seeded with an initial body or topic.
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-sandbox…
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. HTTP 201 and ok=true mean accepted, not delivered. For immediate posts, poll aidelly_get_post and only report publication when…
Create a comment on a post. Text body is required; @mention parsing is automatic. Replies require parent_comment_id pointing to the root comment.
POST /queues — create a new content distribution queue with recurring weekly time slots.
Create a report for a date range and synchronously build its analytics snapshot from the workspace connected accounts. Requires an Idempotency-Key header.
POST /report-links — create a shareable report link (snapshot or live with cadence).
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.
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.
Create a manual short link on the workspace.
Create a new task in the workspace.
Create a webhook subscription for post lifecycle events.
POST /workspaces — create a new workspace for the API key owner.
DELETE /calendar/events/{id}
DELETE /content-automations/{id}
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.
DELETE /inbox/automations/{id}
Soft delete a comment. Only the author or workspace owner can delete comments.
Soft-delete a report schedule (sets active=false, idempotent).
Soft-delete a task (hidden but can be restored).
Delete a webhook subscription by ID.
DELETE /workspaces/{workspaceId} — soft-delete a workspace. Requires confirm_name to match the workspace name.
DELETE /ecommerce/stores/{id} — revoke the provider credential and stop future syncs. Imported products remain. Public API preview.
POST /ideas/interview/questions — generate a brand-aware track of interview questions. Default count 8. Public API preview.
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/D…
Get workspace AI credit balance snapshot, including plan credits, trial grants, and purchased credits.
GET /analytics/insights
GET /analytics/summary
GET /analytics/unified
GET /workspaces/{workspaceId}/approval-settings — read member and owner-review approval settings. Public API preview.
GET /approvals
GET /approvals/{id}
Get the workspace's link-in-bio page configuration and blocks.
GET /brand/profile — retrieve the workspace brand profile, including brand voice.
GET /brand/settings-context
GET /calendar/bulk-fill/{jobId}
GET /calendar/events
GET /content-automations
GET /content-automations/{id}
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.
GET /ecommerce/stores/{id} — read one connected store. Public API preview.
GET /inbox/automations
GET /inbox/items
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.
GET /posts/{id}/analytics — retrieve post performance metrics (views, impressions, likes, comments, shares, saves) with optional daily breakdown.
Retrieve a single report by ID (workspace-scoped).
Retrieve a single report schedule by ID (workspace-scoped).
Get a single repurpose job by id.
GET /scheduled-posts/{id} — read one scheduled post including its recycle plan and approval state. Public API preview.
Get full details of a task including attachments and activity history.
Get usage metrics and current plan-aware limits for the API key.
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 ha…
GET /workspaces/{workspaceId} — retrieve one accessible workspace.
POST /workspaces/{workspaceId}/invitations — invite a member or client to a workspace. Returns the invitation URL and queues the email by default.
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` …
List workspace activity audit trail with optional filtering and cursor pagination.
GET /client-review-links — list workspace client review links with metadata (view count, last viewed, revoked status).
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`. Use this to diagnose why a client cou…
List tracked creator handles for the workspace.
GET /destination-presets — list workspace destination presets for multi-channel fan-out.
List workspace drafts with optional platform filtering. Drafts are saved as work-in-progress content and never publish.
GET /ecommerce/products — list products across the workspace's connected stores. Filter by store, search title/SKU. Public API preview.
GET /ecommerce/stores — list connected Shopify / WooCommerce / Etsy / Wix stores for the workspace. Public API preview.
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.
GET /posts/approvals — list posts pending sign-off for the current workspace, plus viewer role + canReview flag. Public API preview.
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.
GET /posts/approvals/{id}/events — read the approval audit timeline (submitted/approved/rejected/returned_to_draft/commented) for one post. Public API preview.
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.
GET /prompts
GET /queues — list workspace content queues with slot schedules and channel assignments.
GET /report-links — list workspace report share links, optionally filtered by mode (snapshot or live).
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.
GET /scheduled-posts — list scheduled posts including compose-time auto-recycle entries and approval state. Public API preview.
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 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…
List webhook subscriptions for post lifecycle events.
GET /workspaces/{workspaceId}/members — list active members and pending invitations.
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…
PATCH /analytics/insights
PATCH /calendar/events/{id}
PATCH /inbox/automations/{id}
PATCH /posts/{id}
POST /analytics/insights
POST /approvals/{id}/action
POST /approvals/items/action
POST /content-automations
POST /content-automations/{id}/trigger
POST /inbox/automations
POST /inbox/items/{id}/ai-draft
POST /inbox/items/{id}/respond
POST /destination-presets/{id}/preview — preview how a preset transforms a source post across channels.
PUT /content-automations/{id}
DELETE /workspaces/{workspaceId}/members — remove a workspace member.
DELETE /client-review-links/{id} — revoke a client review link and block further access.
Revoke an OAuth connect link, preventing further use.
DELETE /report-links/{id} — revoke a report share link.
DELETE /workspaces/{workspaceId}/invitations — revoke a pending workspace invitation.
POST /prompts/{id}/run
POST /ecommerce/stores/{id}/sync — re-sync the store's catalog. Incremental; only changed products are fetched. Public API preview.
PATCH /workspaces/{workspaceId}/approval-settings — update member or owner-review approval settings. Owner review is owner-only. Public API preview.
PUT /brand/profile — update workspace brand profile fields such as brand_voice, writing_style, and target_audience.
Update an OAuth connect link's title or enabled status.
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…
Edit a comment's text. Only the author can edit their own comments.
Update a report schedule (idempotent).
PATCH /scheduled-posts/{id} — update caption, schedule, or recycle plan on a scheduled post. Public API preview.
Update task fields (title, description, status, priority, assignee, due date, or links).
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 configuratio…
PATCH /workspaces/{workspaceId} — update workspace name, archive state, kind, or mode.
PATCH /workspaces/{workspaceId}/members — update a workspace member role.
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…
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"io.github.wilzer/aidelly": {
"url": "https://app.aidelly.ai/api/mcp/public-api",
"transport": "streamable-http"
}
}
}