Teradata MCP Server

<p align="center"> <!-- Optional: replace with a logo if you have one --> <!-- <img src="docs/media/logo.svg" alt="Teradata MCP Server" width="120"> -->

</p>

<h1 align="center">Teradata MCP Server</h1>

<p align="center"> <a href="https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md"> <img alt="docs" src="https://img.shields.io/badge/docs-readme-555?logo=readthedocs"> </a> <a href="https://github.com/Teradata/teradata-mcp-server/releases"> <img alt="release" src="https://img.shields.io/github/v/release/Teradata/teradata-mcp-server?display_name=tag&sort=semver"> </a> <a href="https://pypi.org/project/teradata-mcp-server/"> <img alt="PyPI" src="https://img.shields.io/pypi/v/teradata-mcp-server"> </a> <a href="https://pypi.org/project/teradata-mcp-server/"> <img alt="downloads" src="https://img.shields.io/pypi/dm/teradata-mcp-server?label=downloads&color=2ea44f"> </a> <a href="./examples/app-flowise/flowise_teradata_agents/README.md"> <img alt="docs" src="https://img.shields.io/badge/Teradata--Agents-Setup-green"> </a> </p>

<p align="center"> Model Context Protocol (MCP) server for Teradata </p>

<p align="center"> ✨ <a href="https://github.com/Teradata/teradata-mcp-server?tab=readme-ov-file#quick-start-with-claude-desktop-no-installation">Quickstart with Claude Desktop </a> or <a href="https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md#-quick-start"> your favorite tool</a> in <5 minute ✨ </p>

Overview

The Teradata MCP server provides sets of tools and prompts, grouped as modules for interacting with Teradata databases. Enabling AI agents and users to query, analyze, and manage their data efficiently.

Key features

Available tools and prompts

We are providing groupings of tools and associated helpful prompts to support all type of agentic applications on the data platform.

• Search tools, prompts and resources to search and manage vector stores.
  • RAG Tools rapidly build RAG applications.
• Query tools, prompts and resources to query and navigate your Teradata platform:
  • Base Tools
• Table tools, to efficiently and predictably access structured data models:
  • Feature Store Tools to access and manage the Teradata Enterprise Feature Store.
  • Semantic layer definitions to easily implement domain-specific tools, prompts and resources for your own business data models.
• Data Quality tools, prompts and resources accelerate exploratory data analysis:
  • Data Quality Tools
• DBA tools, prompts and resources to facilitate your platform administration tasks:
  • DBA Tools
  • Security Tools
• Data Scientist tools, prompts, and resources to build powerful AI agents and workflows for data-driven applications.
  • Teradata Vector Store Tools
  • Teradataml Functions Tools
  • Plot Tools

Quick start with Claude Desktop (no installation)

Prefer to use other tools? Check out our Quick Starts for VS Code/Copilot, Open WebUI, or dive into simple code examples! You can use Claude Desktop to give the Teradata MCP server a quick try, Claude can manage the server in the background using uv. No permanent installation needed.

Pre-requisites

1. Get your Teradata database credentials or create a free sandbox at Teradata Clearscape Experience.
2. Install Claude Desktop.
3. Install uv. If you are on MacOS, Use Homebrew: brew install uv, on Windows you may use pip install uv as an alternative to the installer.

Configure the claude_desktop_config.json (Settings>Developer>Edit Config) by adding the configuration below, updating the database username, password and URL:

{
  "mcpServers": {
    "teradata": {
      "command": "uvx",
      "args": ["teradata-mcp-server"],
      "env": {
        "DATABASE_URI": "teradata://<USERNAME>:<PASSWORD>@<HOST_URL>:1025/<USERNAME>"
      }
    }
  }
}

Installation Instructions

Follow this process to install your server, connect it to your Teradata platform and integrated your tools.

Step 1. - Identify the running Teradata System, you need username, password and host details. If you do not have a Teradata system to connect to, then leverage Teradata Clearscape Experience

Step 2. - To install, configure and run the MCP server, refer to the Teradata MCP Server Documentation.

Step 3. - There are many client options available, the Client Guide explains how to configure and run a sample of different clients.

<br>

Check out our libraries of curated examples or video guides.

<br>

Contributing

Please refer to the Contributing guide and the Developer Guide.

---

Certification

<a href="https://glama.ai/mcp/servers/@Teradata/teradata-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@Teradata/teradata-mcp-server/badge" alt="Teradata Server MCP server" /> </a>