td-mcp

What problem does it solve?

This Skill provides expert assistance for connecting Claude Code to Treasure Data via the MCP (Model Context Protocol) server, enabling natural language data exploration and management. It simplifies interacting with TD databases, tables, and even CDP segments and workflows using plain English, making data accessible to more users.

Core Features & Use Cases

• Natural Language Data Access: Allows users to query TD databases, list tables, describe schemas, and execute SQL using conversational prompts in Claude Code.
• Secure Integration: Guides on setting up the MCP server with a write-only API key and optional write operations, ensuring secure and controlled access to TD.
• CDP & Workflow Management: Provides experimental tools for listing and getting details of CDP segments and workflow projects, extending AI capabilities beyond raw data.
• Use Case: A marketing analyst wants to quickly find out "How many unique users visited the product page yesterday?" without writing SQL. This skill helps them set up the TD MCP server with Claude Code, allowing them to ask natural language questions and get immediate answers, saving time and reducing reliance on data engineers.

Quick Start

Set your TD API key

export TD_API_KEY="your_api_key_here"

Add TD MCP server to Claude Code

claude mcp add td -e TD_API_KEY=$TD_API_KEY -- npx @treasuredata/mcp-server

Then, in Claude Code, you can ask: "List tables in sample_datasets"