Analyze Powerdrill Data with Natural Language
An MCP server letting Claude analyze and query Powerdrill datasets using natural-language questions.
1.0.0Add to Favorites
Why it matters
Interact with Powerdrill datasets using natural language queries. Analyze data and execute complex operations without writing code.
Outcomes
What it gets done
List and manage Powerdrill datasets and data sources.
Create and execute jobs for data analysis via natural language.
Upload local files as new data sources to Powerdrill datasets.
Group related analysis jobs into sessions.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-powerdrill | bash Capabilities
Tools your agent gets
Lists available datasets from your Powerdrill account
Retrieves detailed information about a specific dataset
Creates a job for analyzing data using natural language questions
Creates a new session for grouping related jobs
Lists data sources in a specific dataset
Lists sessions from your Powerdrill account
Creates a new dataset in your Powerdrill account
Creates a new data source by uploading a local file to a dataset
Overview
Powerdrill MCP Server
An MCP server for Powerdrill that lets Claude list, create, and query datasets using natural-language analysis jobs. Use it when Claude needs to analyze or manage Powerdrill datasets with an active Powerdrill Team account.
What it does
An MCP server for Powerdrill datasets that lets Claude analyze data and execute queries using natural-language questions, including listing datasets and data sources, creating new datasets, uploading local files as data sources, and running natural-language analysis jobs grouped into sessions.
When to use - and when NOT to
Use this when Claude needs to list or query Powerdrill datasets, create a new dataset or upload a file as a data source, or run a natural-language analysis job against existing data - for example "What datasets are available in my Powerdrill account?" or "Create a new dataset called 'Sales Analytics'." It requires an active Powerdrill Team account with a User ID and Project API Key - it is not usable without a Powerdrill subscription.
Capabilities
mcp_powerdrill_list_datasets: lists available datasets from your Powerdrill account.mcp_powerdrill_get_dataset_overview: retrieves detailed information about a specific dataset.mcp_powerdrill_create_job: creates a job to analyze data using natural-language questions.mcp_powerdrill_create_session: creates a new session for grouping related jobs.mcp_powerdrill_list_data_sources: lists data sources within a specific dataset.mcp_powerdrill_list_sessions: lists sessions from your Powerdrill account.mcp_powerdrill_create_dataset: creates a new dataset in your Powerdrill account.mcp_powerdrill_create_data_source_from_local_file: uploads a local file to a specified dataset as a new data source.
How to install
Via Smithery:
npx -y @smithery/cli install @powerdrillai/powerdrill-mcp --client claude
Or install globally (npm install -g @powerdrillai/powerdrill-mcp), run directly with npx @powerdrillai/powerdrill-mcp, or build from source and run the provided setup.sh. Configure Claude Desktop or Cursor with:
{
"powerdrill": {
"command": "npx",
"args": [
"-y",
"@powerdrillai/powerdrill-mcp@latest"
],
"env": {
"POWERDRILL_USER_ID": "your_actual_user_id",
"POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
}
}
}
Both POWERDRILL_USER_ID and POWERDRILL_PROJECT_API_KEY are required for authentication, and video tutorials are provided for setting up a Powerdrill Team account and its API keys.
Who it's for
Data teams already on a Powerdrill Team plan who want Claude or another MCP client to list, create, and query Powerdrill datasets using natural language instead of the Powerdrill web UI. Typical prompts include "Show me all my datasets", "Upload the file /Users/your_name/Downloads/sales_data.csv to dataset {dataset_id}", and "Tell me more about this dataset: {dataset_id}", and the server integrates directly with both Claude Desktop and other MCP-compatible clients such as Cursor, using the same NPX-based configuration in each case. Beyond the Node-based MCP server itself, the wider Powerdrill ecosystem also offers separate Node.js and Python client options, and the project notes require an active Powerdrill Team account rather than a free-tier account, since the underlying dataset and job APIs are gated behind that plan.
Source README
An MCP server that provides tools for interacting with Powerdrill datasets, enabling you to analyze data and execute queries using natural language questions.
Installation
Smithery
npx -y @smithery/cli install @powerdrillai/powerdrill-mcp --client claude
NPM Global
npm install -g @powerdrillai/powerdrill-mcp
NPX
npx @powerdrillai/powerdrill-mcp
From Source
git clone https://github.com/yourusername/powerdrill-mcp.git
cd powerdrill-mcp
npm install
Setup Script
chmod +x setup.sh
./setup.sh
Configuration
Claude Desktop (NPX)
{
"powerdrill": {
"command": "npx",
"args": [
"-y",
"@powerdrillai/powerdrill-mcp@latest"
],
"env": {
"POWERDRILL_USER_ID": "your_actual_user_id",
"POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
}
}
}
Claude Desktop (Node)
{
"powerdrill": {
"command": "node",
"args": ["/path/to/powerdrill-mcp/dist/index.js"],
"env": {
"POWERDRILL_USER_ID": "your_actual_user_id",
"POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
}
}
}
Cursor (NPX)
{
"powerdrill": {
"command": "npx",
"args": [
"-y",
"@powerdrillai/powerdrill-mcp@latest"
],
"env": {
"POWERDRILL_USER_ID": "your_actual_user_id",
"POWERDRILL_PROJECT_API_KEY": "your_actual_project_api_key"
}
}
}
Available Tools
| Tool | Description |
|---|---|
mcp_powerdrill_list_datasets |
Lists available datasets from your Powerdrill account |
mcp_powerdrill_get_dataset_overview |
Retrieves detailed information about a specific dataset |
mcp_powerdrill_create_job |
Creates a job to analyze data using natural language questions |
mcp_powerdrill_create_session |
Creates a new session for grouping related jobs |
mcp_powerdrill_list_data_sources |
Lists data sources within a specific dataset |
mcp_powerdrill_list_sessions |
Lists sessions from your Powerdrill account |
mcp_powerdrill_create_dataset |
Creates a new dataset in your Powerdrill account |
mcp_powerdrill_create_data_source_from_local_file |
Creates a new data source by uploading a local file to a specified dataset |
Features
- Authenticate to Powerdrill using User ID and Project API Key
- Retrieve a list of available datasets in your Powerdrill account
- Get detailed information about specific datasets
- Create and execute jobs on datasets using natural language questions
- Integration with Claude Desktop and other MCP-compatible clients
Environment Variables
Required
POWERDRILL_USER_ID- Your User ID in Powerdrill for authenticationPOWERDRILL_PROJECT_API_KEY- Your Project API Key in Powerdrill for authentication
Usage Examples
What datasets are available in my Powerdrill account?
Show me all my datasets
Create a new dataset called "Sales Analytics"
Upload the file /Users/your_name/Downloads/sales_data.csv to dataset {dataset_id}
Tell me more about this dataset: {dataset_id}
Resources
Notes
Requires a Powerdrill Team account with active API keys. Video tutorials are provided for setting up Powerdrill Team and API keys. Multiple web client options are available, including versions for Node.js and Python.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.