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
v1surface + 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:
You can also fetch the OpenAPI spec directly:
curl https://app.aidelly.ai/api/public/v1/openapiThe MCP tool list at runtime reflects the same schema:
# Using mcp-cli or any MCP client
mcp tools/listTool categories
Posts
| Tool | Description |
|---|---|
aidelly_create_post | Create and publish or schedule a post |
aidelly_get_posts | List posts with filters (status, platform, date range) |
aidelly_get_post | Fetch a single post by ID |
aidelly_patch_posts_id | Update a post (content, schedule time, status) |
aidelly_post_posts_id_cancel | Cancel a scheduled post |
Approvals
| Tool | Description |
|---|---|
aidelly_get_approvals_items | List items pending approval |
aidelly_post_approvals_items_action | Approve or reject a draft |
Media
| Tool | Description |
|---|---|
aidelly_post_media_upload_url | Get a signed URL for direct media upload |
Social connections
| Tool | Description |
|---|---|
aidelly_get_social_connections | List connected social accounts for a brand |
Analytics
| Tool | Description |
|---|---|
aidelly_get_analytics | Fetch post analytics (views, likes, comments, shares) |
Brand and workspace
| Tool | Description |
|---|---|
aidelly_get_brand_settings_context | Get brand settings and context |
aidelly_get_workspaces | List workspaces |
aidelly_get_brands | List brands in a workspace |
Content automations
| Tool | Description |
|---|---|
aidelly_get_content_automations | List content automations |
aidelly_put_content_automations_id | Update a content automation |
Webhooks
| Tool | Description |
|---|---|
aidelly_get_webhooks | List webhook subscriptions |
aidelly_post_webhooks | Create a webhook subscription |
aidelly_delete_webhooks_id | Delete a webhook subscription |
Usage
| Tool | Description |
|---|---|
aidelly_get_usage | Fetch 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.
| Tool | Description | Status |
|---|---|---|
aidelly_get_crosspost_routes | List crosspost routes (publish fans out to up to 12 destinations) | Reserved |
aidelly_create_crosspost_route | Create a route with source + up to 12 destinations | Reserved |
aidelly_dry_run_crosspost_route | Preview which destinations a sample publish would hit | Reserved |
aidelly_get_automation_queues | List automation queues (Buffer-style weekly slot grids) | Reserved |
aidelly_create_automation_queue | Create a queue with slot grid, time zone, recycle rules | Reserved |
aidelly_add_to_queue | Drop a draft into a queue tail | Reserved |
aidelly_get_post_signatures | List workspace + per-platform signatures | Reserved |
aidelly_put_post_signature | Set or update the workspace-default or per-platform signature | Reserved |
aidelly_get_campaigns | List content campaigns (themed routing groups) | Reserved |
aidelly_create_campaign | Create a campaign with default channels, queue, route, slots, caption template | Reserved |
aidelly_assign_campaign | Assign a draft or scheduled post to a campaign | Reserved |
aidelly_get_auto_post_sources | List connected RSS / podcast / newsletter / YouTube sources | Reserved |
aidelly_create_auto_post_source | Connect 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.