Aidelly Docs
MCP

Tool Reference

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

The Aidelly MCP server exposes 120 tools covering full /api/public/v1 coverage. Tool names follow the pattern aidelly_<method>_<resource>.

Heads up: the May 2026 feature drop (destination presets, automation queues, post signatures, content campaigns, expanded auto-post sources) is live in the dashboard and on the internal API. The public v1 surface + matching MCP tools roll out next release — see Recently added for the reserved tool names.

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

Tool categories

Posts

ToolDescription
aidelly_create_postCreate and publish or schedule a post
aidelly_get_postsList posts with filters (status, platform, date range)
aidelly_get_postFetch a single post by ID
aidelly_patch_posts_idUpdate a post (content, schedule time, status)
aidelly_post_posts_id_cancelCancel a scheduled post
aidelly_bulk_create_postsCreate up to 50 scheduled posts in one call

Approvals

ToolDescription
aidelly_get_approvals_itemsList items pending approval
aidelly_post_approvals_items_actionApprove or reject a draft

Media

ToolDescription
aidelly_upload_mediaUpload media bytes in one step (ChatGPT/MCP)
aidelly_post_media_upload_urlGet a signed URL for direct media upload

Social connections

ToolDescription
aidelly_get_social_connectionsList connected social accounts for a brand

Analytics

ToolDescription
aidelly_get_analyticsFetch post analytics (views, likes, comments, shares)

Brand and workspace

ToolDescription
aidelly_get_brand_settings_contextGet brand settings and context
aidelly_get_workspacesList workspaces
aidelly_get_brandsList brands in a workspace

Content automations

ToolDescription
aidelly_get_content_automationsList content automations
aidelly_put_content_automations_idUpdate a content automation

Webhooks

ToolDescription
aidelly_get_webhooksList webhook subscriptions
aidelly_post_webhooksCreate a webhook subscription
aidelly_delete_webhooks_idDelete a webhook subscription
aidelly_list_webhook_deliveriesList delivery attempts for a webhook — status, retries, dead-lettered events

Usage

ToolDescription
aidelly_get_usageFetch API usage stats for the current period

Analytics Details

ToolDescription
aidelly_get_post_analyticsGet per-post metrics (views, likes, comments, etc.)

Ecommerce

ToolDescription
aidelly_list_ecommerce_storesList connected e-commerce stores
aidelly_create_ecommerce_storeConnect a new e-commerce store
aidelly_get_ecommerce_storeGet store details
aidelly_delete_ecommerce_storeDisconnect an e-commerce store
aidelly_sync_ecommerce_storeSync products from store
aidelly_list_ecommerce_productsList products from connected stores
aidelly_create_ecommerce_productAdd a product to a store

Ideas & Research

ToolDescription
aidelly_create_interview_questionsGenerate brand interview questions
ToolDescription
aidelly_create_connect_linkCreate a shareable link for clients to connect accounts
aidelly_list_connect_linksList active connect links
aidelly_get_connect_linkGet details of a connect link
aidelly_delete_connect_linkRevoke a connect link
aidelly_create_connect_link_connectionRegister a connection from a link
aidelly_list_connect_link_connectionsList connections made via a link
aidelly_delete_connect_link_connectionRemove a connection
ToolDescription
aidelly_create_report_linkCreate a shareable live analytics link
aidelly_list_report_linksList active report links
aidelly_get_report_linkGet details of a report link
aidelly_delete_report_linkRevoke a report link

Destination Presets

ToolDescription
aidelly_list_destination_presetsList account groupings/presets
aidelly_create_destination_presetCreate a named account grouping
aidelly_get_destination_presetGet preset details
aidelly_update_destination_presetUpdate a preset (rename, accounts)
aidelly_get_destination_preset_previewPreview which accounts a preset targets

Queues

ToolDescription
aidelly_list_queuesList content publishing queues
aidelly_get_queue_itemsGet items in a queue

Agency

ToolDescription
aidelly_get_agency_overviewGet agency dashboard across all workspaces
ToolDescription
aidelly_create_client_review_linkCreate a review link for clients to approve posts
aidelly_list_client_review_linksList active client review links
aidelly_get_client_review_linkGet details of a review link
aidelly_delete_client_review_linkRevoke a review link

Inbox Automations

ToolDescription
aidelly_get_inbox_automationsList inbox automations
aidelly_post_inbox_automationsCreate an inbox automation
aidelly_patch_inbox_automations_idUpdate an inbox automation
aidelly_delete_inbox_automations_idDelete an inbox automation

Recently added (May 2026)

These features are live in-app and exposed on the internal API. Public v1 endpoints + matching MCP tools roll out in the next release. The tool names are reserved so your agent code stays forward-compatible.

ToolDescriptionStatus
aidelly_list_destination_presetsList destination presets (saved channel mixes with up to 12 channels)Reserved
aidelly_create_destination_presetCreate a preset with channels + per-channel transformsReserved
aidelly_preview_destination_presetPreview how a sample post looks across preset channelsReserved
aidelly_get_automation_queuesList automation queues (Buffer-style weekly slot grids)Reserved
aidelly_create_automation_queueCreate a queue with slot grid, time zone, recycle rulesReserved
aidelly_add_to_queueDrop a draft into a queue tailReserved
aidelly_get_post_signaturesList workspace + per-platform signaturesReserved
aidelly_put_post_signatureSet or update the workspace-default or per-platform signatureReserved
aidelly_get_campaignsList content campaigns (themed routing groups)Reserved
aidelly_create_campaignCreate a campaign with default channels, queue, route, slots, caption templateReserved
aidelly_assign_campaignAssign a draft or scheduled post to a campaignReserved
aidelly_get_auto_post_sourcesList connected RSS / podcast / newsletter / YouTube sourcesReserved
aidelly_create_auto_post_sourceConnect a new source (one of: rss, podcast, newsletter, youtube)Reserved

When these ship to v1, the tool list at tools/list will surface them automatically — no client update required.

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."

"Approve the pending draft for the Q2 campaign."

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