Alation/alation-ai-agent-sdk

The Alation AI Agent SDK enables AI agents to access and leverage metadata from the Alation Data Catalog.
## Overview
This SDK empowers AI agents to:
Easily integrate with Alation's Data Catalog
Address use cases like Asset Curation, Search & Discovery, Role Based Agents, and Data Analyst Agents
Use natural language to search for relevant metadata
Integrate seamlessly with AI frameworks like MCP
## Components
The project is organized into multiple components:
Core SDK - Foundation with API client and context tools
MCP Integration - Server implementation for Model Context Protocol
LangChain Integration - Adapters for the LangChain framework
### Core SDK (alation-ai-agent-sdk)
The core SDK provides the foundation for interacting with the Alation API. It handles authentication, request formatting, and response parsing.
Learn more about the Core SDK
### LangChain Integration (alation-ai-agent-langchain)
This component integrates the SDK with the LangChain framework, enabling the creation of sophisticated AI agents that can reason about your data catalog.
Learn more about the LangChain Integration
### MCP Integration (alation-ai-agent-mcp)
The MCP integration provides an MCP-compatible server that exposes Alation's context capabilities to any MCP client. Supports both traditional STDIO mode for direct MCP client connections and HTTP mode for web applications and API integrations.
Learn more about the MCP Integration
## Getting Started
### Prerequisites
Python 3.10 or higher
Access to an Alation Data Catalog instance
A valid refresh token or clientid and secret. For more details, refer to the Authentication Guide.
### Installation
bash
pip install uv
# Install the core SDK
uv pip install alation-ai-agent-sdk==1.0.0
# Install LangChain integration
uv pip install alation-ai-agent-langchain==1.0.0
# Install the MCP integration
uv pip install alation-ai-agent-mcp==1.0.0
## Usage
The library needs to be configured with your Alation instance credentials. You should use ServiceAccountAuthParams.
### Service Account Authentication (Recommended)
python
from alationaiagentsdk import AlationAPI, ServiceAccountAuthParams
# Initialize the SDK with Service Account Authentication
authparams = ServiceAccountAuthParams(
clientid="yourclientid",
clientsecret="yourclientsecret"
alationapi = AlationAPI(
baseurl="https://your-alation-instance.com",
authmethod="serviceaccount",
authparams=authparams
If you cannot obtain service account credentials (admin only), see the User Account Authentication Guide for instructions.
## New Major Version 1.x.x
#### Oct 23, 2026 Update
1.0.0 is the first stable release of the Alation AI Agent SDK.
Requests now send an Ai-Surface header (default sdk); set AgentSDKOptions(surface=...) to identify your integration
The MCP server requires certifi>=2026.10.19, and its Docker image refreshes the OS CA store, removing trust in the compromised eMudhra intermediate CAs
Auth parameter objects redact secrets in their repr()
Streaming and non-streaming responses handle malformed or empty payloads more gracefully
#### Jan 2, 2026 Update
Breaking Changes:
Removed tools: updatecatalogassetmetadata and checkjobstatus have been removed from the SDK