Aidelly Docs
MCP

Tool Reference

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

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

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

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.