Free cookie consent management tool by TermsFeed

Make Design Objects Available as MCP Tools

On This Page

This page describes how to make new or existing Appian design objects available to external AI applications through the Appian MCP Server.

Developers control which design objects are available to external AI applications. Appian MCP Server provides a fixed set of system tools that automatically discover enabled design objects and generate tool schemas from their configuration.

Each design object must be individually enabled before it appears in tool search. The enablement process differs by design object type:

Object security controls who can access each tool. If the authenticated identity has the required permissions for a design object, the AI application can discover and invoke it.

Supported design objects

The following design objects can be made available to Appian MCP Server:

  • AI agents: External AI applications can invoke Appian AI agents with a prompt and receive responses.
  • Business processes: External AI applications can query and analyze process data, and build reports from datasets in Process HQ.
  • Expression rules: External AI applications can evaluate expression rules with provided inputs.
  • Process models: External AI applications can start process models and check execution status.
  • Record types: External AI applications can read and query data from synced record types. Record types that use direct data access or have a record-level security expression cannot be queried by external systems or agents.

Enable process models, expression rules, and AI agents as MCP tools

Review the design considerations for process models, expression rules, or AI agents before enabling them as MCP tools.

To make a process model, expression rule, or AI agent available as an MCP tool:

  1. Open the design object in Appian Designer.
  2. Open the object's properties dialog.
  3. Select Enable MCP Server Access.
  4. Review the Description field to ensure it clearly explains what the object does and when to use it. For guidance, see Write Effective MCP Tool Descriptions.
  5. Click OK.
  6. Give the authenticating account the necessary permissions to interact with each object:
    • At least Viewer permission for expression rules or AI agents.
    • At least Initiator permission for process models.

When you're ready to promote your changes, see Deploy MCP Tool Configurations.

Process model design considerations

When you enable a process model as an MCP tool, process variables marked as inputs become tool parameters. The AI application provides values for these parameters when invoking the tool.

Caution:  Process models with start forms or synchronous user input tasks cannot complete through MCP. The tool call stalls until the process times out. A warning appears in the properties dialog when you enable a process model that contains these elements.

  • Remove start form dependencies. Process models invoked through MCP cannot present forms to users. Remove start forms or create a separate version for MCP invocation.
  • Avoid synchronous user input tasks. Activities that wait for user input (such as attended tasks) block execution indefinitely through MCP.
  • Keep execution time reasonable. Long-running process models may time out before completion. Design MCP-invoked process models to complete without manual intervention.
  • Complex input types: When a process model accepts inputs that use record types or custom data types (CDTs), Appian MCP Server automatically sends the full nested schema to the AI application.

Expression rule design considerations

When you enable an expression rule as an MCP tool, the rule's input parameters become tool parameters. The AI application provides values for these parameters when invoking the tool.

  • Security behavior: If the expression rule queries objects the authenticated user lacks access to, the rule succeeds but returns null for inaccessible data. This behavior is consistent with standard platform behavior.
  • Timeout: Expression rules must complete within the execution timeout. Design rules that perform heavy computation or large data queries to complete efficiently.
  • Use cases: Expression rules work well as MCP tools for business logic, calculations, data transformations, and lookups.
  • Complex input types: When an expression rule accepts inputs that use record types or custom data types (CDTs), Appian MCP Server automatically sends the full nested schema to the AI application.

AI agent design considerations

When you enable an AI agent as an MCP tool, external AI applications send a prompt to the AI agent and receive the response.

  • Permission requirement: The authenticated user must have permission to view the AI agent and all of its underlying tools.
  • Single-turn interaction: MCP invocations are single-turn. The external AI application sends one prompt and receives one response. Multi-turn conversations are not supported through MCP.
  • Context limitations: The AI agent receives only the prompt provided by the external AI application. Context from the user's conversation in the external AI application is not automatically passed to the Appian AI agent.

Enable record types as MCP tools

To use a synced record type with Appian MCP Server, you must publish it for analytics and AI. Published record types are available to external AI applications through the data fabric MCP tools, which identify each record type by its SQL reference name.

Note:  Publishing a record type for analytics and AI also makes the record type available as a dataset in Process HQ and to the data fabric chatbot.

If you generated record types, those record types are published for analytics and AI by default. For all other record types, you must publish them manually using one of the following methods.

If you need to publish multiple record types at once, publish from Process HQ. If you need to publish a single record type or edit its SQL reference name, publish from the record type.

Publish multiple record types from Process HQ

Process HQ lets you publish multiple record types at once from the Data Governance page. Any configurations you make in Process HQ take precedence over individual record type configurations set in Appian Designer.

To access the Data Governance page in Process HQ, you must be in the Data Governors system group.

To publish record types from Process HQ:

  1. In Process HQ, go to the Data Governance page. By default, all synced and unsynced record types in your environment appear.
  2. Select the checkbox for each synced record type you want to publish.
  3. Click PUBLISH FOR ANALYTICS & AI.
  4. In each published record type, give the authenticating account at least Viewer permission. Access to specific records and fields is further controlled through record-level and field-level security.

Publish a single record type

Publishing from a record type lets you publish one record type at a time and view or edit the SQL reference name that data fabric MCP tools use to identify it.

To publish a record type from the record type object:

  1. In Appian Designer, open the record type.
  2. Go to Workspaces.
  3. Select the Publish for Analytics & AI checkbox.

    Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to closeimages/record-type-workspace-settings-page.png

  4. Give the authenticating account at least Viewer permission to the record type. Access to specific records and fields is further controlled through record-level and field-level security.
  5. Click SAVE.

View or edit the SQL reference name

The data fabric MCP tools use a record type's SQL reference name to identify and query data. Appian generates a SQL reference name for each synced record type by default. You can view the current name or update it to a different unique name.

To view or edit the SQL reference name for a synced record type:

  1. In Appian Designer, open the record type.
  2. Click Settings > Properties.
  3. In the SQL Reference Name field, enter a new name. SQL reference names must be unique across the environment.
  4. (Optional) Review the Description field to ensure it clearly explains what the object does and when to use it. For guidance, see Write Effective MCP Tool Descriptions.
  5. Click SAVE CHANGES to close the properties.
  6. Click SAVE to save the record type settings.

For details on how record type configurations deploy between environments, including SQL reference name conflicts, see Deploy MCP Tool Configurations.

Access business process data through MCP

Business processes are available to external AI applications through Process HQ when the Analyze Business Processes tool collection is enabled. Unlike other design objects, business processes do not require per-object enablement.

Access to business process data is controlled through business process object security or through process-level access in Process HQ. The authenticated user or service account must have access to a process to query its data through MCP.

Feedback