tridalabs/tridapad-mcp repository overview

docker run -d \
  -e TRIDAPAD_URL=https://your-tridapad.com \
  -e TRIDAPAD_API_KEY=your_api_key \
  -p 8080:8080 \
  tridalabs/tridapad-mcp:latest

MCP endpoint: http://localhost:8080/mcp
Health check: http://localhost:8080/health

Connect from Claude / Cursor / Windsurf

{
  "mcpServers": {
    "tridapad": {
      "url": "http://localhost:8080/mcp",
      "headers": { "Authorization": "Key your_api_key_here" }
    }
  }
}

Environment Variables

┌─────────────────────┬─────────┬────────────────────────────────────────────────┐
│      Variable       │ Default │                  Description                   │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ TRIDAPAD_URL        │ —       │ Required. TridaPad base URL                    │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ TRIDAPAD_API_KEY    │ —       │ Required. TridaPad user API key                │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ TRANSPORT           │ http    │ stdio for local tools, http for web deployment │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ MCP_HOST            │ 0.0.0.0 │ HTTP bind host                                 │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ MCP_PORT            │ 8080    │ HTTP bind port                                 │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ TRIDAPAD_MAX_ROWS   │ 5000    │ Max rows returned per query                    │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ TRIDAPAD_SQL_SAFETY │ strict  │ strict / warn / off                            │
├─────────────────────┼─────────┼────────────────────────────────────────────────┤
│ LOG_LEVEL           │ INFO    │ DEBUG / INFO / WARNING                         │
└─────────────────────┴─────────┴────────────────────────────────────────────────┘

What's Included (47 MCP Tools)

- Data Sources — list sources, explore schemas, inspect table columns
- Queries — execute ad-hoc SQL, run/fork/archive saved queries, export CSV
- Visualizations — create and update charts, tables, counters, funnels
- Dashboards — create, fork, share, and manage widgets and layouts
- Alerts — threshold-based query monitoring with Slack/email destinations
- Snippets — reusable SQL template library

Security

- SQL safety guard blocks DROP, TRUNCATE, ALTER TABLE, and unbounded DELETE/UPDATE by default
- Every HTTP connection requires Authorization: Key <TRIDAPAD_API_KEY>
- Unauthenticated requests return HTTP 401

Deploy on Render

Use the pre-built image with no build step — set TRIDAPAD_URL and TRIDAPAD_API_KEY as environment variables in the Render dashboard and deploy.