Model context protocol (MCP)
The Model Context Protocol (MCP) is an open standard that enables AI agents to access contextual metadata from external systems. It provides a consistent way for large language models and automation frameworks to retrieve the context they need to generate accurate and reliable results.
Atlan MCP is based on this standard and provides a reference implementation through the Atlan MCP server. The server acts as a secure bridge between Atlan's metadata platform and AI tools such as Claude, Cursor, Windsurf, and Microsoft Copilot Studio. With Atlan MCP, you can search and discover assets, explore lineage, update metadata, manage classification tags and custom metadata, govern the asset lifecycle, create glossaries, enforce data quality, and more—all using real-time context from Atlan.
Atlan MCP tools
The Atlan MCP server provides a set of tools that enable AI agents to work directly with Atlan metadata. These tools supply real-time context to AI environments, making it easier to search, explore, and update metadata without leaving your workflow.
The latest version of the server includes all of the tools listed below. If you're using Remote MCP, the tool list updates automatically—no action needed on your end. If you're using Local MCP and don't see a tool listed here, update to the latest Atlan MCP server version.
- Read-only: Tools in Search & discovery and Lineage & exploration retrieve data from Atlan and don't modify any metadata.
- Write: Tools in Asset metadata, Custom metadata, Asset lifecycle, Business glossary, Data domains, and Data quality modify metadata in Atlan. Exercise caution when using these tools in automated workflows.
- Admin only:
Create custom metadata set,Add attributes to CM set,Remove attributes from CM set, andDelete custom metadata setare restricted to users with admin permissions in Atlan.
Search & discovery
Semantic search
Read-onlyFind relevant assets using natural-language queries and intent-aware ranking so AI agents surface the right context faster.
Search assets
Read-onlyFind assets using structured filters such as type, certification status, and creation date to return precise, targeted results. Returns up to 10 results by default—include a limit value in your prompt (for example: "find up to 50 certified tables") to retrieve more, up to a maximum of 100 per call.
Count assets
Read-onlyCount assets matching specific filters to answer aggregation questions like "how many certified tables exist?" without fetching full result sets.
Get asset
Read-onlyRetrieve complete details for a specific asset by GUID, including metadata, owners, tags, and custom attributes. Use this tool when Search assets returns partial results—for example, column-level attributes such as data type are only available via Get asset, not from the search results.
Resolve metadata
Read-onlyDiscover users, tags, glossary terms, custom metadata schemas, and domains by name using vector search across five namespaces so AI agents can resolve the right values before writing metadata.
Get groups
Read-onlyList all groups in Atlan and their members so AI agents can resolve group names to actual identities for governance and ownership tasks.
Lineage & exploration
Traverse lineage
Read-onlyTrace upstream or downstream lineage for an asset to understand dependencies, data flows, and impact across your environment. For assets with deep or wide lineage graphs, break the traversal into smaller hops—for example, ask for one level at a time rather than full end-to-end lineage in a single call.
Query assets
Read-onlyRun SQL queries directly on connected data sources such as Snowflake to retrieve sample data for analysis and validation.
Asset metadata
Update assets
WriteModify asset metadata such as descriptions, certification status, and README content so AI workflows keep asset context up to date. When updating a glossary term (AtlasGlossaryTerm), you must also provide the parent glossary GUID—retrieve it first with Get asset or Search assets.
Update custom metadata
WriteSet or update custom metadata attribute values on any asset to capture governance, quality, or business context defined by your organization.
Add Atlan tags
WriteApply one or more classification tags to assets, with optional propagation to downstream lineage so governed classifications stay consistent across related assets.
Remove Atlan tag
WriteRemove a specific classification tag from an asset to keep tagging accurate and reflect changes in data sensitivity or governance state.
Manage announcements
WriteAdd or remove announcements (informational, warning, or issue) on assets to communicate status changes, deprecation notices, or known problems to your team.
Custom metadata
Create custom metadata set
AdminDefine a new custom metadata set with typed attributes so teams can capture structured governance, quality, or business context on assets.
Add attributes to CM set
AdminAdd new typed attributes to an existing custom metadata set to extend its schema without needing to recreate it.
Remove attributes from CM set
AdminRemove specific attributes from a custom metadata set when they're no longer needed for your governance model.
Remove custom metadata
WriteClear all custom metadata values from an asset for a specific metadata set, removing the captured context without deleting the set itself.
Delete custom metadata set
AdminPermanently delete an entire custom metadata set and all its attribute definitions when the schema is no longer needed.
Asset lifecycle
Manage asset lifecycle
WriteArchive, restore, or purge assets to manage the end-of-life state of deprecated or replaced data assets and keep your catalog clean.
Business glossary
Create glossaries
WriteDefine new business glossaries with metadata and descriptions so teams can organize terms by domain or function.
Create glossary categories
WriteAdd categories and subcategories inside glossaries so business terms are grouped into clear, navigable hierarchies.
Create glossary terms
WriteCreate individual business terms with names, definitions, and certificate status so AI agents can align prompts with shared language.
Data domains
Create domains
WriteDefine data domains and subdomains to organize assets and data products by business area and ownership.
Create data products
WriteCreate data products linked to assets within a domain so teams can publish and discover business-ready datasets and contracts.
Data quality
Create DQ rules
WriteDefine column, table, and SQL-based rules on critical assets so AI workflows can enforce baseline data quality checks.
Update DQ rules
WriteAdjust thresholds, priorities, and conditions on existing rules so quality checks stay aligned with evolving data patterns.
Schedule DQ rules
WriteConfigure cron-based schedules for rules on tables and views so data quality checks run automatically alongside ETL workflows.
Delete DQ rules
WriteRemove deprecated or noisy rules so your data quality rule set remains focused and maintainable.
Deployment options
You can connect to Atlan MCP in two ways:
Hosted, per-tenant MCP server managed by Atlan, with OAuth and API Key authentication. Ideal for production setups and available for all tenants.
Locally hosted MCP server you run with Docker or uv. Ideal for development, testing, and custom environments before moving to a managed option.