Markdown Content: agent-toolkit/modelcontextprotocol at main · atlanhq/agent-toolkit · GitHub
===============
Skip to content Navigation Menu
Toggle navigation
Appearance settings
- Product
* [GitHub Copilot Write better code with AI](https://github.com/features/copilot)
* [GitHub Spark New Build and deploy intelligent apps](https://github.com/features/spark)
* [GitHub Models New Manage and compare prompts](https://github.com/features/models)
* [GitHub Advanced Security Find and fix vulnerabilities](https://github.com/security/advanced-security)
* [Actions Automate any workflow](https://github.com/features/actions)
* [Codespaces Instant dev environments](https://github.com/features/codespaces)
* [Issues Plan and track work](https://github.com/features/issues)
* [Code Review Manage code changes](https://github.com/features/code-review)
* [Discussions Collaborate outside of code](https://github.com/features/discussions)
* [Code Search Find more, search less](https://github.com/features/code-search)
Explore * Why GitHub * All features * Documentation * GitHub Skills * Blog
- Solutions
By company size * Enterprises * Small and medium teams * Startups * Nonprofits
By use case * DevSecOps * DevOps * CI/CD * View all use cases
By industry * Healthcare * Financial services * Manufacturing * Government * View all industries
- Resources
Topics * AI * DevOps * Security * Software Development * View all
Explore * Learning Pathways * Events & Webinars * Ebooks & Whitepapers * Customer Stories * Partners * Executive Insights
- Open Source
* [GitHub Sponsors Fund open source developers](https://github.com/sponsors)
* [The ReadME Project GitHub community articles](https://github.com/readme)
Repositories * Topics * Trending * Collections
- Enterprise
* [Enterprise platform AI-powered developer platform](https://github.com/enterprise)
Available add-ons * GitHub Advanced Security Enterprise-grade security features * Copilot for business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support
Search or jump to...
Search code, repositories, users, issues, pull requests...
Search
Clear
Provide feedback
We read every piece of feedback, and take your input very seriously.
- [x] Include my email address so I can be contacted
Cancel Submit feedback
Saved searches
Use saved searches to filter your results more quickly
Name
Query
To see all available qualifiers, see our documentation.
Cancel Create saved search
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
atlanhq/**agent-toolkit**Public
-
NotificationsYou must be signed in to change notification settings
-
Security### Uh oh! There was an error while loading.Please reload this page.
Additional navigation options
Collapse file tree
Files
main
Search this repository
-
.github -
modelcontextprotocol-
.cursor/rules -
docs -
tools -
utils -
.dockerignore -
.env.template -
.python-version -
Dockerfile -
README.md -
client.py -
pyproject.toml -
server.py -
settings.py -
uv.lock -
version.py
-
-
.gitignore -
.pre-commit-config.yaml -
CHANGELOG.md -
CODE_OF_CONDUCT.md -
CONTRIBUTING.md -
LICENSE -
README.md -
commitlint.config.js
Breadcrumbs
/ modelcontextprotocol
/
Copy path
Directory actions
More options
More options
Directory actions
More options
More options
Latest commit
success
Jul 24, 2025
20bfc8a·Jul 24, 2025
History
Open commit details
Breadcrumbs
/ modelcontextprotocol
/
Top
Folders and files
README.md
Outline
Atlan MCP Server
The Atlan Model Context Protocol server allows your AI agents to interact with Atlan services.
Quick Start
- Generate Atlan API key by following the documentation.
- Select one of the following approaches based on your preference: * Install via Docker - Uses Docker containers (recommended) * Install via uv - Uses UV package manager
Note
Make sure to replace <YOUR_API_KEY>, <YOUR_INSTANCE>, and <YOUR_AGENT_ID> with your actual Atlan API key, instance URL, and agent ID(optional) in the configuration file respectively.
Install via Docker
Prerequisites:
- Follow the official Docker installation guide for your operating system
- Verify Docker is running:
undefinedshell docker --version undefined
Add to Claude Desktop
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json and add:
undefinedjson { "mcpServers": { "atlan": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ATLAN_API_KEY=<YOUR_API_KEY>", "-e", "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com", "-e", "ATLAN_AGENT_ID=<YOUR_AGENT_ID>", "ghcr.io/atlanhq/atlan-mcp-server:latest" ] } } } undefined
Add to Cursor
Open Cursor > Settings > Tools & Integrations > New MCP Server to include the following:
undefinedjson { "mcpServers": { "atlan": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ATLAN_API_KEY=<YOUR_API_KEY>", "-e", "ATLAN_BASE_URL=https://<YOUR_INSTANCE>.atlan.com", "-e", "ATLAN_AGENT_ID=<YOUR_AGENT_ID>", "ghcr.io/atlanhq/atlan-mcp-server:latest" ] } } } undefined
Install via uv
Prerequisites:
- Install uv:
undefinedshell
macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Alternative: if you already have Python/pip
pip install uv undefined
- Verify installation:
undefinedshell uv --version undefined
Note
With uv, uvx automatically fetches the latest version each time you run it. For more predictable behavior, consider using the Docker option.
Add to Claude Desktop
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
undefinedjson { "mcpServers": { "atlan": { "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>" } } } } undefined
Add to Cursor
Open Cursor > Settings > Tools & Integrations > New MCP Server to include the following:
undefinedjson { "mcpServers": { "atlan": { "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>" } } } } undefined
Available Tools
| Tool | Description |
|---|---|
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) |
Production Deployment
- Host the Atlan MCP container image on the cloud/platform of your choice
- Make sure you add all the required environment variables
- Make sure you start the server in the SSE transport mode
-e MCP_TRANSPORT=sse
Remote MCP Configuration
We currently do not have a remote MCP server for Atlan generally available.
You can use the mcp-remote local proxy tool to connect it to your remote MCP server.
This lets you to test what an interaction with your remote MCP server will be like with a real-world MCP client.
undefinedjson { "mcpServers": { "math": { "command": "npx", "args": ["mcp-remote", "https://hosted-domain"] } } } undefined
Develop Locally
Want to develop locally? Check out our Local Build Guide for a step-by-step walkthrough!
Need Help?
- Reach out to [email protected] for any questions or feedback
- You can also directly create a GitHub issue and we will answer it for you
Frequently Asked Questions
Do I need Python installed?
Short answer: It depends on your installation method.
- Docker (Recommended): No Python installation required on your host machine. The container includes everything needed.
- uv: A Python runtime is needed, but uv will automatically download and manage Python 3.11+ for you if it's not already available.
Technical details: The Atlan MCP server is implemented as a Python application. The Model Context Protocol itself is language-agnostic, but our current implementation requires Python 3.11+ to run.
Troubleshooting
- If Claude Desktop shows an error similar to
spawn uv ENOENT {"context":"connection","stack":"Error: spawn uv ENOENT\\n at ChildProcess._handle.onexit, it is most likely this issue where Claude is unable to find uv. To fix it: * Make sure uv is installed and available in your PATH * Runwhich uvto verify the installation path * Update Claude's configuration to point to the exact uv path by runningwhereis uvand use that path
Footer
Footer navigation
You can’t perform that action at this time.
Recommend MCP Servers 💡
@drew-goddyn/buildkite-mcp
An MCP server that integrates with Buildkite to retrieve and manage information about organizations, pipelines, builds, and jobs.
mcp-skill-set
An MCP server built with mcp-framework to add custom tools for model context management.
osm-mcp-server
An OpenStreetMap MCP server implementation that enhances LLM capabilities with location-based services and geospatial data.
webflow-mcp-server
An official Node.js MCP server by Webflow, enabling AI agents to interact with Webflow Data API for managing sites, pages, components, CMS, and custom code.
PortSwigger/mcp-server
Integrates Burp Suite with AI Clients using the Model Context Protocol (MCP), providing both SSE and Stdio proxy server capabilities.
@genomoncology/biomcp
BioMCP: Biomedical Model Context Protocol