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 }, tries dotted names as integration Actions first, and falls back to a Skill only when the integration Action is not found and a Skill exists with the same full dotted name. Integration execution errors return the Action error payload and do not fall back to Skills. Plain 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.| 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 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Exact integration ID (e.g., gmail_tools) or capability 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 |
- 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.| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | Yes | status, connect, or disconnect |
integrationId | string | No | Specific integration ID. Required for connect and disconnect |
confirmed | boolean | No | Confirm credit usage for first-party integrations |
credentials | Record<string, string> | No | User-provided credentials (API keys, tokens, etc.) |
Playbook Tools
playbooks_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 |
playbooks_get
Get playbook details including content and trigger configuration.| Parameter | Type | Required | Description |
|---|---|---|---|
playbookId | string | Yes | Playbook editor session ID |
playbooks_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) |
playbooks_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 |
playbooks_trigger_activate
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 |
playbooks_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 Tools
templates_search
Search for playbook templates by keyword or category.| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search query |
category | string | No | Filter by category |
templates_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 |
templates_get
Get detailed template information including description and required integrations.| Parameter | Type | Required | Description |
|---|---|---|---|
templateId | string | Yes | Template ID |
templates_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 Tools
dashboard_overview
List playbooks with active triggers or running executions. No input required.executions_get
Get execution details including status, messages, and results.| Parameter | Type | Required | Description |
|---|---|---|---|
executionId | string | Yes | Execution session ID |
executions_list
List recent executions across all playbooks.| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max results (default: 20) |
offset | number | No | Pagination offset |
executions_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 |
Scopes
Tools are organized into permission scopes. Access is granted during OAuth authorization:| Scope | Tools |
|---|---|
capabilities:search | capabilities_search |
capabilities:read | capabilities_get |
capabilities:execute | capabilities_execute |
integrations:read | vault status, capabilities_integration_list |
integrations:connect | vault connect, vault disconnect |
playbooks:read | playbooks_list, playbooks_get, playbooks_history |
playbooks:create | playbooks_generate |
playbooks:execute | playbooks_execute |
playbooks:manage | playbooks_trigger_activate |
templates:read | templates_search, templates_list, templates_get |
templates:use | templates_instantiate |
dashboard:read | dashboard_overview, executions_get, executions_list, executions_messages |
sandbox:read, sandbox:execute | Used by sandbox-capable tools |
auth tool is always accessible regardless of scopes.