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.

Skill Tools

Search skills by query using hybrid semantic + keyword search.
ParameterTypeRequiredDescription
querystringNoSearch query
tagsstring[]NoFilter by tags
typestringNoFilter by skill type (atomic or composite)
limitnumberNoMax results (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 connection to a third-party service. Returns a URL or form fields for authentication.
ParameterTypeRequiredDescription
integrationIdstringYesID of the integration to connect

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
skillsskill_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.