Skip to main content

Integrate MCP

The Application SDK provides built-in support for the Model Context Protocol (MCP), enabling Atlan applications to integrate with AI assistants such as Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.

Core capabilities

🔄

Parameter handling

Complex Pydantic models are flattened into simple parameters for AI assistant consumption.

  • Automatic expansion of models into individual fields
  • Type validation preserved
  • Default values maintained
🌐

MCP compliance

FastMCP 2.0–compatible server with streamable HTTP transport ensures interoperability with all MCP clients.

  • Standards-based protocol support
  • Streamable HTTP transport
  • Consistent error handling

How it works

When MCP is enabled in an Atlan application:

  1. Activities marked with @mcp_tool are automatically discovered by the Atlan SDK.
  2. Each activity is wrapped into an MCP-compatible tool, exposing parameters for AI assistants.
  3. The MCP server is mounted within the application and serves tool metadata and invocation endpoints.
  4. AI assistants can query this server to discover available tools, invoke activities with natural-language parameters, and receive structured results.

See also

  • Handle events: Understand how events and handlers work in Atlan applications
  • APIs: Learn about the APIs provided as part of Application SDK
  • Application architecture: Technical deep dive into application architecture
  • Apps framework: Overview of the Atlan Apps Framework and its capabilities