---
title: "Lightdash MCP server for AI agents - actionlake"
description: "Give Claude 831 Lightdash actions through one MCP server: AI agents, projects, organizations. Your agent never holds the credential. 100,000 calls a month free."
canonical: https://actionlake.com/connectors/lightdash
updated: 2026-10-23
---

Connectors · Observability & analytics

# Lightdash MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Lightdash and the rest of your systems. It gives your agent 831 Lightdash actions (400 reads, 314 writes and 117 that wait for a confirmation) and holds the Lightdash credential itself, so the agent never does. It paces Lightdash's limits and records every call.

[Connect Lightdash free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

`claude mcp add --transport http actionlake https://connect.actionlake.com/mcp`

the first call

```
do {
  action: "lightdash.organizations.list_organization_members",
  intent: "check which Lightdash account is connected"
}
# List organization members · read · 1 upstream call
```

- 831 actions in one signed file
- 400 read look, never change
- 314 write create and update
- 117 wait for a yes destructive, confirmed first

Set up

## Connect Lightdash in three steps.

1. 01
   ### Add actionlake to Claude.
   Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
   `https://connect.actionlake.com/mcp`
2. 02
   ### Connect Lightdash.
   API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
   - `api_key` Lightdash personal access token
   - `auth_scheme` Your Lightdash auth scheme
   - `host` Where your Lightdash lives: your host
   ```
   account { op: "connections.requirements", service: "lightdash" }
   # free: exactly what to paste, and what is found for you
   ```
3. 03
   ### Make the first call. Check before a write.
   Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free.
   ```
   do    { action: "lightdash.organizations.list_organization_members" }
   # list organization members · read · 1 upstream call
   check { action: "lightdash.organizations.create_group_in_organization", input: { … } }
   # free: inputs, permissions, cost and confirmations, nothing sent
   ```

Lightdash at a glance

**Sign-in**

API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.

**You provide**

`api_key`

**Setup fields**

`auth_scheme` `host`

**Limits we pace to**

600 calls a minute, per connection

**API covered**

Lightdash API v1/v2 3.39.0 (OpenAPI 3.0.0)`app.lightdash.cloud`

**Built from**

Lightdash's documentation, read 23 October 2026[OpenAPI spec (GitHub)](https://raw.githubusercontent.com/lightdash/lightdash/main/packages/backend/src/generated/swagger.json) [docs.lightdash.com](https://docs.lightdash.com/api-reference/v1/introduction)

**Service file**

Version 1.0.0, signed (Ed25519)

**Cached reads**

315 of 400 reads, for up to 5 minutes; a write clears what it affects

**Shared entities**

5, so ask can line Lightdash up with your other systems

**Data**

Processed and stored in Sydney, Australia. No US region yet

Capabilities

## What an AI agent can do in Lightdash.

831 actions in 60 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

- **400** read look, never change
- **314** write create and update
- **117** destructive wait for a confirmation

1. ### AI agents
   172
   81 read · 78 write · 13 destructive
   Add AI agent review item comment · Convert a legacy Bedrock configuration into a managed credential · Append instruction · Append to evaluation
2. ### Projects
   135
   67 read · 62 write · 6 destructive
   List dashboards · Get project · Create dashboard · List charts in project
3. ### Organizations
   70
   25 read · 30 write · 15 destructive
   List organization members · List organization groups · Create group · Get organization member by UUID
4. ### Catalog
   27
   16 read · 7 write · 4 destructive
   Acquire tree lock · Add category to catalog item · Create metrics tree · Create metrics tree edge
5. ### My account
   26
   9 read · 11 write · 6 destructive
   Get authenticated user · Complete Redshift AWS SSO login · Complete onboarding tour · Create personal access token
6. ### Roles
   25
   9 read · 4 write · 12 destructive
   Create custom role · Duplicate role · List role assignees · List organization role assignments
7. ### Homepage
   22
   10 read · 8 write · 4 destructive
   Create project announcement · Create project homepage · Get homepage assignments · Get homepage recently viewed
8. ### SQL runner
   22
   11 read · 9 write · 2 destructive
   Create SQL chart · Create SQL chart scheduler · Create virtual view · List SQL chart schedulers

**52 more areas · 332 actions**

- Integrations **20**
- Query **20**
- Scim **20**
- Dashboards **18**
- Documents **17**
- Schedulers **17**
- Charts **14**
- Content **14**
- Roles permissions **14**
- Content review requests **11**
- Github **9**
- User groups **9**
- Code **8**
- Spaces **8**
- Agent identity **7**
- AI access **7**
- Agent connections **6**
- Direct access **6**
- Git files **6**
- Git integration **6**
- Service accounts **6**
- Exploring **5**
- Learn **5**
- Organization warehouse credentials **5**
- Analytics project **4**
- Comments **4**
- Feature flag **4**
- Mobile push notifications **4**
- Pre aggregates **4**
- Project **4**
- Query sources **4**
- Saved **4**
- User attributes **4**
- Agent permissions **3**
- Metrics explorer **3**
- Parameters **3**
- Spotlight **3**
- Validate **3**
- AI agent live activities **2**
- Aws web identity **2**
- Defaults **2**
- Funnel **2**
- Gitlab **2**
- Groups **2**
- Notifications **2**
- Share links **2**
- Users **2**
- Data catalog **1**
- Exports **1**
- Map **1**
- Pull requests **1**
- SSH keypairs **1**

Top actions

## The Lightdash API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 24 of Lightdash's 24 action names are shared with at least one other connector, so an agent learns them once.

| Action | What it does | Effect | Same name in |
| --- | --- | --- | --- |
| `lightdash.organizations.list_organization_members` List organization members | List organization members. | read | `identity.user.list` 474 connectors |
| `lightdash.organizations.list_groups_in_organization` List organization groups | List organization groups. | read | `identity.group.list` 262 connectors |
| `lightdash.my_account.get_authenticated_user` Get authenticated user | Get authenticated user. | read | `identity.current_user.get` 307 connectors |
| `lightdash.organizations.create_group_in_organization` Create group | Create group. | write | `identity.group.create` 205 connectors |
| `lightdash.organizations.get_organization_member_by_uuid` Get organization member by UUID | Get organization member by UUID. | read | `identity.user.get` 399 connectors |
| `lightdash.organizations.delete_organization_member` Delete organization member | Delete organization member. | destructive | `identity.user.delete` 253 connectors |
| `lightdash.organizations.list_organization_projects` List organization projects | List organization projects. | read | `work.project.list` 109 connectors |
| `lightdash.user_groups.get_group_members` Get group members | Get group members. | read | `identity.group_member.list` 103 connectors |
| `lightdash.organizations.create_project` Create project | Create project. | write | `work.project.create` 102 connectors |
| `lightdash.projects.get_dashboards` List dashboards | List dashboards. | read | `analytics.dashboard.list` 22 connectors |
| `lightdash.user_groups.add_user_to_group` Add user to group | Add user to group. | write | `identity.group_member.add` 72 connectors |
| `lightdash.projects.create_dashboard` Create dashboard | Create dashboard. | write | `analytics.dashboard.create` 18 connectors |

Try it

## Prompts to paste into Claude.

Each one names the Lightdash actions it will call, so you know what it reads and what it changes before you send it.

1. Read read
   Give me a one-line status for every active Lightdash project.
   calls `lightdash.organizations.list_organization_projects`
2. Write write
   Create group in Lightdash. Show me exactly what you will send before you save it.
   calls `lightdash.organizations.create_group_in_organization`

Governance for Lightdash

## Destructive actions wait for a yes.

117 Lightdash actions are destructive. The first 10:

- Delete organization member `lightdash.organizations.delete_organization_member`
- Delete group `lightdash.user_groups.delete_group`
- Remove user from group `lightdash.user_groups.remove_user_from_group`
- Delete dashboard `lightdash.dashboards.delete_project_dashboard`
- Delete chart `lightdash.saved.delete_project_saved_chart`
- Delete tag `lightdash.projects.delete_tag`
- Delete space `lightdash.spaces.delete_space`
- Delete user `lightdash.my_account.delete_me`
- Unverify chart `lightdash.charts.unverify_chart`
- Set explores `lightdash.projects.set_explores`

A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

do lightdash.organizations.delete_organization_member confirm_policy: **human**

Delete organization member?

**intent:** the user asked me to delete organization member

run suspended · waiting for a named person · key _lightdash-agent_ cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

```
account {
  op: "keys.create", name: "lightdash-agent",
  allowed_actions: ["lightdash.*"], cap_calls: 2000,
  confirm_policy: "human_for_writes",
  approval_rules: [
    { match: "lightdash.organizations.delete_organization_member", approver: "lead@example.com" },
    { match: "lightdash.user_groups.delete_group", approver: "lead@example.com" },
    { match: "lightdash.user_groups.remove_user_from_group", approver: "lead@example.com" }
  ]
}
```

Illustrative. Scoped to Lightdash only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

## What Lightdash costs on actionlake.

Every Lightdash action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Lightdash refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

- 1 upstream call per action all 831 Lightdash actions
- 831 actions page each page of a long list is one call
- 315 reads can be cached a cache hit costs nothing
- 100,000 calls a month, free paid plans from US$49 a month for 250,000

[See pricing](https://actionlake.com/pricing)

Action index

## Every Lightdash action.

831 actions by area: the id your agent calls, what it does, and its effect.

**AI agents 172**

- `lightdash.ai_agents.add_ai_agent_review_item_comment` Add AI agent review item comment write
- `lightdash.ai_agents.adopt_legacy_ai_provider_credential` Convert a legacy Bedrock configuration into a managed credential write
- `lightdash.ai_agents.append_instruction` Append instruction write
- `lightdash.ai_agents.append_to_evaluation` Append to evaluation write
- `lightdash.ai_agents.backfill_ai_review_jira_issues` Backfill AI review Jira issues write
- `lightdash.ai_agents.backfill_ai_review_linear_issues` Backfill AI review Linear issues write
- and 166 more in this area

**Projects 135**

- `lightdash.projects.create_dashboard` Create dashboard write
- `lightdash.projects.get_dashboards` List dashboards read
- `lightdash.projects.get_project` Get project read
- `lightdash.projects.list_charts_in_project` List charts in project read
- `lightdash.projects.calculate_subtotals_from_query` Calculate subtotals from query read
- `lightdash.projects.calculate_total_from_query` Calculate total from query read
- and 129 more in this area

**Organizations 70**

- `lightdash.organizations.create_group_in_organization` Create group write
- `lightdash.organizations.get_organization_member_by_uuid` Get organization member by UUID read
- `lightdash.organizations.list_groups_in_organization` List organization groups read
- `lightdash.organizations.list_organization_members` List organization members read
- `lightdash.organizations.activate_invite_link` Activate invite link write
- `lightdash.organizations.clear_default_organization_design` Clear default organization design destructive
- and 64 more in this area

**Catalog 27**

- `lightdash.catalog.acquire_metrics_tree_lock` Acquire tree lock write
- `lightdash.catalog.add_category_to_catalog_item` Add category to catalog item write
- `lightdash.catalog.create_metrics_tree` Create metrics tree write
- `lightdash.catalog.create_metrics_tree_edge` Create metrics tree edge write
- `lightdash.catalog.delete_metrics_tree` Delete metrics tree destructive
- `lightdash.catalog.delete_metrics_tree_edge` Delete metrics tree edge destructive
- and 21 more in this area

**My account 26**

- `lightdash.my_account.complete_redshift_aws_sso_warehouse_credentials` Complete Redshift AWS SSO login write
- `lightdash.my_account.complete_user_onboarding_tour` Complete onboarding tour write
- `lightdash.my_account.create_personal_access_token` Create personal access token write
- `lightdash.my_account.get_authenticated_user` Get authenticated user read
- `lightdash.my_account.create_email_one_time_passcode` Create email one-time passcode write
- `lightdash.my_account.create_warehouse_credentials` Create warehouse credentials write
- and 20 more in this area

**Roles 25**

- `lightdash.roles.create_organization_role` Create custom role write
- `lightdash.roles.duplicate_role` Duplicate role write
- `lightdash.roles.get_organization_role_assignees` List role assignees read
- `lightdash.roles.get_organization_role_assignments` List organization role assignments read
- `lightdash.roles.add_scopes_to_role` Add scopes to role destructive
- `lightdash.roles.delete_organization_role` Delete custom role destructive
- and 19 more in this area

**Homepage 22**

- `lightdash.homepage.create_project_announcement` Create project announcement write
- `lightdash.homepage.create_project_homepage` Create project homepage write
- `lightdash.homepage.get_homepage_assignments` Get homepage assignments read
- `lightdash.homepage.get_homepage_recently_viewed` Get homepage recently viewed read
- `lightdash.homepage.delete_project_announcement` Delete project announcement destructive
- `lightdash.homepage.delete_project_homepage` Delete project homepage destructive
- and 16 more in this area

**SQL runner 22**

- `lightdash.sql_runner.create_sql_chart` Create SQL chart write
- `lightdash.sql_runner.create_sql_chart_scheduler` Create SQL chart scheduler write
- `lightdash.sql_runner.create_virtual_view` Create virtual view write
- `lightdash.sql_runner.get_sql_chart_schedulers` List SQL chart schedulers read
- `lightdash.sql_runner.delete_sql_chart` Delete SQL chart destructive
- `lightdash.sql_runner.delete_virtual_view` Delete virtual view destructive
- and 16 more in this area

**Integrations 20**

- `lightdash.integrations.get_jira_issue_types` List Jira issue types read
- `lightdash.integrations.get_jira_projects` List Jira projects read
- `lightdash.integrations.get_jira_sites` List Jira sites read
- `lightdash.integrations.get_linear_projects` List Linear projects read
- `lightdash.integrations.delete_slack_install` Delete Slack installation destructive
- `lightdash.integrations.get_access_token` Get Google Drive access token read
- and 14 more in this area

**Query 20**

- `lightdash.query.download_results` Download results write
- `lightdash.query.estimate_async_metric_query` Estimate metric query read
- `lightdash.query.estimate_async_sql_query` Estimate SQL query read
- `lightdash.query.execute_async_calculate_total` Calculate totals read
- `lightdash.query.schedule_download_results` Download results write
- `lightdash.query.cancel_async_query` Cancel query destructive
- and 14 more in this area

**Scim 20**

- `lightdash.scim.create_scim_group` Create group write
- `lightdash.scim.create_scim_user` Create user write
- `lightdash.scim.get_scim_groups` List groups read
- `lightdash.scim.get_scim_resource_types` List resource types read
- `lightdash.scim.delete_scim_group` Delete group destructive
- `lightdash.scim.delete_scim_user` Delete user destructive
- and 14 more in this area

**Dashboards 18**

- `lightdash.dashboards.create_dashboard_scheduler` Create dashboard scheduler write
- `lightdash.dashboards.delete_project_dashboard` Delete dashboard destructive
- `lightdash.dashboards.get_project_dashboard` Get dashboard read
- `lightdash.dashboards.update_project_dashboard` Update dashboard write
- `lightdash.dashboards.delete_dashboard_custom_metric` Delete dashboard custom metric destructive
- `lightdash.dashboards.export_dashboard_content_v2` Export dashboard content write
- and 12 more in this area

**Documents 17**

- `lightdash.documents.create_document` Create document write
- `lightdash.documents.duplicate_document` Duplicate document write
- `lightdash.documents.execute_document_chart_query` Execute document chart query read
- `lightdash.documents.export_document_pdf` Export document as PDF write
- `lightdash.documents.get_document` Get document read
- `lightdash.documents.get_document_as_code` Get document as code read
- and 11 more in this area

**Schedulers 17**

- `lightdash.schedulers.get_scheduled_jobs` Get scheduled jobs read
- `lightdash.schedulers.get_scheduler_runs` List scheduler runs read
- `lightdash.schedulers.list_schedulers` List schedulers read
- `lightdash.schedulers.list_user_schedulers` List user schedulers read
- `lightdash.schedulers.delete_scheduler` Delete scheduler destructive
- `lightdash.schedulers.delete_scheduler_ai_augmentation` Delete scheduler AI augmentation destructive
- and 11 more in this area

**Charts 14**

- `lightdash.charts.calculate_total_from_saved_chart` Calculate total from saved chart read
- `lightdash.charts.create_saved_chart_scheduler` Create saved chart scheduler write
- `lightdash.charts.export_saved_chart_image` Export chart image write
- `lightdash.charts.get_chart_version_results` Get chart version results read
- `lightdash.charts.get_chart_history` Get chart version history read
- `lightdash.charts.get_chart_version` Get chart version read
- and 8 more in this area

**Content 14**

- `lightdash.content.bulk_move_content` Bulk move content write
- `lightdash.content.get_favorites` Get favorites read
- `lightdash.content.get_pinned_items` Get pinned items read
- `lightdash.content.get_recently_viewed` Get recently viewed read
- `lightdash.content.bulk_delete_content` Bulk delete content destructive
- `lightdash.content.delete_content` Delete content destructive
- and 8 more in this area

**Roles permissions 14**

- `lightdash.roles_permissions.create_space_in_project` Create space write
- `lightdash.roles_permissions.get_project_access_list` List project access read
- `lightdash.roles_permissions.get_space_access_list` List space access read
- `lightdash.roles_permissions.update_organization_member` Update organization member write
- `lightdash.roles_permissions.add_space_group_access` Grant group access to space destructive
- `lightdash.roles_permissions.add_space_user_access` Grant user access to space destructive
- and 8 more in this area

**Content review requests 11**

- `lightdash.content_review_requests.approve_content_review_request` Approve a review request write
- `lightdash.content_review_requests.compare_similar_content_for_review` Find related charts using names and query definitions read
- `lightdash.content_review_requests.create_content_review_request` Submit a review request write
- `lightdash.content_review_requests.find_similar_content_for_review` Find similar content read
- `lightdash.content_review_requests.cancel_content_review_request` Cancel your own review request destructive
- `lightdash.content_review_requests.get_content_review_request` Get a review request read
- and 5 more in this area

**Github 9**

- `lightdash.github.connect_github_mcp_server` Connect github mcp server write
- `lightdash.github.connect_github_mcp_server_app` Connect github mcp server app write
- `lightdash.github.create_github_repository` Create GitHub repository write
- `lightdash.github.get_github_list_repositories` List GitHub repositories read
- `lightdash.github.configuration_github_app_for_organization` Get GitHub App configuration read
- `lightdash.github.get_github_mcp_availability` Get github mcp availability read
- and 3 more in this area

**User groups 9**

- `lightdash.user_groups.delete_group` Delete group destructive
- `lightdash.user_groups.get_group` Get group read
- `lightdash.user_groups.get_group_members` Get group members read
- `lightdash.user_groups.update_group` Update group write
- `lightdash.user_groups.add_project_access_to_group` Add project access to group destructive
- `lightdash.user_groups.add_user_to_group` Add user to group write
- and 3 more in this area

**Code 8**

- `lightdash.code.upsert_code_custom_role` Upsert custom role as code write
- `lightdash.code.upsert_code_organization_group` Upsert code organization group write
- `lightdash.code.upsert_code_organization_user` Upsert code organization user write
- `lightdash.code.upsert_code_user_attribute` Upsert code user attribute write
- `lightdash.code.get_code_custom_roles` List custom roles as code read
- `lightdash.code.get_code_organization_groups` Get code organization groups read
- and 2 more in this area

**Spaces 8**

- `lightdash.spaces.get_code_spaces` List spaces as code read
- `lightdash.spaces.get_personal_space` Get personal space read
- `lightdash.spaces.upsert_code_space` Upsert space as code write
- `lightdash.spaces.upsert_space_as_code` Upsert space as code (deprecated) write
- `lightdash.spaces.delete_space` Delete space destructive
- `lightdash.spaces.get_space` Get space read
- and 2 more in this area

**Agent identity 7**

- `lightdash.agent_identity.get_organization_agent_identity_projects_without_ai_service_account` Get organization agent identity projects without ai service account read
- `lightdash.agent_identity.get_organization_agent_identity_settings` Get organization agent identity settings read
- `lightdash.agent_identity.get_organization_agent_identity_snowflake_setup` Get organization agent identity snowflake setup read
- `lightdash.agent_identity.verify_organization_agent_identity_snowflake_setup` Verify organization agent identity snowflake setup write
- `lightdash.agent_identity.update_organization_agent_identity_rule` Update organization agent identity rule write
- `lightdash.agent_identity.update_organization_agent_identity_settings` Update organization agent identity settings write
- and 1 more in this area

**AI access 7**

- `lightdash.ai_access.get_ai_service_account` Get ai service account read
- `lightdash.ai_access.get_capabilities_ai_access` Get capabilities ai access read
- `lightdash.ai_access.test_ai_service_account` Test ai service account write
- `lightdash.ai_access.test_marker_ai_access` Test marker ai access write
- `lightdash.ai_access.delete_ai_service_account` Delete ai service account destructive
- `lightdash.ai_access.get_my_access_ai_access` Get my access ai access read
- and 1 more in this area

**Agent connections 6**

- `lightdash.agent_connections.decide_approval` Decide approval write
- `lightdash.agent_connections.get_connection_status` Get connection status read
- `lightdash.agent_connections.list` List agent connections read
- `lightdash.agent_connections.request_approval` Request approval write
- `lightdash.agent_connections.review_approval` Review approval read
- `lightdash.agent_connections.revoke` Revoke agent connection destructive

**Direct access 6**

- `lightdash.direct_access.list_direct_access_assignments` List direct access read
- `lightdash.direct_access.list_direct_access_groups` List groups eligible for direct access read
- `lightdash.direct_access.list_direct_access_users` List users eligible for direct access read
- `lightdash.direct_access.replace_direct_access_role` Replace direct access role destructive
- `lightdash.direct_access.reset_direct_access` Reset direct access destructive
- `lightdash.direct_access.revoke_direct_access` Revoke direct access destructive

**Git files 6**

- `lightdash.git_files.create_git_branch` Create branch write
- `lightdash.git_files.create_git_pull_request` Create pull request write
- `lightdash.git_files.get_git_file_or_directory` Get file or directory read
- `lightdash.git_files.list_git_branches` List branches read
- `lightdash.git_files.delete_git_file` Delete file destructive
- `lightdash.git_files.save_git_file` Save file write

**Git integration 6**

- `lightdash.git_integration.create_pull_request_for_custom_dimensions` Create PR for custom dimensions write
- `lightdash.git_integration.create_pull_request_for_custom_metrics` Create PR for custom metrics write
- `lightdash.git_integration.create_pull_request_for_file_change` Create file PR write
- `lightdash.git_integration.preview_pull_request_for_custom_dimensions` Preview custom dimension YAML read
- `lightdash.git_integration.get_git_file_for_explore` Get explore file read
- `lightdash.git_integration.get_git_file_path_for_explore` Get explore file path read

**Service accounts 6**

- `lightdash.service_accounts.create_service_account` Create service account write
- `lightdash.service_accounts.get_service_account_project_grants` List service-account project grants read
- `lightdash.service_accounts.get_service_accounts` List service accounts read
- `lightdash.service_accounts.update_service_account` Update service account write
- `lightdash.service_accounts.delete_service_account` Delete service account destructive
- `lightdash.service_accounts.rotate_service_account` Rotate service account destructive

**Exploring 5**

- `lightdash.exploring.compile_merge_query` Compile merge query read
- `lightdash.exploring.post_run_underlying_data_query` Run underlying data query read
- `lightdash.exploring.run_merge_query` Run merge query read
- `lightdash.exploring.run_metric_query` Run metric query read
- `lightdash.exploring.run_sql_query` Run SQL query read

**Learn 5**

- `lightdash.learn.get_learn_workspace_command_output` Get workspace command output read
- `lightdash.learn.get_learn_workspace_file` Get workspace file read
- `lightdash.learn.list_learn_workspace_files` List workspace files read
- `lightdash.learn.run_learn_workspace_command` Run workspace command write
- `lightdash.learn.save_learn_workspace_file` Save workspace file write

**Organization warehouse credentials 5**

- `lightdash.organization_warehouse_credentials.create_organization_warehouse_credentials` Create warehouse credentials write
- `lightdash.organization_warehouse_credentials.get_organization_warehouse_credentials` Get warehouse credential read
- `lightdash.organization_warehouse_credentials.list_organization_warehouse_credentials` List warehouse credentials read
- `lightdash.organization_warehouse_credentials.update_organization_warehouse_credentials` Update warehouse credentials write
- `lightdash.organization_warehouse_credentials.delete_organization_warehouse_credentials` Delete warehouse credentials destructive

**Analytics project 4**

- `lightdash.analytics_project.delete_analytics_project` Delete the organization's internal analytics project destructive
- `lightdash.analytics_project.ensure_analytics_project` Ensure internal analytics project write
- `lightdash.analytics_project.get_analytics_project_status` Get internal analytics project status read
- `lightdash.analytics_project.install_analytics_sample_content` Install sample charts and dashboard in the internal analytics project write

**Comments 4**

- `lightdash.comments.create_comment` Create comment write
- `lightdash.comments.delete_comment` Delete comment destructive
- `lightdash.comments.get_comments` Get comments read
- `lightdash.comments.resolve_comment` Resolve comment write

**Feature flag 4**

- `lightdash.feature_flag.delete_feature_flag_override` Delete feature flag override destructive
- `lightdash.feature_flag.get_feature_flag` Get feature flag read
- `lightdash.feature_flag.list_feature_flags` List feature flags read
- `lightdash.feature_flag.set_feature_flag_override` Set feature flag override write

**Mobile push notifications 4**

- `lightdash.mobile_push_notifications.get_mobile_push_notification_status` Get mobile push notification status read
- `lightdash.mobile_push_notifications.register_mobile_push_installation` Register mobile push installation write
- `lightdash.mobile_push_notifications.register_mobile_push_live_activity_push_to_start_token` Register mobile push live activity push to start token write
- `lightdash.mobile_push_notifications.revoke_mobile_push_installation` Revoke mobile push installation destructive

**Pre aggregates 4**

- `lightdash.pre_aggregates.get_dashboard_pre_aggregate_audit` Get dashboard pre-aggregate audit read
- `lightdash.pre_aggregates.get_pre_aggregate_materializations` Get pre-aggregate materializations read
- `lightdash.pre_aggregates.get_pre_aggregate_stats` Get pre-aggregate stats read
- `lightdash.pre_aggregates.run_dashboard_pre_aggregate_audit` Run dashboard pre-aggregate audit write

**Project 4**

- `lightdash.project.add_deploy_batch` Add deploy batch write
- `lightdash.project.deploy_explores` Deploy explores destructive
- `lightdash.project.finalize_deploy_session` Finalize deploy write
- `lightdash.project.start_deploy_session` Start deploy session write

**Query sources 4**

- `lightdash.query_sources.execute_source_queries` Execute source queries read
- `lightdash.query_sources.get_source_query_status` Get source query status read
- `lightdash.query_sources.list_query_sources` List query sources read
- `lightdash.query_sources.scan_query_source_schema` Scan query source schema read

**Saved 4**

- `lightdash.saved.delete_project_saved_chart` Delete chart destructive
- `lightdash.saved.get_project_saved_chart` Get chart read
- `lightdash.saved.get_saved_chart_scheduler_runs` List chart scheduler runs read
- `lightdash.saved.get_saved_chart_schedulers` List chart schedulers read

**User attributes 4**

- `lightdash.user_attributes.create_user_attribute` Create user attribute write
- `lightdash.user_attributes.get_user_attributes` List user attributes read
- `lightdash.user_attributes.remove_user_attribute` Delete user attribute destructive
- `lightdash.user_attributes.update_user_attribute` Update user attribute write

**Agent permissions 3**

- `lightdash.agent_permissions.get_agent_capability_policy` Get agent capability policy read
- `lightdash.agent_permissions.reset_agent_capability_policy` Reset agent capability policy destructive
- `lightdash.agent_permissions.save_agent_capability_ceiling` Save agent capability ceiling write

**Metrics explorer 3**

- `lightdash.metrics_explorer.compile_metric_total_query` Compile metric total query read
- `lightdash.metrics_explorer.run_metric_series` Run metric series query read
- `lightdash.metrics_explorer.run_metric_total` Run metric total query read

**Parameters 3**

- `lightdash.parameters.get_project_parameters` Get project parameters read
- `lightdash.parameters.get_project_parameters_list` List project parameters read
- `lightdash.parameters.replace_project_parameters` Replace project parameters write

**Spotlight 3**

- `lightdash.spotlight.get_spotlight_table_config` Get spotlight table config read
- `lightdash.spotlight.post_spotlight_table_config` Update spotlight table config write
- `lightdash.spotlight.reset_spotlight_table_config` Reset spotlight table config destructive

**Validate 3**

- `lightdash.validate.get_validation_result` Get validation result read
- `lightdash.validate.get_validation_summary` Get validation summary read
- `lightdash.validate.list_validation_results` List validation results read

**AI agent live activities 2**

- `lightdash.ai_agent_live_activities.register_ai_agent_live_activity` Register ai agent live activity write
- `lightdash.ai_agent_live_activities.revoke_ai_agent_live_activity` Revoke ai agent live activity destructive

**Aws web identity 2**

- `lightdash.aws_web_identity.create_aws_web_identity_audience` Generate web identity audience write
- `lightdash.aws_web_identity.get_aws_web_identity` Get web identity subject read

**Defaults 2**

- `lightdash.defaults.get_project_defaults` Get project defaults read
- `lightdash.defaults.replace_project_defaults` Replace project defaults write

**Funnel 2**

- `lightdash.funnel.get_funnel_event_names` Get event names read
- `lightdash.funnel.run_funnel_query` Run funnel query read

**Gitlab 2**

- `lightdash.gitlab.get_gitlab_projects` List GitLab projects read
- `lightdash.gitlab.uninstall_gitlab_integration` Uninstall GitLab integration destructive

**Groups 2**

- `lightdash.groups.get_organization_groups_as_code` List organization groups as code (deprecated) read
- `lightdash.groups.upsert_organization_group_as_code` Upsert organization group as code (deprecated) write

**Notifications 2**

- `lightdash.notifications.get_notifications` Get notifications read
- `lightdash.notifications.update_notification` Update notification write

**Share links 2**

- `lightdash.share_links.create_share_url` Create share URL write
- `lightdash.share_links.get_share_url` Get share URL read

**Users 2**

- `lightdash.users.get_organization_users_as_code` List organization users as code (deprecated) read
- `lightdash.users.upsert_organization_user_as_code` Upsert organization user as code (deprecated) write

**Data catalog 1**

- `lightdash.data_catalog.get_paginated_metrics_with_time_dimensions` List metrics with time dimensions read

**Exports 1**

- `lightdash.exports.get_gsheet_export_status` Get export status read

**Map 1**

- `lightdash.map.get_geo_json` Proxy GeoJSON read

**Pull requests 1**

- `lightdash.pull_requests.list_pull_requests` List pull requests read

**SSH keypairs 1**

- `lightdash.ssh_keypairs.create_ssh_key_pair` Create SSH key pair write

This index shows a sample of each area. All 831 actions, with their inputs and prices, are in the [catalogue](https://actionlake.com/console/catalogue), which a free sandbox key can search.

Questions

## The Lightdash MCP server, answered.

**Is there a Lightdash MCP server for Claude?**

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 831 Lightdash actions across AI agents, projects, organizations and catalog, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Lightdash.

**What do I need to connect Lightdash?**

Lightdash personal access token. Plus your auth scheme and your host. The free call account { op: "connections.requirements", service: "lightdash" } lists exactly what to paste.

**Can an AI agent delete or change things in Lightdash?**

Only if its key allows it, and only with an explicit confirmation. 117 Lightdash actions are destructive, including delete organization member, delete group and remove user from group. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

**Will an AI agent use up my Lightdash API limit?**

actionlake paces every call to the limits in the Lightdash service file: 600 calls a minute per connection. Repeated reads are answered from cache (315 Lightdash actions can be), which never reaches Lightdash.

**What does a Lightdash action cost?**

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (831 Lightdash actions page). Cache hits, searches, dry runs and calls Lightdash refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

**Which Lightdash API does it cover?**

The Lightdash API v1/v2 3.39.0 (OpenAPI 3.0.0) at app.lightdash.cloud by default, or the base URL set when you connect. It is built from Lightdash's documentation as read on 23 October 2026. 831 actions in 60 areas, each one in the signed service file (version 1.0.0).

**Does actionlake keep my Lightdash data, and where?**

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Lightdash credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

**Which AI clients can use it?**

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

## More connectors like Lightdash

Shares the most action names with

- [Preset 19](https://actionlake.com/connectors/preset)
- [Sentry 18](https://actionlake.com/connectors/sentry)
- [Sigma Computing 14](https://actionlake.com/connectors/sigma-computing)
- [Looker 13](https://actionlake.com/connectors/looker)
- [Domo 13](https://actionlake.com/connectors/domo)
- [Databricks 10](https://actionlake.com/connectors/databricks)

Joins with, on shared entities

- [Unleash 4](https://actionlake.com/connectors/unleash)
- [Filevine 4](https://actionlake.com/connectors/filevine)
- [Toggl Track 4](https://actionlake.com/connectors/toggl-track)
- [JetBrains YouTrack 4](https://actionlake.com/connectors/jetbrains-youtrack)
- [Hubstaff 4](https://actionlake.com/connectors/hubstaff)
- [Clockify 4](https://actionlake.com/connectors/clockify)

Browse

- [All Observability & analytics connectors](https://actionlake.com/connectors/category/observability-and-analytics)
- [All connectors](https://actionlake.com/connectors)
- [How actionlake compares](https://actionlake.com/compare)

actionlake is independent. It is not made or endorsed by Lightdash; the name is the vendor's own. Counts are from the Lightdash service file, version 1.0.0.

## Give your agent Lightdash today.

[Connect Lightdash free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

---

Source: https://actionlake.com/connectors/lightdash
More: https://actionlake.com/llms.txt