Skip to content

Atlan MCP tool for ADK

Supported in ADKPythonTypeScript

The Atlan MCP Server connects your ADK agent to your Atlan data catalog, giving the agent the ability to discover, explore, govern, and manage data assets across your warehouses, lakes, BI tools, and pipelines using natural language.

Use cases

  • Asset Discovery: Search across tables, columns, dashboards, and pipelines with semantic search to find the right data for an analysis or feature.

  • Lineage and Impact Analysis: Trace upstream sources or downstream consumers of an asset to understand dependencies before a schema change.

  • Governance and Stewardship: Update descriptions, certify assets, manage glossaries and data domains, and create or schedule data quality rules from the agent.

Prerequisites

  • An Atlan tenant
  • An Atlan account with permissions to access the assets you want to query
  • Node.js installed locally (used by mcp-remote to bridge to the hosted MCP server)

Use with agent

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters


root_agent = Agent(
    model="gemini-flash-latest",
    name="atlan_agent",
    instruction="Help users search, explore, and govern data assets in Atlan",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.atlan.com/mcp",
                    ]
                ),
                timeout=30,
            ),
        )
    ],
)

import { LlmAgent, MCPToolset } from "@google/adk";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "atlan_agent",
    instruction: "Help users search, explore, and govern data assets in Atlan",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "mcp-remote",
                    "https://mcp.atlan.com/mcp",
                ],
            },
        }),
    ],
});

export { rootAgent };

Note

When you run this agent for the first time, a browser window opens automatically to request access via OAuth. Alternatively, you can use the authorization URL printed in the console. You must approve this request to allow the agent to access your Atlan tenant.

Available tools

Tool Description
semantic_search_tool Natural-language search across all data assets using AI-powered semantic understanding
traverse_lineage_tool Trace data flow upstream (sources) or downstream (consumers) for an asset
update_assets_tool Update asset descriptions, certificate status, README, terms, or custom metadata
create_glossaries Create new glossaries
create_glossary_terms Create terms within glossaries
create_glossary_categories Create categories within glossaries
create_domains Create data domains and subdomains
create_data_products Create data products linked to domains and assets
create_dq_rules_tool Create data quality rules (null checks, uniqueness, regex, custom SQL, etc.)
update_dq_rules_tool Update existing data quality rules
schedule_dq_rules_tool Schedule data quality rule execution with cron expressions
delete_dq_rules_tool Delete data quality rules
search_assets_tool Search assets using structured filters and conditions (enabled per tenant)
get_assets_by_dsl_tool Query assets using Atlan's DSL for advanced filtering (enabled per tenant)
query_assets_tool Execute SQL queries against connected data sources (enabled per tenant)

Additional resources