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.
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/mcpdo { action: "lightdash.organizations.list_organization_members", intent: "check which Lightdash account is connected"}# List organization members · read · 1 upstream call- 831actionsin one signed file
- 400readlook, never change
- 314writecreate and update
- 117wait for a yesdestructive, confirmed first
Set up
Connect Lightdash in three steps.
- 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 - 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_keyLightdash personal access tokenauth_schemeYour Lightdash auth schemehostWhere your Lightdash lives: your host
account { op: "connections.requirements", service: "lightdash" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "lightdash.organizations.list_organization_members" }# list organization members · read · 1 upstream callcheck { 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_schemehost- 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 2026OpenAPI spec (GitHub)docs.lightdash.com
- 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.
- 400readlook, never change
- 314writecreate and update
- 117destructivewait for a confirmation
AI agents
17281 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
Projects
13567 read · 62 write · 6 destructive
List dashboards · Get project · Create dashboard · List charts in project
Organizations
7025 read · 30 write · 15 destructive
List organization members · List organization groups · Create group · Get organization member by UUID
Catalog
2716 read · 7 write · 4 destructive
Acquire tree lock · Add category to catalog item · Create metrics tree · Create metrics tree edge
My account
269 read · 11 write · 6 destructive
Get authenticated user · Complete Redshift AWS SSO login · Complete onboarding tour · Create personal access token
Roles
259 read · 4 write · 12 destructive
Create custom role · Duplicate role · List role assignees · List organization role assignments
Homepage
2210 read · 8 write · 4 destructive
Create project announcement · Create project homepage · Get homepage assignments · Get homepage recently viewed
SQL runner
2211 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_membersList organization members | List organization members. | read | identity.user.list474 connectors |
lightdash.organizations.list_groups_in_organizationList organization groups | List organization groups. | read | identity.group.list262 connectors |
lightdash.my_account.get_authenticated_userGet authenticated user | Get authenticated user. | read | identity.current_user.get307 connectors |
lightdash.organizations.create_group_in_organizationCreate group | Create group. | write | identity.group.create205 connectors |
lightdash.organizations.get_organization_member_by_uuidGet organization member by UUID | Get organization member by UUID. | read | identity.user.get399 connectors |
lightdash.organizations.delete_organization_memberDelete organization member | Delete organization member. | destructive | identity.user.delete253 connectors |
lightdash.organizations.list_organization_projectsList organization projects | List organization projects. | read | work.project.list109 connectors |
lightdash.user_groups.get_group_membersGet group members | Get group members. | read | identity.group_member.list103 connectors |
lightdash.organizations.create_projectCreate project | Create project. | write | work.project.create102 connectors |
lightdash.projects.get_dashboardsList dashboards | List dashboards. | read | analytics.dashboard.list22 connectors |
lightdash.user_groups.add_user_to_groupAdd user to group | Add user to group. | write | identity.group_member.add72 connectors |
lightdash.projects.create_dashboardCreate dashboard | Create dashboard. | write | analytics.dashboard.create18 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.
- Readread
Give me a one-line status for every active Lightdash project.
calls
lightdash.organizations.list_organization_projects - Writewrite
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.
Delete organization member?
intent: the user asked me to delete organization member
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: "[email protected]" }, { match: "lightdash.user_groups.delete_group", approver: "[email protected]" }, { match: "lightdash.user_groups.remove_user_from_group", approver: "[email protected]" } ]}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.
- 1upstream call per actionall 831 Lightdash actions
- 831actions pageeach page of a long list is one call
- 315reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Lightdash action.
831 actions by area: the id your agent calls, what it does, and its effect.
AI agents172
lightdash.ai_agents.add_ai_agent_review_item_commentAdd AI agent review item commentwritelightdash.ai_agents.adopt_legacy_ai_provider_credentialConvert a legacy Bedrock configuration into a managed credentialwritelightdash.ai_agents.append_instructionAppend instructionwritelightdash.ai_agents.append_to_evaluationAppend to evaluationwritelightdash.ai_agents.backfill_ai_review_jira_issuesBackfill AI review Jira issueswritelightdash.ai_agents.backfill_ai_review_linear_issuesBackfill AI review Linear issueswrite- and 166 more in this area
Projects135
lightdash.projects.create_dashboardCreate dashboardwritelightdash.projects.get_dashboardsList dashboardsreadlightdash.projects.get_projectGet projectreadlightdash.projects.list_charts_in_projectList charts in projectreadlightdash.projects.calculate_subtotals_from_queryCalculate subtotals from queryreadlightdash.projects.calculate_total_from_queryCalculate total from queryread- and 129 more in this area
Organizations70
lightdash.organizations.create_group_in_organizationCreate groupwritelightdash.organizations.get_organization_member_by_uuidGet organization member by UUIDreadlightdash.organizations.list_groups_in_organizationList organization groupsreadlightdash.organizations.list_organization_membersList organization membersreadlightdash.organizations.activate_invite_linkActivate invite linkwritelightdash.organizations.clear_default_organization_designClear default organization designdestructive- and 64 more in this area
Catalog27
lightdash.catalog.acquire_metrics_tree_lockAcquire tree lockwritelightdash.catalog.add_category_to_catalog_itemAdd category to catalog itemwritelightdash.catalog.create_metrics_treeCreate metrics treewritelightdash.catalog.create_metrics_tree_edgeCreate metrics tree edgewritelightdash.catalog.delete_metrics_treeDelete metrics treedestructivelightdash.catalog.delete_metrics_tree_edgeDelete metrics tree edgedestructive- and 21 more in this area
My account26
lightdash.my_account.complete_redshift_aws_sso_warehouse_credentialsComplete Redshift AWS SSO loginwritelightdash.my_account.complete_user_onboarding_tourComplete onboarding tourwritelightdash.my_account.create_personal_access_tokenCreate personal access tokenwritelightdash.my_account.get_authenticated_userGet authenticated userreadlightdash.my_account.create_email_one_time_passcodeCreate email one-time passcodewritelightdash.my_account.create_warehouse_credentialsCreate warehouse credentialswrite- and 20 more in this area
Roles25
lightdash.roles.create_organization_roleCreate custom rolewritelightdash.roles.duplicate_roleDuplicate rolewritelightdash.roles.get_organization_role_assigneesList role assigneesreadlightdash.roles.get_organization_role_assignmentsList organization role assignmentsreadlightdash.roles.add_scopes_to_roleAdd scopes to roledestructivelightdash.roles.delete_organization_roleDelete custom roledestructive- and 19 more in this area
Homepage22
lightdash.homepage.create_project_announcementCreate project announcementwritelightdash.homepage.create_project_homepageCreate project homepagewritelightdash.homepage.get_homepage_assignmentsGet homepage assignmentsreadlightdash.homepage.get_homepage_recently_viewedGet homepage recently viewedreadlightdash.homepage.delete_project_announcementDelete project announcementdestructivelightdash.homepage.delete_project_homepageDelete project homepagedestructive- and 16 more in this area
SQL runner22
lightdash.sql_runner.create_sql_chartCreate SQL chartwritelightdash.sql_runner.create_sql_chart_schedulerCreate SQL chart schedulerwritelightdash.sql_runner.create_virtual_viewCreate virtual viewwritelightdash.sql_runner.get_sql_chart_schedulersList SQL chart schedulersreadlightdash.sql_runner.delete_sql_chartDelete SQL chartdestructivelightdash.sql_runner.delete_virtual_viewDelete virtual viewdestructive- and 16 more in this area
Integrations20
lightdash.integrations.get_jira_issue_typesList Jira issue typesreadlightdash.integrations.get_jira_projectsList Jira projectsreadlightdash.integrations.get_jira_sitesList Jira sitesreadlightdash.integrations.get_linear_projectsList Linear projectsreadlightdash.integrations.delete_slack_installDelete Slack installationdestructivelightdash.integrations.get_access_tokenGet Google Drive access tokenread- and 14 more in this area
Query20
lightdash.query.download_resultsDownload resultswritelightdash.query.estimate_async_metric_queryEstimate metric queryreadlightdash.query.estimate_async_sql_queryEstimate SQL queryreadlightdash.query.execute_async_calculate_totalCalculate totalsreadlightdash.query.schedule_download_resultsDownload resultswritelightdash.query.cancel_async_queryCancel querydestructive- and 14 more in this area
Scim20
lightdash.scim.create_scim_groupCreate groupwritelightdash.scim.create_scim_userCreate userwritelightdash.scim.get_scim_groupsList groupsreadlightdash.scim.get_scim_resource_typesList resource typesreadlightdash.scim.delete_scim_groupDelete groupdestructivelightdash.scim.delete_scim_userDelete userdestructive- and 14 more in this area
Dashboards18
lightdash.dashboards.create_dashboard_schedulerCreate dashboard schedulerwritelightdash.dashboards.delete_project_dashboardDelete dashboarddestructivelightdash.dashboards.get_project_dashboardGet dashboardreadlightdash.dashboards.update_project_dashboardUpdate dashboardwritelightdash.dashboards.delete_dashboard_custom_metricDelete dashboard custom metricdestructivelightdash.dashboards.export_dashboard_content_v2Export dashboard contentwrite- and 12 more in this area
Documents17
lightdash.documents.create_documentCreate documentwritelightdash.documents.duplicate_documentDuplicate documentwritelightdash.documents.execute_document_chart_queryExecute document chart queryreadlightdash.documents.export_document_pdfExport document as PDFwritelightdash.documents.get_documentGet documentreadlightdash.documents.get_document_as_codeGet document as coderead- and 11 more in this area
Schedulers17
lightdash.schedulers.get_scheduled_jobsGet scheduled jobsreadlightdash.schedulers.get_scheduler_runsList scheduler runsreadlightdash.schedulers.list_schedulersList schedulersreadlightdash.schedulers.list_user_schedulersList user schedulersreadlightdash.schedulers.delete_schedulerDelete schedulerdestructivelightdash.schedulers.delete_scheduler_ai_augmentationDelete scheduler AI augmentationdestructive- and 11 more in this area
Charts14
lightdash.charts.calculate_total_from_saved_chartCalculate total from saved chartreadlightdash.charts.create_saved_chart_schedulerCreate saved chart schedulerwritelightdash.charts.export_saved_chart_imageExport chart imagewritelightdash.charts.get_chart_version_resultsGet chart version resultsreadlightdash.charts.get_chart_historyGet chart version historyreadlightdash.charts.get_chart_versionGet chart versionread- and 8 more in this area
Content14
lightdash.content.bulk_move_contentBulk move contentwritelightdash.content.get_favoritesGet favoritesreadlightdash.content.get_pinned_itemsGet pinned itemsreadlightdash.content.get_recently_viewedGet recently viewedreadlightdash.content.bulk_delete_contentBulk delete contentdestructivelightdash.content.delete_contentDelete contentdestructive- and 8 more in this area
Roles permissions14
lightdash.roles_permissions.create_space_in_projectCreate spacewritelightdash.roles_permissions.get_project_access_listList project accessreadlightdash.roles_permissions.get_space_access_listList space accessreadlightdash.roles_permissions.update_organization_memberUpdate organization memberwritelightdash.roles_permissions.add_space_group_accessGrant group access to spacedestructivelightdash.roles_permissions.add_space_user_accessGrant user access to spacedestructive- and 8 more in this area
Content review requests11
lightdash.content_review_requests.approve_content_review_requestApprove a review requestwritelightdash.content_review_requests.compare_similar_content_for_reviewFind related charts using names and query definitionsreadlightdash.content_review_requests.create_content_review_requestSubmit a review requestwritelightdash.content_review_requests.find_similar_content_for_reviewFind similar contentreadlightdash.content_review_requests.cancel_content_review_requestCancel your own review requestdestructivelightdash.content_review_requests.get_content_review_requestGet a review requestread- and 5 more in this area
Github9
lightdash.github.connect_github_mcp_serverConnect github mcp serverwritelightdash.github.connect_github_mcp_server_appConnect github mcp server appwritelightdash.github.create_github_repositoryCreate GitHub repositorywritelightdash.github.get_github_list_repositoriesList GitHub repositoriesreadlightdash.github.configuration_github_app_for_organizationGet GitHub App configurationreadlightdash.github.get_github_mcp_availabilityGet github mcp availabilityread- and 3 more in this area
User groups9
lightdash.user_groups.delete_groupDelete groupdestructivelightdash.user_groups.get_groupGet groupreadlightdash.user_groups.get_group_membersGet group membersreadlightdash.user_groups.update_groupUpdate groupwritelightdash.user_groups.add_project_access_to_groupAdd project access to groupdestructivelightdash.user_groups.add_user_to_groupAdd user to groupwrite- and 3 more in this area
Code8
lightdash.code.upsert_code_custom_roleUpsert custom role as codewritelightdash.code.upsert_code_organization_groupUpsert code organization groupwritelightdash.code.upsert_code_organization_userUpsert code organization userwritelightdash.code.upsert_code_user_attributeUpsert code user attributewritelightdash.code.get_code_custom_rolesList custom roles as codereadlightdash.code.get_code_organization_groupsGet code organization groupsread- and 2 more in this area
Spaces8
lightdash.spaces.get_code_spacesList spaces as codereadlightdash.spaces.get_personal_spaceGet personal spacereadlightdash.spaces.upsert_code_spaceUpsert space as codewritelightdash.spaces.upsert_space_as_codeUpsert space as code (deprecated)writelightdash.spaces.delete_spaceDelete spacedestructivelightdash.spaces.get_spaceGet spaceread- and 2 more in this area
Agent identity7
lightdash.agent_identity.get_organization_agent_identity_projects_without_ai_service_accountGet organization agent identity projects without ai service accountreadlightdash.agent_identity.get_organization_agent_identity_settingsGet organization agent identity settingsreadlightdash.agent_identity.get_organization_agent_identity_snowflake_setupGet organization agent identity snowflake setupreadlightdash.agent_identity.verify_organization_agent_identity_snowflake_setupVerify organization agent identity snowflake setupwritelightdash.agent_identity.update_organization_agent_identity_ruleUpdate organization agent identity rulewritelightdash.agent_identity.update_organization_agent_identity_settingsUpdate organization agent identity settingswrite- and 1 more in this area
AI access7
lightdash.ai_access.get_ai_service_accountGet ai service accountreadlightdash.ai_access.get_capabilities_ai_accessGet capabilities ai accessreadlightdash.ai_access.test_ai_service_accountTest ai service accountwritelightdash.ai_access.test_marker_ai_accessTest marker ai accesswritelightdash.ai_access.delete_ai_service_accountDelete ai service accountdestructivelightdash.ai_access.get_my_access_ai_accessGet my access ai accessread- and 1 more in this area
Agent connections6
lightdash.agent_connections.decide_approvalDecide approvalwritelightdash.agent_connections.get_connection_statusGet connection statusreadlightdash.agent_connections.listList agent connectionsreadlightdash.agent_connections.request_approvalRequest approvalwritelightdash.agent_connections.review_approvalReview approvalreadlightdash.agent_connections.revokeRevoke agent connectiondestructive
Direct access6
lightdash.direct_access.list_direct_access_assignmentsList direct accessreadlightdash.direct_access.list_direct_access_groupsList groups eligible for direct accessreadlightdash.direct_access.list_direct_access_usersList users eligible for direct accessreadlightdash.direct_access.replace_direct_access_roleReplace direct access roledestructivelightdash.direct_access.reset_direct_accessReset direct accessdestructivelightdash.direct_access.revoke_direct_accessRevoke direct accessdestructive
Git files6
lightdash.git_files.create_git_branchCreate branchwritelightdash.git_files.create_git_pull_requestCreate pull requestwritelightdash.git_files.get_git_file_or_directoryGet file or directoryreadlightdash.git_files.list_git_branchesList branchesreadlightdash.git_files.delete_git_fileDelete filedestructivelightdash.git_files.save_git_fileSave filewrite
Git integration6
lightdash.git_integration.create_pull_request_for_custom_dimensionsCreate PR for custom dimensionswritelightdash.git_integration.create_pull_request_for_custom_metricsCreate PR for custom metricswritelightdash.git_integration.create_pull_request_for_file_changeCreate file PRwritelightdash.git_integration.preview_pull_request_for_custom_dimensionsPreview custom dimension YAMLreadlightdash.git_integration.get_git_file_for_exploreGet explore filereadlightdash.git_integration.get_git_file_path_for_exploreGet explore file pathread
Service accounts6
lightdash.service_accounts.create_service_accountCreate service accountwritelightdash.service_accounts.get_service_account_project_grantsList service-account project grantsreadlightdash.service_accounts.get_service_accountsList service accountsreadlightdash.service_accounts.update_service_accountUpdate service accountwritelightdash.service_accounts.delete_service_accountDelete service accountdestructivelightdash.service_accounts.rotate_service_accountRotate service accountdestructive
Exploring5
lightdash.exploring.compile_merge_queryCompile merge queryreadlightdash.exploring.post_run_underlying_data_queryRun underlying data queryreadlightdash.exploring.run_merge_queryRun merge queryreadlightdash.exploring.run_metric_queryRun metric queryreadlightdash.exploring.run_sql_queryRun SQL queryread
Learn5
lightdash.learn.get_learn_workspace_command_outputGet workspace command outputreadlightdash.learn.get_learn_workspace_fileGet workspace filereadlightdash.learn.list_learn_workspace_filesList workspace filesreadlightdash.learn.run_learn_workspace_commandRun workspace commandwritelightdash.learn.save_learn_workspace_fileSave workspace filewrite
Organization warehouse credentials5
lightdash.organization_warehouse_credentials.create_organization_warehouse_credentialsCreate warehouse credentialswritelightdash.organization_warehouse_credentials.get_organization_warehouse_credentialsGet warehouse credentialreadlightdash.organization_warehouse_credentials.list_organization_warehouse_credentialsList warehouse credentialsreadlightdash.organization_warehouse_credentials.update_organization_warehouse_credentialsUpdate warehouse credentialswritelightdash.organization_warehouse_credentials.delete_organization_warehouse_credentialsDelete warehouse credentialsdestructive
Analytics project4
lightdash.analytics_project.delete_analytics_projectDelete the organization's internal analytics projectdestructivelightdash.analytics_project.ensure_analytics_projectEnsure internal analytics projectwritelightdash.analytics_project.get_analytics_project_statusGet internal analytics project statusreadlightdash.analytics_project.install_analytics_sample_contentInstall sample charts and dashboard in the internal analytics projectwrite
Comments4
lightdash.comments.create_commentCreate commentwritelightdash.comments.delete_commentDelete commentdestructivelightdash.comments.get_commentsGet commentsreadlightdash.comments.resolve_commentResolve commentwrite
Feature flag4
lightdash.feature_flag.delete_feature_flag_overrideDelete feature flag overridedestructivelightdash.feature_flag.get_feature_flagGet feature flagreadlightdash.feature_flag.list_feature_flagsList feature flagsreadlightdash.feature_flag.set_feature_flag_overrideSet feature flag overridewrite
Mobile push notifications4
lightdash.mobile_push_notifications.get_mobile_push_notification_statusGet mobile push notification statusreadlightdash.mobile_push_notifications.register_mobile_push_installationRegister mobile push installationwritelightdash.mobile_push_notifications.register_mobile_push_live_activity_push_to_start_tokenRegister mobile push live activity push to start tokenwritelightdash.mobile_push_notifications.revoke_mobile_push_installationRevoke mobile push installationdestructive
Pre aggregates4
lightdash.pre_aggregates.get_dashboard_pre_aggregate_auditGet dashboard pre-aggregate auditreadlightdash.pre_aggregates.get_pre_aggregate_materializationsGet pre-aggregate materializationsreadlightdash.pre_aggregates.get_pre_aggregate_statsGet pre-aggregate statsreadlightdash.pre_aggregates.run_dashboard_pre_aggregate_auditRun dashboard pre-aggregate auditwrite
Project4
lightdash.project.add_deploy_batchAdd deploy batchwritelightdash.project.deploy_exploresDeploy exploresdestructivelightdash.project.finalize_deploy_sessionFinalize deploywritelightdash.project.start_deploy_sessionStart deploy sessionwrite
Query sources4
lightdash.query_sources.execute_source_queriesExecute source queriesreadlightdash.query_sources.get_source_query_statusGet source query statusreadlightdash.query_sources.list_query_sourcesList query sourcesreadlightdash.query_sources.scan_query_source_schemaScan query source schemaread
Saved4
lightdash.saved.delete_project_saved_chartDelete chartdestructivelightdash.saved.get_project_saved_chartGet chartreadlightdash.saved.get_saved_chart_scheduler_runsList chart scheduler runsreadlightdash.saved.get_saved_chart_schedulersList chart schedulersread
User attributes4
lightdash.user_attributes.create_user_attributeCreate user attributewritelightdash.user_attributes.get_user_attributesList user attributesreadlightdash.user_attributes.remove_user_attributeDelete user attributedestructivelightdash.user_attributes.update_user_attributeUpdate user attributewrite
Agent permissions3
lightdash.agent_permissions.get_agent_capability_policyGet agent capability policyreadlightdash.agent_permissions.reset_agent_capability_policyReset agent capability policydestructivelightdash.agent_permissions.save_agent_capability_ceilingSave agent capability ceilingwrite
Metrics explorer3
lightdash.metrics_explorer.compile_metric_total_queryCompile metric total queryreadlightdash.metrics_explorer.run_metric_seriesRun metric series queryreadlightdash.metrics_explorer.run_metric_totalRun metric total queryread
Parameters3
lightdash.parameters.get_project_parametersGet project parametersreadlightdash.parameters.get_project_parameters_listList project parametersreadlightdash.parameters.replace_project_parametersReplace project parameterswrite
Spotlight3
lightdash.spotlight.get_spotlight_table_configGet spotlight table configreadlightdash.spotlight.post_spotlight_table_configUpdate spotlight table configwritelightdash.spotlight.reset_spotlight_table_configReset spotlight table configdestructive
Validate3
lightdash.validate.get_validation_resultGet validation resultreadlightdash.validate.get_validation_summaryGet validation summaryreadlightdash.validate.list_validation_resultsList validation resultsread
AI agent live activities2
lightdash.ai_agent_live_activities.register_ai_agent_live_activityRegister ai agent live activitywritelightdash.ai_agent_live_activities.revoke_ai_agent_live_activityRevoke ai agent live activitydestructive
Aws web identity2
lightdash.aws_web_identity.create_aws_web_identity_audienceGenerate web identity audiencewritelightdash.aws_web_identity.get_aws_web_identityGet web identity subjectread
Defaults2
lightdash.defaults.get_project_defaultsGet project defaultsreadlightdash.defaults.replace_project_defaultsReplace project defaultswrite
Funnel2
lightdash.funnel.get_funnel_event_namesGet event namesreadlightdash.funnel.run_funnel_queryRun funnel queryread
Gitlab2
lightdash.gitlab.get_gitlab_projectsList GitLab projectsreadlightdash.gitlab.uninstall_gitlab_integrationUninstall GitLab integrationdestructive
Groups2
lightdash.groups.get_organization_groups_as_codeList organization groups as code (deprecated)readlightdash.groups.upsert_organization_group_as_codeUpsert organization group as code (deprecated)write
Notifications2
lightdash.notifications.get_notificationsGet notificationsreadlightdash.notifications.update_notificationUpdate notificationwrite
Share links2
lightdash.share_links.create_share_urlCreate share URLwritelightdash.share_links.get_share_urlGet share URLread
Users2
lightdash.users.get_organization_users_as_codeList organization users as code (deprecated)readlightdash.users.upsert_organization_user_as_codeUpsert organization user as code (deprecated)write
Data catalog1
lightdash.data_catalog.get_paginated_metrics_with_time_dimensionsList metrics with time dimensionsread
Exports1
lightdash.exports.get_gsheet_export_statusGet export statusread
Map1
lightdash.map.get_geo_jsonProxy GeoJSONread
Pull requests1
lightdash.pull_requests.list_pull_requestsList pull requestsread
SSH keypairs1
lightdash.ssh_keypairs.create_ssh_key_pairCreate SSH key pairwrite
This index shows a sample of each area. All 831 actions, with their inputs and prices, are in the 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.
Give your agent Lightdash today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.