Skip to main content

Set up Google ADK with Remote MCP

You can connect an agent built with Google Agent Development Kit (ADK) to the Atlan Remote MCP server. This lets your ADK agent search for assets, explore lineage, update metadata, create glossary terms, run data quality rules, and more—all using natural language to query your Atlan data catalog.

ADK connects to Atlan MCP through mcp-remote, a Node.js bridge that forwards tool calls to the hosted MCP endpoint.

Prerequisites​

Before you begin, make sure you have:

  • An Atlan tenant with Remote MCP enabled.
  • Node.js 18 or newer installed—required to run mcp-remote.
  • The Google ADK package installed for your language:
    • Python: pip install google-adk
    • TypeScript: npm install @google/adk

Set up Remote MCP​

  1. In your project, create an agent file (for example, agent.py) and add the following:

    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,
                ),
            )
        ],
    )

  2. Run your agent using the ADK CLI or your preferred runner:

    adk run agent.py

  3. On first run, a browser window opens automatically for OAuth approval. Sign in with your Atlan account to authorize the agent. Once approved, the agent connects to Atlan using your roles and permissions.

    If the browser doesn't open automatically, copy the authorization URL printed in the terminal and open it manually.

  4. After authorization, the agent has access to all Atlan MCP tools. For more information, see the list of Atlan MCP tools.

Need help?​

If you have any issues while configuring the integration, contact Atlan Support for assistance.

See also​