> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# MCP Gateway

> Give every agent one governed MCP endpoint for Atlan tools and the MCP servers your team already runs.

Atlan MCP Gateway gives your agents a single endpoint,
`https://api.atlan.com/mcp`. Through it they reach Atlan's platform tools and
every remote MCP server your team registers. Clients sign in once, see one
catalog, and every call is permission-checked and recorded in the account's
audit trail.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/atlan-602e2b74/i_mEyUODy0CTJNVw/assets/diagrams/mcp-gateway-light.svg?fit=max&auto=format&n=i_mEyUODy0CTJNVw&q=85&s=90f57e668b4e3516fecb87f0ca935061" alt="Your clients, such as Claude Code, Codex, Cursor and VS Code, agent frameworks, and your own agents, connect to one endpoint, https://api.atlan.com/mcp. Atlan MCP Gateway provides OAuth 2.1 sign-in, one catalog with namespaced tools, a workspace permission check on every call, credentials held at the gateway, session and call audit, and rate limits and timeouts. Behind it are Atlan platform tools and your registered MCP servers." width="860" height="424" data-path="assets/diagrams/mcp-gateway-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/atlan-602e2b74/i_mEyUODy0CTJNVw/assets/diagrams/mcp-gateway-dark.svg?fit=max&auto=format&n=i_mEyUODy0CTJNVw&q=85&s=05c5efb161cf21e9942583c4490e54b0" alt="Your clients, such as Claude Code, Codex, Cursor and VS Code, agent frameworks, and your own agents, connect to one endpoint, https://api.atlan.com/mcp. Atlan MCP Gateway provides OAuth 2.1 sign-in, one catalog with namespaced tools, a workspace permission check on every call, credentials held at the gateway, session and call audit, and rate limits and timeouts. Behind it are Atlan platform tools and your registered MCP servers." width="860" height="424" data-path="assets/diagrams/mcp-gateway-dark.svg" />
</Frame>

## Why teams use a gateway

Connecting each agent directly to each MCP server works for one developer. It
breaks down when a team runs many agents against many servers.

* **Credentials spread out.** Every client config holds its own tokens for
  every server. With the gateway, server credentials stay in Atlan and never
  appear in a client config file.
* **Nobody can see what ran.** Direct connections leave no shared record. The
  gateway records each call: the tool, the server, the stated reason, the
  outcome, and how long it took.
* **Access is all or nothing.** The gateway checks the caller's workspace
  permission before it forwards a call, so being able to see a tool and being
  able to run it are separate decisions.

## What you get

<CardGroup cols={2}>
  <Card title="One endpoint" icon="plug">
    Connect any client that speaks Streamable HTTP to
    `https://api.atlan.com/mcp`. Add servers behind it without touching client
    configs.
  </Card>

  <Card title="One catalog" icon="list">
    Atlan platform tools and your servers' tools appear in one `tools/list`,
    with namespaced names that never collide.
  </Card>

  <Card title="Bring your own MCP servers" icon="server">
    Register any remote MCP server. The gateway discovers its tools and keeps
    the catalog current.
  </Card>

  <Card title="Credentials stay server-side" icon="key">
    Use one shared credential for a server, or let each person connect their
    own account through OAuth.
  </Card>

  <Card title="Permission on every call" icon="shield-check">
    Workspace roles decide who can discover a server's tools and who can run
    them.
  </Card>

  <Card title="Audit trail" icon="clipboard-list">
    Sessions group related calls. Each call records its tool, rationale,
    outcome, and duration, but not its arguments or output.
  </Card>
</CardGroup>

## See your servers in Atlan

The **Marketplace** shows every MCP server your workspaces use, whether each
one is connected, and the vetted servers you can add in one step.

<img src="https://mintcdn.com/atlan-602e2b74/i_mEyUODy0CTJNVw/assets/screenshots/composed/mcp-marketplace.png?fit=max&auto=format&n=i_mEyUODy0CTJNVw&q=85&s=8df330f113274ba591068c8de3c396b4" alt="Marketplace page listing Linear, Miro, and Glean under In your workspaces, with Notion, Sentry, Granola, and Zendesk under Available to set up" width="2400" height="1600" data-path="assets/screenshots/composed/mcp-marketplace.png" />

## How it works

1. **Your client connects.** It points at `https://api.atlan.com/mcp` and
   signs in with OAuth. The gateway accepts the current stateless MCP protocol
   and the earlier `initialize` handshake on the same URL.

2. **The gateway builds one catalog.** It combines Atlan's platform tools with
   the tools of every enabled server your identity can see. Each name tells
   you where the tool comes from:

   | Prefix | Source | Example |
   | - | - | - |
   | `registry__` | Atlan Registry | `registry__search_artifacts` |
   | `extension__<provider>__` | An Atlan platform extension | `extension__skill__create` |
   | `remote__<server-id>__` | A server your team registered | `remote__mcp_server_01k7…__create_issue` |

3. **Your agent opens a session.** It calls `registry__initialise` once and
   passes the returned `session_id` on every later call, with a short
   `rationale` that says why it is making the call.

4. **The gateway governs each call.** It checks the caller's access, attaches
   the server's credential, forwards the call, and records the outcome.

## Start here

<CardGroup cols={2}>
  <Card title="Connect a client" icon="plug" href="/gateway/mcp/how-tos/connect-a-client">
    Add the gateway to Claude Code, Cursor, VS Code, or any MCP client.
  </Card>

  <Card title="Integrations" icon="puzzle-piece" href="/gateway/mcp/how-tos/integrations">
    Add built-in integrations or any MCP server, and connect data platforms.
  </Card>

  <Card title="Find and call tools" icon="magnifying-glass" href="/gateway/mcp/concepts/find-and-call-tools">
    Semantic search returns only the tools relevant to a task.
  </Card>

  <Card title="Track usage and audit" icon="chart-line" href="/gateway/mcp/how-tos/track-usage-and-audit">
    See every call, across every server, with who made it and why.
  </Card>

  <Card title="Supported features and limits" icon="list-check" href="/gateway/mcp/references/supported-features">
    See which MCP capabilities, transports, and credential types are supported.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.