Aidelly Docs
MCP

Tool Reference

Full list of MCP tools exposed by the Aidelly MCP server.

This page lists every Aidelly MCP tool. The tables are generated from the registry the server loads, so they cannot name a tool the server does not have. Tool names are verb-first (aidelly_<verb>_<resource>, for example aidelly_update_post). Renamed tools keep their former names as hidden aliases, so existing integrations keep working.

Start with aidelly_list_workspaces and pass the returned id as workspace_id on every call. Every write tool requires an idempotency_key: reuse it when retrying the same action, and use a new one for a new action.

Interactive reference

The complete tool schemas — parameters, descriptions, and examples — are available in the interactive API reference:

Open API Reference →

You can also fetch the OpenAPI spec directly:

curl https://app.aidelly.ai/api/public/v1/openapi

The MCP tool list at runtime reflects the same schema:

# Using mcp-cli or any MCP client
mcp tools/list

Tools

The catalogue has 154 tools. Every tool is available on the REST API and the local stdio server.

  • Hosted (https://app.aidelly.ai/mcp): 150 tools. It leaves out 4 approval and store-connection actions. Browser clients (Claude.ai, ChatGPT) also do not see aidelly_create_media_upload_url (they upload with aidelly_upload_media) or the Brain document upload pair aidelly_create_brain_document_upload_url / aidelly_complete_brain_document_upload (they add documents with aidelly_add_brain_document).
  • ChatGPT (https://app.aidelly.ai/api/mcp/chatgpt): 21 tools, the set the Aidelly ChatGPT app uses.

Scope is the OAuth scope the tool asks for. Read-only tools change nothing.

Posts, drafts and scheduling

ToolTitleScopeRead-onlyAvailable on
aidelly_bulk_create_postsBulk Create Postsposts:writeNoHosted
aidelly_cancel_postCancel Postposts:writeNoHosted
aidelly_cancel_scheduled_postCancel Scheduled Postposts:writeNoHosted
aidelly_create_draftCreate Draftdrafts:writeNoHosted, ChatGPT
aidelly_create_postCreate Postposts:writeNoHosted
aidelly_create_scheduled_postCreate Scheduled Postposts:writeNoHosted
aidelly_delete_draftDelete Draftdrafts:writeNoHosted
aidelly_get_draftGet Draftdrafts:readYesHosted, ChatGPT
aidelly_get_postGet Postposts:readYesHosted
aidelly_get_scheduled_postGet Scheduled Postposts:readYesHosted
aidelly_get_usageGet Usageposts:readYesHosted
aidelly_list_draftsList Draftsdrafts:readYesHosted
aidelly_list_postsList Postsposts:readYesHosted, ChatGPT
aidelly_list_scheduled_postsList Scheduled Postsposts:readYesHosted, ChatGPT
aidelly_list_workspacesList Workspacesworkspaces:readYesHosted, ChatGPT
aidelly_update_draftUpdate Draftdrafts:writeNoHosted
aidelly_update_postUpdate Postposts:writeNoHosted
aidelly_update_scheduled_postUpdate Scheduled Postposts:writeNoHosted

Approvals and client review

ToolTitleScopeRead-onlyAvailable on
aidelly_action_post_approvalAction Post Approvalapprovals:writeNoREST and stdio only
aidelly_create_client_review_linkCreate Client Review Linkapprovals:writeNoHosted
aidelly_get_approval_batchGet Approval Batchapprovals:readYesHosted
aidelly_get_approvalsGet Approvalsapprovals:readYesHosted, ChatGPT
aidelly_list_client_review_linksList Client Review Linksapprovals:readYesHosted
aidelly_list_pending_approvalsList Pending Approvalsapprovals:readYesHosted, ChatGPT
aidelly_list_post_approval_eventsList Post Approval Eventsapprovals:readYesHosted
aidelly_review_approval_batchApprove, Reject, or Schedule Content Batchapprovals:writeNoREST and stdio only
aidelly_review_approval_itemsReview or Edit Selected Content Itemsapprovals:writeNoREST and stdio only
aidelly_revoke_client_review_linkRevoke Client Review Linkapprovals:writeNoHosted

Calendar, queues and destination presets

ToolTitleScopeRead-onlyAvailable on
aidelly_add_queue_itemsAdd Queue Itemsqueues:writeNoHosted
aidelly_create_bulk_fill_jobCreate Bulk Fill Jobcalendar:writeNoHosted
aidelly_create_destination_presetCreate Destination Presetdestination-presets:writeNoHosted
aidelly_create_queueCreate Queuequeues:writeNoHosted
aidelly_delete_calendar_eventDelete Calendar Eventcalendar:writeNoHosted
aidelly_delete_calendar_share_linkDelete Calendar Share Linkcalendar:writeNoHosted
aidelly_delete_campaignDelete Campaignqueues:writeNoHosted
aidelly_get_bulk_fill_jobGet Bulk Fill Jobcalendar:readYesHosted
aidelly_get_calendar_eventsGet Calendar Eventscalendar:readYesHosted
aidelly_list_destination_presetsList Destination Presetsdestination-presets:readYesHosted
aidelly_list_queuesList Queuesqueues:readYesHosted
aidelly_preview_destination_presetPreview Destination Presetdestination-presets:readNoHosted
aidelly_update_calendar_eventUpdate Calendar Eventcalendar:writeNoHosted

Media

ToolTitleScopeRead-onlyAvailable on
aidelly_create_media_upload_urlCreate Media Upload Urlmedia:writeNoHosted, except browser clients
aidelly_create_photoCreate Photophotos:writeNoHosted
aidelly_list_image_editor_outputsList Image Editor Outputsimage_editor:readYesHosted
aidelly_upload_mediaUpload Mediamedia:writeNoHosted
ToolTitleScopeRead-onlyAvailable on
aidelly_create_connect_linkCreate Connect Linkconnect_links:writeNoHosted
aidelly_list_accountsList Accountsconnections:readYesHosted
aidelly_list_connect_link_connectionsList Connect Link Connectionsconnect_links:readYesHosted
aidelly_list_connect_linksList Connect Linksconnect_links:readYesHosted
aidelly_list_connection_attemptsList Connection Attemptsconnections:readYesHosted
aidelly_list_pinterest_boardsList Pinterest Boardsconnections:readYesHosted
aidelly_list_social_connectionsList Social Connectionsconnections:readYesHosted, ChatGPT
aidelly_revoke_connect_linkRevoke Connect Linkconnect_links:writeNoHosted
aidelly_update_connect_linkUpdate Connect Linkconnect_links:writeNoHosted

Analytics and reports

ToolTitleScopeRead-onlyAvailable on
aidelly_create_reportCreate Reportreports:writeNoHosted
aidelly_create_report_linkCreate Report Linkreports:writeNoHosted
aidelly_create_report_scheduleCreate Report Schedulereports:writeNoHosted
aidelly_delete_report_scheduleDelete Report Schedulereports:writeNoHosted
aidelly_generate_analytics_insightsGenerate Social Analytics Insightsanalytics:writeNoHosted
aidelly_get_analytics_insightsGet Analytics Insightsanalytics:readYesHosted, ChatGPT
aidelly_get_analytics_summaryGet Analytics Summaryanalytics:readYesHosted, ChatGPT
aidelly_get_analytics_unifiedGet Analytics Unifiedanalytics:readYesHosted
aidelly_get_post_analyticsGet Post Analyticsanalytics:readYesHosted
aidelly_get_reportGet Reportreports:readYesHosted
aidelly_get_report_scheduleGet Report Schedulereports:readYesHosted
aidelly_list_report_linksList Report Linksreports:readYesHosted
aidelly_list_report_schedulesList Report Schedulesreports:readYesHosted
aidelly_list_reportsList Reportsreports:readYesHosted
aidelly_revoke_report_linkRevoke Report Linkreports:writeNoHosted
aidelly_update_analytics_insightUpdate Analytics Insightanalytics:writeNoHosted
aidelly_update_report_scheduleUpdate Report Schedulereports:writeNoHosted

Inbox, comments and automations

ToolTitleScopeRead-onlyAvailable on
aidelly_create_content_automationCreate Content Automationautomations:writeNoHosted
aidelly_create_inbox_automationCreate Inbox Automationinbox:writeNoHosted
aidelly_create_post_commentCreate Post Commentcomments:writeNoHosted
aidelly_delete_content_automationDelete Content Automationautomations:writeNoHosted
aidelly_delete_inbox_automationDelete Inbox Automationinbox:writeNoHosted
aidelly_delete_post_commentDelete Post Commentcomments:writeNoHosted
aidelly_generate_inbox_reply_draftGenerate Inbox Reply Draftinbox:writeNoHosted
aidelly_get_content_automationGet Content Automationautomations:readYesHosted
aidelly_get_content_automationsGet Content Automationsautomations:readYesHosted
aidelly_get_inbox_automationsGet Inbox Automationsinbox:readYesHosted
aidelly_get_inbox_itemsGet Inbox Itemsinbox:readYesHosted
aidelly_get_inbox_leadGet Inbox Leadinbox:readYesHosted
aidelly_list_inbox_leadsList Inbox Leadsinbox:readYesHosted
aidelly_list_post_commentsList Post Commentscomments:readYesHosted
aidelly_reply_to_inbox_itemReply To Inbox Iteminbox:writeNoHosted
aidelly_trigger_content_automationTrigger Content Automationautomations:writeNoHosted
aidelly_update_content_automationUpdate Content Automation Ruleautomations:writeNoHosted
aidelly_update_inbox_automationUpdate Inbox Automationinbox:writeNoHosted
aidelly_update_post_commentUpdate Post Commentcomments:writeNoHosted

Workspaces, team and white-label

ToolTitleScopeRead-onlyAvailable on
aidelly_create_workspaceCreate Workspaceworkspaces:writeNoHosted
aidelly_delete_workspaceDelete Workspaceworkspaces:writeNoHosted
aidelly_get_agency_overviewGet Agency Overviewworkspaces:readYesHosted
aidelly_get_ai_credit_balanceGet Ai Credit Balancecredits:readYesHosted
aidelly_get_approval_settingsGet Approval Settingsworkspaces:readYesHosted
aidelly_get_white_label_configGet White Label Configwhite-label:readYesHosted
aidelly_get_workspaceGet Workspaceworkspaces:readYesHosted
aidelly_invite_workspace_memberInvite Workspace Memberteam:writeNoHosted
aidelly_list_activityList Activityactivity:readYesHosted
aidelly_list_workspace_membersList Workspace Membersteam:readYesHosted
aidelly_remove_workspace_memberRemove Workspace Memberteam:writeNoHosted
aidelly_revoke_workspace_invitationRevoke Workspace Invitationteam:writeNoHosted
aidelly_update_approval_settingsUpdate Approval Settingsworkspaces:writeNoHosted
aidelly_update_white_label_configUpdate White Label Configwhite-label:writeNoHosted
aidelly_update_workspaceUpdate Workspaceworkspaces:writeNoHosted
aidelly_update_workspace_memberUpdate Workspace Memberteam:writeNoHosted

Brand, ideas and content research

ToolTitleScopeRead-onlyAvailable on
aidelly_add_brain_documentAdd Brain Documentbrand:writeNoHosted, ChatGPT
aidelly_add_brain_entryAdd Brain Entrybrand:writeNoHosted, ChatGPT
aidelly_add_competitorAdd Competitorcompetitors:writeNoHosted
aidelly_add_creatorAdd Creatorcreators:writeNoHosted
aidelly_archive_brain_entryArchive Brain Entrybrand:writeNoHosted, ChatGPT
aidelly_complete_brain_document_uploadComplete Brain Document Uploadbrand:writeNoHosted, except browser clients
aidelly_create_brain_document_upload_urlCreate Brain Document Upload Urlbrand:writeNoHosted, except browser clients
aidelly_create_ideaCreate Ideaideas:writeNoHosted
aidelly_create_repurpose_jobCreate Repurpose Jobrepurpose:writeNoHosted
aidelly_delete_brain_documentDelete Brain Documentbrand:writeNoHosted
aidelly_generate_brand_interview_questionsGenerate Brand Interview Questionsideas:writeNoHosted
aidelly_get_brain_contextGet Brain Contextbrand:readYesHosted, ChatGPT
aidelly_get_brain_documentGet Brain Documentbrand:readYesHosted, ChatGPT
aidelly_get_brain_entryGet Brain Entrybrand:readYesHosted, ChatGPT
aidelly_get_brand_profileGet Brand Profilebrand:readYesHosted, ChatGPT
aidelly_get_brand_settings_contextGet Brand Settings Contextbrand:readYesHosted
aidelly_get_repurpose_jobGet Repurpose Jobrepurpose:readYesHosted
aidelly_list_brain_documentsList Brain Documentsbrand:readYesHosted, ChatGPT
aidelly_list_brain_entriesList Brain Entriesbrand:readYesHosted, ChatGPT
aidelly_list_competitorsList Competitorscompetitors:readYesHosted
aidelly_list_creatorsList Creatorscreators:readYesHosted
aidelly_list_ideasList Ideasideas:readYesHosted
aidelly_list_promptsList Promptsprompts:readYesHosted
aidelly_list_repurpose_jobsList Repurpose Jobsrepurpose:readYesHosted
aidelly_list_viral_trendsList Viral Trendsviral_trends:readYesHosted
aidelly_run_promptRun Promptprompts:writeNoHosted
aidelly_search_brainSearch Brainbrand:readYesHosted, ChatGPT
aidelly_update_brain_entryUpdate Brain Entrybrand:writeNoHosted, ChatGPT
aidelly_update_brand_profileUpdate Brand Profilebrand:writeNoHosted

E-commerce

ToolTitleScopeRead-onlyAvailable on
aidelly_connect_ecommerce_storeConnect Ecommerce Storeecommerce:writeNoREST and stdio only
aidelly_disconnect_ecommerce_storeDisconnect Ecommerce Storeecommerce:writeNoHosted
aidelly_get_ecommerce_storeGet Ecommerce Storeecommerce:readYesHosted
aidelly_list_ecommerce_productsList Ecommerce Productsecommerce:readYesHosted
aidelly_list_ecommerce_storesList Ecommerce Storesecommerce:readYesHosted
aidelly_sync_ecommerce_storeSync Ecommerce Storeecommerce:writeNoHosted
ToolTitleScopeRead-onlyAvailable on
aidelly_create_short_linkCreate Short Linklinks:writeNoHosted
aidelly_delete_short_linkDelete Short Linklinks:writeNoHosted
aidelly_get_bio_pageGet Bio Pagebio:readYesHosted
aidelly_list_short_linksList Short Linkslinks:readYesHosted

Tasks

ToolTitleScopeRead-onlyAvailable on
aidelly_create_taskCreate Tasktasks:writeNoHosted
aidelly_delete_taskDelete Tasktasks:writeNoHosted
aidelly_get_taskGet Tasktasks:readYesHosted
aidelly_list_tasksList Taskstasks:readYesHosted
aidelly_update_taskUpdate Tasktasks:writeNoHosted

Webhooks

ToolTitleScopeRead-onlyAvailable on
aidelly_create_webhookCreate Webhookwebhooks:manageNoHosted
aidelly_delete_webhookDelete Webhookwebhooks:manageNoHosted
aidelly_list_webhook_deliveriesList Webhook Deliverieswebhooks:manageYesHosted
aidelly_list_webhooksList Webhookswebhooks:manageYesHosted

Calling tools from an AI conversation

Tools are called implicitly when you instruct the AI. Examples:

"Post this caption to my Instagram and LinkedIn now."

"Schedule the post below for Friday at 9am Pacific."

"Show me my last 5 posts and their engagement."

"List the drafts waiting for approval."

The AI selects the appropriate tool and calls it with the right parameters based on your instruction.