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:
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/listTools
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 seeaidelly_create_media_upload_url(they upload withaidelly_upload_media) or the Brain document upload pairaidelly_create_brain_document_upload_url/aidelly_complete_brain_document_upload(they add documents withaidelly_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
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_bulk_create_posts | Bulk Create Posts | posts:write | No | Hosted |
aidelly_cancel_post | Cancel Post | posts:write | No | Hosted |
aidelly_cancel_scheduled_post | Cancel Scheduled Post | posts:write | No | Hosted |
aidelly_create_draft | Create Draft | drafts:write | No | Hosted, ChatGPT |
aidelly_create_post | Create Post | posts:write | No | Hosted |
aidelly_create_scheduled_post | Create Scheduled Post | posts:write | No | Hosted |
aidelly_delete_draft | Delete Draft | drafts:write | No | Hosted |
aidelly_get_draft | Get Draft | drafts:read | Yes | Hosted, ChatGPT |
aidelly_get_post | Get Post | posts:read | Yes | Hosted |
aidelly_get_scheduled_post | Get Scheduled Post | posts:read | Yes | Hosted |
aidelly_get_usage | Get Usage | posts:read | Yes | Hosted |
aidelly_list_drafts | List Drafts | drafts:read | Yes | Hosted |
aidelly_list_posts | List Posts | posts:read | Yes | Hosted, ChatGPT |
aidelly_list_scheduled_posts | List Scheduled Posts | posts:read | Yes | Hosted, ChatGPT |
aidelly_list_workspaces | List Workspaces | workspaces:read | Yes | Hosted, ChatGPT |
aidelly_update_draft | Update Draft | drafts:write | No | Hosted |
aidelly_update_post | Update Post | posts:write | No | Hosted |
aidelly_update_scheduled_post | Update Scheduled Post | posts:write | No | Hosted |
Approvals and client review
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_action_post_approval | Action Post Approval | approvals:write | No | REST and stdio only |
aidelly_create_client_review_link | Create Client Review Link | approvals:write | No | Hosted |
aidelly_get_approval_batch | Get Approval Batch | approvals:read | Yes | Hosted |
aidelly_get_approvals | Get Approvals | approvals:read | Yes | Hosted, ChatGPT |
aidelly_list_client_review_links | List Client Review Links | approvals:read | Yes | Hosted |
aidelly_list_pending_approvals | List Pending Approvals | approvals:read | Yes | Hosted, ChatGPT |
aidelly_list_post_approval_events | List Post Approval Events | approvals:read | Yes | Hosted |
aidelly_review_approval_batch | Approve, Reject, or Schedule Content Batch | approvals:write | No | REST and stdio only |
aidelly_review_approval_items | Review or Edit Selected Content Items | approvals:write | No | REST and stdio only |
aidelly_revoke_client_review_link | Revoke Client Review Link | approvals:write | No | Hosted |
Calendar, queues and destination presets
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_add_queue_items | Add Queue Items | queues:write | No | Hosted |
aidelly_create_bulk_fill_job | Create Bulk Fill Job | calendar:write | No | Hosted |
aidelly_create_destination_preset | Create Destination Preset | destination-presets:write | No | Hosted |
aidelly_create_queue | Create Queue | queues:write | No | Hosted |
aidelly_delete_calendar_event | Delete Calendar Event | calendar:write | No | Hosted |
aidelly_delete_calendar_share_link | Delete Calendar Share Link | calendar:write | No | Hosted |
aidelly_delete_campaign | Delete Campaign | queues:write | No | Hosted |
aidelly_get_bulk_fill_job | Get Bulk Fill Job | calendar:read | Yes | Hosted |
aidelly_get_calendar_events | Get Calendar Events | calendar:read | Yes | Hosted |
aidelly_list_destination_presets | List Destination Presets | destination-presets:read | Yes | Hosted |
aidelly_list_queues | List Queues | queues:read | Yes | Hosted |
aidelly_preview_destination_preset | Preview Destination Preset | destination-presets:read | No | Hosted |
aidelly_update_calendar_event | Update Calendar Event | calendar:write | No | Hosted |
Media
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_media_upload_url | Create Media Upload Url | media:write | No | Hosted, except browser clients |
aidelly_create_photo | Create Photo | photos:write | No | Hosted |
aidelly_list_image_editor_outputs | List Image Editor Outputs | image_editor:read | Yes | Hosted |
aidelly_upload_media | Upload Media | media:write | No | Hosted |
Social accounts and connect links
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_connect_link | Create Connect Link | connect_links:write | No | Hosted |
aidelly_list_accounts | List Accounts | connections:read | Yes | Hosted |
aidelly_list_connect_link_connections | List Connect Link Connections | connect_links:read | Yes | Hosted |
aidelly_list_connect_links | List Connect Links | connect_links:read | Yes | Hosted |
aidelly_list_connection_attempts | List Connection Attempts | connections:read | Yes | Hosted |
aidelly_list_pinterest_boards | List Pinterest Boards | connections:read | Yes | Hosted |
aidelly_list_social_connections | List Social Connections | connections:read | Yes | Hosted, ChatGPT |
aidelly_revoke_connect_link | Revoke Connect Link | connect_links:write | No | Hosted |
aidelly_update_connect_link | Update Connect Link | connect_links:write | No | Hosted |
Analytics and reports
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_report | Create Report | reports:write | No | Hosted |
aidelly_create_report_link | Create Report Link | reports:write | No | Hosted |
aidelly_create_report_schedule | Create Report Schedule | reports:write | No | Hosted |
aidelly_delete_report_schedule | Delete Report Schedule | reports:write | No | Hosted |
aidelly_generate_analytics_insights | Generate Social Analytics Insights | analytics:write | No | Hosted |
aidelly_get_analytics_insights | Get Analytics Insights | analytics:read | Yes | Hosted, ChatGPT |
aidelly_get_analytics_summary | Get Analytics Summary | analytics:read | Yes | Hosted, ChatGPT |
aidelly_get_analytics_unified | Get Analytics Unified | analytics:read | Yes | Hosted |
aidelly_get_post_analytics | Get Post Analytics | analytics:read | Yes | Hosted |
aidelly_get_report | Get Report | reports:read | Yes | Hosted |
aidelly_get_report_schedule | Get Report Schedule | reports:read | Yes | Hosted |
aidelly_list_report_links | List Report Links | reports:read | Yes | Hosted |
aidelly_list_report_schedules | List Report Schedules | reports:read | Yes | Hosted |
aidelly_list_reports | List Reports | reports:read | Yes | Hosted |
aidelly_revoke_report_link | Revoke Report Link | reports:write | No | Hosted |
aidelly_update_analytics_insight | Update Analytics Insight | analytics:write | No | Hosted |
aidelly_update_report_schedule | Update Report Schedule | reports:write | No | Hosted |
Inbox, comments and automations
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_content_automation | Create Content Automation | automations:write | No | Hosted |
aidelly_create_inbox_automation | Create Inbox Automation | inbox:write | No | Hosted |
aidelly_create_post_comment | Create Post Comment | comments:write | No | Hosted |
aidelly_delete_content_automation | Delete Content Automation | automations:write | No | Hosted |
aidelly_delete_inbox_automation | Delete Inbox Automation | inbox:write | No | Hosted |
aidelly_delete_post_comment | Delete Post Comment | comments:write | No | Hosted |
aidelly_generate_inbox_reply_draft | Generate Inbox Reply Draft | inbox:write | No | Hosted |
aidelly_get_content_automation | Get Content Automation | automations:read | Yes | Hosted |
aidelly_get_content_automations | Get Content Automations | automations:read | Yes | Hosted |
aidelly_get_inbox_automations | Get Inbox Automations | inbox:read | Yes | Hosted |
aidelly_get_inbox_items | Get Inbox Items | inbox:read | Yes | Hosted |
aidelly_get_inbox_lead | Get Inbox Lead | inbox:read | Yes | Hosted |
aidelly_list_inbox_leads | List Inbox Leads | inbox:read | Yes | Hosted |
aidelly_list_post_comments | List Post Comments | comments:read | Yes | Hosted |
aidelly_reply_to_inbox_item | Reply To Inbox Item | inbox:write | No | Hosted |
aidelly_trigger_content_automation | Trigger Content Automation | automations:write | No | Hosted |
aidelly_update_content_automation | Update Content Automation Rule | automations:write | No | Hosted |
aidelly_update_inbox_automation | Update Inbox Automation | inbox:write | No | Hosted |
aidelly_update_post_comment | Update Post Comment | comments:write | No | Hosted |
Workspaces, team and white-label
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_workspace | Create Workspace | workspaces:write | No | Hosted |
aidelly_delete_workspace | Delete Workspace | workspaces:write | No | Hosted |
aidelly_get_agency_overview | Get Agency Overview | workspaces:read | Yes | Hosted |
aidelly_get_ai_credit_balance | Get Ai Credit Balance | credits:read | Yes | Hosted |
aidelly_get_approval_settings | Get Approval Settings | workspaces:read | Yes | Hosted |
aidelly_get_white_label_config | Get White Label Config | white-label:read | Yes | Hosted |
aidelly_get_workspace | Get Workspace | workspaces:read | Yes | Hosted |
aidelly_invite_workspace_member | Invite Workspace Member | team:write | No | Hosted |
aidelly_list_activity | List Activity | activity:read | Yes | Hosted |
aidelly_list_workspace_members | List Workspace Members | team:read | Yes | Hosted |
aidelly_remove_workspace_member | Remove Workspace Member | team:write | No | Hosted |
aidelly_revoke_workspace_invitation | Revoke Workspace Invitation | team:write | No | Hosted |
aidelly_update_approval_settings | Update Approval Settings | workspaces:write | No | Hosted |
aidelly_update_white_label_config | Update White Label Config | white-label:write | No | Hosted |
aidelly_update_workspace | Update Workspace | workspaces:write | No | Hosted |
aidelly_update_workspace_member | Update Workspace Member | team:write | No | Hosted |
Brand, ideas and content research
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_add_brain_document | Add Brain Document | brand:write | No | Hosted, ChatGPT |
aidelly_add_brain_entry | Add Brain Entry | brand:write | No | Hosted, ChatGPT |
aidelly_add_competitor | Add Competitor | competitors:write | No | Hosted |
aidelly_add_creator | Add Creator | creators:write | No | Hosted |
aidelly_archive_brain_entry | Archive Brain Entry | brand:write | No | Hosted, ChatGPT |
aidelly_complete_brain_document_upload | Complete Brain Document Upload | brand:write | No | Hosted, except browser clients |
aidelly_create_brain_document_upload_url | Create Brain Document Upload Url | brand:write | No | Hosted, except browser clients |
aidelly_create_idea | Create Idea | ideas:write | No | Hosted |
aidelly_create_repurpose_job | Create Repurpose Job | repurpose:write | No | Hosted |
aidelly_delete_brain_document | Delete Brain Document | brand:write | No | Hosted |
aidelly_generate_brand_interview_questions | Generate Brand Interview Questions | ideas:write | No | Hosted |
aidelly_get_brain_context | Get Brain Context | brand:read | Yes | Hosted, ChatGPT |
aidelly_get_brain_document | Get Brain Document | brand:read | Yes | Hosted, ChatGPT |
aidelly_get_brain_entry | Get Brain Entry | brand:read | Yes | Hosted, ChatGPT |
aidelly_get_brand_profile | Get Brand Profile | brand:read | Yes | Hosted, ChatGPT |
aidelly_get_brand_settings_context | Get Brand Settings Context | brand:read | Yes | Hosted |
aidelly_get_repurpose_job | Get Repurpose Job | repurpose:read | Yes | Hosted |
aidelly_list_brain_documents | List Brain Documents | brand:read | Yes | Hosted, ChatGPT |
aidelly_list_brain_entries | List Brain Entries | brand:read | Yes | Hosted, ChatGPT |
aidelly_list_competitors | List Competitors | competitors:read | Yes | Hosted |
aidelly_list_creators | List Creators | creators:read | Yes | Hosted |
aidelly_list_ideas | List Ideas | ideas:read | Yes | Hosted |
aidelly_list_prompts | List Prompts | prompts:read | Yes | Hosted |
aidelly_list_repurpose_jobs | List Repurpose Jobs | repurpose:read | Yes | Hosted |
aidelly_list_viral_trends | List Viral Trends | viral_trends:read | Yes | Hosted |
aidelly_run_prompt | Run Prompt | prompts:write | No | Hosted |
aidelly_search_brain | Search Brain | brand:read | Yes | Hosted, ChatGPT |
aidelly_update_brain_entry | Update Brain Entry | brand:write | No | Hosted, ChatGPT |
aidelly_update_brand_profile | Update Brand Profile | brand:write | No | Hosted |
E-commerce
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_connect_ecommerce_store | Connect Ecommerce Store | ecommerce:write | No | REST and stdio only |
aidelly_disconnect_ecommerce_store | Disconnect Ecommerce Store | ecommerce:write | No | Hosted |
aidelly_get_ecommerce_store | Get Ecommerce Store | ecommerce:read | Yes | Hosted |
aidelly_list_ecommerce_products | List Ecommerce Products | ecommerce:read | Yes | Hosted |
aidelly_list_ecommerce_stores | List Ecommerce Stores | ecommerce:read | Yes | Hosted |
aidelly_sync_ecommerce_store | Sync Ecommerce Store | ecommerce:write | No | Hosted |
Short links and link-in-bio
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_short_link | Create Short Link | links:write | No | Hosted |
aidelly_delete_short_link | Delete Short Link | links:write | No | Hosted |
aidelly_get_bio_page | Get Bio Page | bio:read | Yes | Hosted |
aidelly_list_short_links | List Short Links | links:read | Yes | Hosted |
Tasks
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_task | Create Task | tasks:write | No | Hosted |
aidelly_delete_task | Delete Task | tasks:write | No | Hosted |
aidelly_get_task | Get Task | tasks:read | Yes | Hosted |
aidelly_list_tasks | List Tasks | tasks:read | Yes | Hosted |
aidelly_update_task | Update Task | tasks:write | No | Hosted |
Webhooks
| Tool | Title | Scope | Read-only | Available on |
|---|---|---|---|---|
aidelly_create_webhook | Create Webhook | webhooks:manage | No | Hosted |
aidelly_delete_webhook | Delete Webhook | webhooks:manage | No | Hosted |
aidelly_list_webhook_deliveries | List Webhook Deliveries | webhooks:manage | Yes | Hosted |
aidelly_list_webhooks | List Webhooks | webhooks:manage | Yes | Hosted |
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.