MCP Directory

How to add Atlan MCP Server to Windsurf

Search, govern, and manage Atlan data catalog assets from AI agents via the Model Context Protocol. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 33★ · stdio · apikey

Windsurf config for Atlan MCP Server

uvx atlan-mcp-server
{
  "mcpServers": {
    "atlan-mcp-server": {
      "command": "uvx",
      "args": [
        "atlan-mcp-server"
      ],
      "env": {
        "ATLAN_API_KEY": "<YOUR_API_KEY>",
        "ATLAN_BASE_URL": "https://<YOUR_INSTANCE>.atlan.com",
        "ATLAN_AGENT_ID": "<YOUR_AGENT_ID>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Atlan MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Atlan MCP Server's tools become available to Cascade.

Before you start

  • An Atlan instance and an Atlan API key (ATLAN_API_KEY)
  • Your Atlan instance base URL (ATLAN_BASE_URL, e.g. https://<your-instance>.atlan.com)
  • Docker (for the Docker install method) OR uv / Python 3.11+ (for the uvx install method)

What Atlan MCP Server can do in Windsurf

search_assets

Search for assets based on conditions.

get_assets_by_dsl

Retrieve assets using a DSL query.

traverse_lineage

Retrieve lineage for an asset.

update_assets

Update asset attributes (user description and certificate status).

create_glossaries

Create glossaries.

create_glossary_categories

Create glossary categories.

create_glossary_terms

Create glossary terms.

create_dq_rules

Create data quality rules on Table, View, MaterialisedView, or SnowflakeDynamicTable assets (column-level, table-level, custom SQL).

Security

Requires an Atlan API key (ATLAN_API_KEY) and your instance base URL (ATLAN_BASE_URL) passed as environment variables; store these securely and avoid committing them. The server supports a RESTRICTED_TOOLS environment variable to block specific tools (e.g. for read-only access or to disable raw DSL/SQL queries) — recommended for least-privilege and shared/production deployments. The local server is deprecated and in maintenance-only mode; the vendor recommends the hosted endpoint at mcp.atlan.com/mcp.

Atlan MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Atlan MCP Server config there under the "mcpServers" key and restart the client.

Is Atlan MCP Server safe to use with Windsurf?

Requires an Atlan API key (ATLAN_API_KEY) and your instance base URL (ATLAN_BASE_URL) passed as environment variables; store these securely and avoid committing them. The server supports a RESTRICTED_TOOLS environment variable to block specific tools (e.g. for read-only access or to disable raw DSL/SQL queries) — recommended for least-privilege and shared/production deployments. The local server is deprecated and in maintenance-only mode; the vendor recommends the hosted endpoint at mcp.atlan.com/mcp.

Do I need Python installed?

It depends on the install method. With Docker (recommended) no Python is needed on the host — the container includes everything. With uv, a Python runtime is required, but uv will automatically download and manage Python 3.11+ for you. The server is implemented in Python and requires Python 3.11+ to run.

Which MCP clients are supported?

The README documents mcpServers config blocks for Claude Desktop and Cursor over stdio. SSE and streamable-http transports are also supported for remote/web deployments.

Can I restrict which tools are exposed?

Yes. Set the RESTRICTED_TOOLS environment variable to a comma-separated list of tool names to hide and block them — useful for read-only access or disabling raw DSL/SQL queries. If unset, all tools are available by default.

View repo Full Atlan MCP Server page