How to Use the Atlan MCP in Mastra AI

Q: How do I require human approval before modifying Atlan classifications in Mastra AI?

Use Mastra AI's built-in human-in-the-loop feature. Set requireToolApproval on your Mastra agent before running the Atlan listclassifications tool.

Build resilient, self-healing data governance workflows using Mastra AI and Atlan.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Atlan MCP to Mastra AI

Create your Vinkius account to connect Atlan to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Atlan with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate catalog audits with Mastra AI workflows

The `search_assets` tool lets your Mastra AI workflows scan your Atlan catalog for unclassified tables. If the Mastra agent finds a raw Atlan table, it triggers a workflow branch to assign an owner. You configure this by spreading the Atlan server's tools into your Mastra AI agent definition. The Mastra workflow handles Atlan API timeouts automatically using built-in exponential backoff.

Enforce human-in-the-loop approvals on Atlan

The `list_classifications` tool reads your Atlan governance tags from the MCP Server to ensure proper labeling in Mastra AI. When your Mastra agent suggests a new tag, the framework pauses Atlan catalog execution for admin approval. You implement this guardrail by setting requireToolApproval on the Atlan classification step inside Mastra. Your Atlan data catalog remains clean because Mastra AI requires human verification for changes.

Audit workspace permissions via this MCP Server

The `list_users` tool exposes your complete Atlan workspace roster to Mastra's automated auditing agents. This Mastra agent cross-references active Atlan users against security policies. Integrating this Atlan check into your Mastra AI deployment pipeline flags inactive accounts. You run these Atlan background checks on a Mastra cron schedule without maintaining custom cron scripts.

Setup guide

Set up Atlan MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Atlan tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "atlan-mcp-client",
  servers: {
    "atlan-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Atlan Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Atlan tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Atlan transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Atlan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Atlan now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Atlan MCP in Mastra AI

Instantiate your MCP client with your Vinkius endpoint URL inside your Mastra AI configuration. Spread the Atlan tools directly into your Mastra agent's tool array.

Yes, Mastra AI handles transient Atlan connection glitches automatically. If a call to `list_glossaries` fails, the Mastra workflow engine retries with exponential backoff.

Use Mastra AI's built-in human-in-the-loop feature. Set `requireToolApproval` on your Mastra agent before running the Atlan `list_classifications` tool.

Yes, Mastra AI automatically detects the transport type, including SSE and Streamable HTTP, for your Atlan server. You only need to supply the Vinkius URL in your Mastra config.

Mastra AI processes your Atlan workspace directory list in memory without writing data to disk. Vinkius isolates the connection, ensuring Atlan user emails are never stored or logged globally by Mastra.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript