Auth Tools
auth_status
Check your current authentication status. Always accessible, even without scopes. No input required.auth_logout
Revoke your access token and log out. Use this to switch accounts — reconnect after logout to sign in with a different account. No input required.Capabilities, Skills & Discovery
Capability execution contract
Design PRD: Actions & Skills Naming Alignment Phase 4.capabilities_execute is the execution tool. It accepts { name, input }; integration Actions must use ${integration_type}:${integration_name}:${action_name} names such as composio:gmail_tools:gmail_send_email. Legacy dotted or typed-dot action refs are rejected with typed-format guidance. Plain authored Skill names route directly through Skill execution.
Integration Actions return the Action output directly without durationMs or executionTimeMs. Skill execution returns { success, output?, error?, executionTimeMs }.
capabilities_search
Search capabilities by query, including Actions, Skills, and integrations. Supports keyword, semantic, and hybrid search modes.capabilities_get
Look up details for a known integration or capability by exact name. By default onlydescription is returned; request additional parts as needed.
MCP exposes this as capabilities_get; internally it delegates to the capability runtime’s capability_read_details tool.
capabilities_execute
Execute a capability by name. Accepts either a skill name (e.g.,send_email_skill) or a typed integration action in ${integration_type}:${integration_name}:${action_name} form (e.g., composio:gmail_tools:gmail_send_email). If required integrations are missing, returns connection instructions.
Response shape:
- Skills return
{ success, output?, error?, executionTimeMs }. - Integration Actions return the Action output directly. This shape omits
durationMsandexecutionTimeMs.
Vault Tool
vault
Check, connect, or disconnect third-party integrations through Aident Vault.Playbook Tools
playbooks_list
List your playbooks with status and trigger info.playbooks_get
Get playbook details including content and trigger configuration.playbooks_generate
Generate a new playbook from a natural language description.playbooks_execute
Execute a playbook. Returns an execution session ID for tracking.playbooks_trigger_activate
Enable or disable a playbook’s trigger.playbooks_history
Get execution history for a specific playbook.Template Tools
templates_search
Search for playbook templates by keyword or category.templates_list
List available templates with optional category filtering.templates_get
Get detailed template information including description and required integrations.templates_instantiate
Create a new playbook from a template.Dashboard Tools
dashboard_overview
List playbooks with active triggers or running executions. No input required.executions_get
Get execution details including status, messages, and results.executions_list
List recent executions across all playbooks.executions_messages
Get simplified chat messages for a running or completed execution. Useful for polling progress.Scopes
Tools are organized into permission scopes. Access is granted during OAuth authorization:
The
auth tool is always accessible regardless of scopes.