Aidelly Docs
MCP

Tool Reference

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

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

Heads up: the May 2026 feature drop (crosspost routes, 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

Approvals

ToolDescription
aidelly_get_approvals_itemsList items pending approval
aidelly_post_approvals_items_actionApprove or reject a draft

Media

ToolDescription
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

Usage

ToolDescription
aidelly_get_usageFetch API usage stats for the current period

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_get_crosspost_routesList crosspost routes (publish fans out to up to 12 destinations)Reserved
aidelly_create_crosspost_routeCreate a route with source + up to 12 destinationsReserved
aidelly_dry_run_crosspost_routePreview which destinations a sample publish would hitReserved
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.