Skip to content
Last updated

Local MCP Server

The Local MCP Server (tdx mcp) exposes the Treasure Code (tdx) CLI over local stdio, so AI coding agents can query databases, manage segments, and run workflows in your Treasure AI environment directly from natural-language prompts. Use it when you want an AI coding tool on your machine to operate on your data with your local tdx credentials, not just search documentation.

Set Up and Run the Local MCP Server

npm install -g @treasuredata/tdx
tdx auth setup
tdx mcp

Available Tools

Tool Parameters Description
tdx_runargs: string[]Executes a tdx CLI command and returns JSON output
tdx_searchquery: string, category?: stringSearches for relevant tdx commands based on what you want to do

Categories for tdx_search: Data, CDP, AI, Context, Utilities.

For the full tool reference, blocked commands, and troubleshooting, see the tdx mcp command reference.

Connect Your Tool

Claude Code, OpenAI Codex, VS Code and GitHub Copilot, Cursor, Snowflake Cortex Code, and Databricks Genie Code can all connect to the Local MCP Server. See Headless or Agent Setup for tool-specific setup steps. For other MCP clients (such as Claude Desktop or Windsurf), see the tdx mcp command reference.

Next Steps