Skip to main content
The Aident MCP Server exposes 22 tools across 6 categories. All tools are accessible through any MCP-compatible client after setup.

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.

Skills & Discovery Tools

Search skills and integrations by query. Supports keyword, semantic, and hybrid search modes.
ParameterTypeRequiredDescription
querystringYes (min 2)Search query — supports *, -, "phrases", | operators
typesstring[]NoFilter by type: integration, skill
scopeobjectNoScope filtering: { integrationId?, category? }
modestringNoSearch mode: keyword, semantic, or hybrid (default: hybrid)
limitnumberNoMax results, 1-50 (default: 20)

skill_list

List available skills with pagination.
ParameterTypeRequiredDescription
limitnumberNoMax results (default: 20)
offsetnumberNoPagination offset

skill_get_info

Get detailed skill metadata including input/output schemas and required integrations.
ParameterTypeRequiredDescription
skillNamestringYesName of the skill

skill_execute

Execute a skill with validated input. If required integrations are missing, returns connection instructions.
ParameterTypeRequiredDescription
skillNamestringYesName of the skill to execute
inputobjectYesInput data matching the skill’s schema

Integration Tools

integration_status

Check which third-party integrations are connected to your account.
ParameterTypeRequiredDescription
integrationIdsstring[]NoSpecific 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.
ParameterTypeRequiredDescription
integrationIdstringYesID of the integration to connect
confirmedbooleanNoConfirm credit usage for first-party integrations
credentialsRecord<string, string>NoUser-provided credentials (API keys, tokens, etc.)

Playbook Tools

playbook_list

List your playbooks with status and trigger info.
ParameterTypeRequiredDescription
limitnumberNoMax results (default: 20)
offsetnumberNoPagination offset

playbook_get_info

Get playbook details including content and trigger configuration.
ParameterTypeRequiredDescription
playbookIdstringYesPlaybook editor session ID

playbook_generate

Generate a new playbook from a natural language description.
ParameterTypeRequiredDescription
promptstringYesDescription of the playbook to generate (min 10 chars)

playbook_execute

Execute a playbook. Returns an execution session ID for tracking.
ParameterTypeRequiredDescription
playbookIdstringYesPlaybook editor session ID
inputobjectNoOptional input data for the playbook

playbook_update_trigger

Enable or disable a playbook’s trigger.
ParameterTypeRequiredDescription
playbookIdstringYesPlaybook editor session ID
enabledbooleanYesWhether to enable or disable the trigger

playbook_execution_history

Get execution history for a specific playbook.
ParameterTypeRequiredDescription
playbookIdstringYesPlaybook editor session ID
limitnumberNoMax results (default: 10)

Template Tools

Search for playbook templates by keyword or category.
ParameterTypeRequiredDescription
querystringNoSearch query
categorystringNoFilter by category

template_list

List available templates with optional category filtering.
ParameterTypeRequiredDescription
categorystringNoFilter by category
limitnumberNoMax results (default: 20)
offsetnumberNoPagination offset

template_get_info

Get detailed template information including description and required integrations.
ParameterTypeRequiredDescription
templateIdstringYesTemplate ID

template_instantiate

Create a new playbook from a template.
ParameterTypeRequiredDescription
templateIdstringYesTemplate ID
namestringNoCustom name for the new playbook

Dashboard Tools

dashboard_active_playbooks

List playbooks with active triggers or running executions. No input required.

execution_get_details

Get execution details including status, messages, and results.
ParameterTypeRequiredDescription
executionIdstringYesExecution session ID

execution_list

List recent executions across all playbooks.
ParameterTypeRequiredDescription
limitnumberNoMax results (default: 20)
offsetnumberNoPagination offset

execution_get_messages

Get simplified chat messages for a running or completed execution. Useful for polling progress.
ParameterTypeRequiredDescription
sessionIdstringYesSession ID to get messages for

Scopes

Tools are organized into permission scopes. Access is granted during OAuth authorization:
ScopeTools
skillscapability_search, skill_list, skill_get_info, skill_execute
integrationsintegration_status, integration_connect
playbooksplaybook_list, playbook_get_info, playbook_generate, playbook_execute, playbook_update_trigger, playbook_execution_history
templatestemplate_search, template_list, template_get_info, template_instantiate
dashboarddashboard_active_playbooks, execution_get_details, execution_list, execution_get_messages
Auth tools (auth_status, auth_logout) are always accessible regardless of scopes.