Documentation Index
Fetch the complete documentation index at: https://docs.aident.ai/llms.txt
Use this file to discover all available pages before exploring further.
The Aident MCP Server exposes the full suite of Aident tools across auth, capabilities, skills, integrations, playbooks, templates, and dashboard. All tools are accessible through any MCP-compatible client after setup.
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
capabilities_search
Search skills and integrations by query. Supports keyword, semantic, and hybrid search modes.
| Parameter | Type | Required | Description |
|---|
query | string | Yes (min 2) | Search query — supports *, -, "phrases", | operators |
types | string[] | No | Filter by type: integration, skill |
scope | object | No | Scope filtering: { integrationId?, category? } |
mode | string | No | Search mode: keyword, semantic, or hybrid (default: hybrid) |
limit | number | No | Max results, 1-50 (default: 20) |
capabilities_get
Look up details for a known integration or skill by exact name. By default only description is returned; request additional parts as needed.
| Parameter | Type | Required | Description |
|---|
name | string | Yes | Exact integration ID (e.g., gmail_tools) or skill name (e.g., gmail.send_email) |
parts | string[] | No | Sections to include. Integration: description, agentFriendlyInstructions, availableSkills. Skill: description, inputSchema, outputSchema, sourceCode |
capabilities_execute
Execute a capability by name. Accepts either a skill name (e.g., send_email_skill) or an integration action in integrationId.ACTION_NAME form (e.g., gmail_tools.send_email). If required integrations are missing, returns connection instructions.
| Parameter | Type | Required | Description |
|---|
name | string | Yes | Capability name — skill name or integrationId.ACTION_NAME |
input | object | No | Input data matching the capability’s schema |
skill_list
List available skills with pagination.
| Parameter | Type | Required | Description |
|---|
limit | number | No | Max results (default: 20) |
offset | number | No | Pagination offset |
skill_get_info
Get detailed skill metadata including input/output schemas and required integrations.
| Parameter | Type | Required | Description |
|---|
skillName | string | Yes | Name of the skill |
skill_execute
Execute a skill with validated input. If required integrations are missing, returns connection instructions.
| Parameter | Type | Required | Description |
|---|
skillName | string | Yes | Name of the skill to execute |
input | object | Yes | Input data matching the skill’s schema |
integration_status
Check which third-party integrations are connected to your account.
| Parameter | Type | Required | Description |
|---|
integrationIds | string[] | No | Specific integration IDs to check |
integration_connect
Initiate or complete connection to a third-party service. Returns a URL, form fields, or confirms connection depending on integration type.
| Parameter | Type | Required | Description |
|---|
integrationId | string | Yes | ID of the integration to connect |
confirmed | boolean | No | Confirm credit usage for first-party integrations |
credentials | Record<string, string> | No | User-provided credentials (API keys, tokens, etc.) |
playbook_list
List your playbooks with status and trigger info.
| Parameter | Type | Required | Description |
|---|
limit | number | No | Max results (default: 20) |
offset | number | No | Pagination offset |
playbook_get_info
Get playbook details including content and trigger configuration.
| Parameter | Type | Required | Description |
|---|
playbookId | string | Yes | Playbook editor session ID |
playbook_generate
Generate a new playbook from a natural language description.
| Parameter | Type | Required | Description |
|---|
prompt | string | Yes | Description of the playbook to generate (min 10 chars) |
playbook_execute
Execute a playbook. Returns an execution session ID for tracking.
| Parameter | Type | Required | Description |
|---|
playbookId | string | Yes | Playbook editor session ID |
input | object | No | Optional input data for the playbook |
playbook_update_trigger
Enable or disable a playbook’s trigger.
| Parameter | Type | Required | Description |
|---|
playbookId | string | Yes | Playbook editor session ID |
enabled | boolean | Yes | Whether to enable or disable the trigger |
playbook_execution_history
Get execution history for a specific playbook.
| Parameter | Type | Required | Description |
|---|
playbookId | string | Yes | Playbook editor session ID |
limit | number | No | Max results (default: 10) |
template_search
Search for playbook templates by keyword or category.
| Parameter | Type | Required | Description |
|---|
query | string | No | Search query |
category | string | No | Filter by category |
template_list
List available templates with optional category filtering.
| Parameter | Type | Required | Description |
|---|
category | string | No | Filter by category |
limit | number | No | Max results (default: 20) |
offset | number | No | Pagination offset |
template_get_info
Get detailed template information including description and required integrations.
| Parameter | Type | Required | Description |
|---|
templateId | string | Yes | Template ID |
template_instantiate
Create a new playbook from a template.
| Parameter | Type | Required | Description |
|---|
templateId | string | Yes | Template ID |
name | string | No | Custom name for the new playbook |
dashboard_overview
List playbooks with active triggers or running executions.
No input required.
execution_get_details
Get execution details including status, messages, and results.
| Parameter | Type | Required | Description |
|---|
executionId | string | Yes | Execution session ID |
execution_list
List recent executions across all playbooks.
| Parameter | Type | Required | Description |
|---|
limit | number | No | Max results (default: 20) |
offset | number | No | Pagination offset |
execution_get_messages
Get simplified chat messages for a running or completed execution. Useful for polling progress.
| Parameter | Type | Required | Description |
|---|
sessionId | string | Yes | Session ID to get messages for |
| Scope | Tools |
|---|
skills | capabilities_search, capabilities_get, capabilities_execute, skill_list, skill_get_info, skill_execute |
integrations | integration_status, integration_connect |
playbooks | playbook_list, playbook_get_info, playbook_generate, playbook_execute, playbook_update_trigger, playbook_execution_history |
templates | template_search, template_list, template_get_info, template_instantiate |
dashboard | dashboard_overview, execution_get_details, execution_list, execution_get_messages |
sandbox | Used by sandbox-capable tools (sandbox:read, sandbox:execute) |
auth_status, auth_logout) are always accessible regardless of scopes.
