Skip to content

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/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
  • 831actionsin one signed file
  • 400readlook, never change
  • 314writecreate and update
  • 117wait for a yesdestructive, 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_keyLightdash personal access token
    • auth_schemeYour Lightdash auth scheme
    • hostWhere 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 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
  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.

ActionWhat it doesEffectSame name in
lightdash.organizations.list_organization_membersList organization membersList organization members.readidentity.user.list474 connectors
lightdash.organizations.list_groups_in_organizationList organization groupsList organization groups.readidentity.group.list262 connectors
lightdash.my_account.get_authenticated_userGet authenticated userGet authenticated user.readidentity.current_user.get307 connectors
lightdash.organizations.create_group_in_organizationCreate groupCreate group.writeidentity.group.create205 connectors
lightdash.organizations.get_organization_member_by_uuidGet organization member by UUIDGet organization member by UUID.readidentity.user.get399 connectors
lightdash.organizations.delete_organization_memberDelete organization memberDelete organization member.destructiveidentity.user.delete253 connectors
lightdash.organizations.list_organization_projectsList organization projectsList organization projects.readwork.project.list109 connectors
lightdash.user_groups.get_group_membersGet group membersGet group members.readidentity.group_member.list103 connectors
lightdash.organizations.create_projectCreate projectCreate project.writework.project.create102 connectors
lightdash.projects.get_dashboardsList dashboardsList dashboards.readanalytics.dashboard.list22 connectors
lightdash.user_groups.add_user_to_groupAdd user to groupAdd user to group.writeidentity.group_member.add72 connectors
lightdash.projects.create_dashboardCreate dashboardCreate dashboard.writeanalytics.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.

  1. Readread

    Give me a one-line status for every active Lightdash project.

    callslightdash.organizations.list_organization_projects

  2. Writewrite

    Create group in Lightdash. Show me exactly what you will send before you save it.

    callslightdash.organizations.create_group_in_organization

Governance for Lightdash

Destructive actions wait for a yes.

117 Lightdash actions are destructive. The first 10:

  • Delete organization memberlightdash.organizations.delete_organization_member
  • Delete grouplightdash.user_groups.delete_group
  • Remove user from grouplightdash.user_groups.remove_user_from_group
  • Delete dashboardlightdash.dashboards.delete_project_dashboard
  • Delete chartlightdash.saved.delete_project_saved_chart
  • Delete taglightdash.projects.delete_tag
  • Delete spacelightdash.spaces.delete_space
  • Delete userlightdash.my_account.delete_me
  • Unverify chartlightdash.charts.unverify_chart
  • Set exploreslightdash.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.

dolightdash.organizations.delete_organization_memberconfirm_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: "[email protected]" },    { match: "lightdash.user_groups.delete_group", approver: "[email protected]" },    { match: "lightdash.user_groups.remove_user_from_group", approver: "[email protected]" }  ]}
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.

  • 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

See pricing

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 commentwrite
  • lightdash.ai_agents.adopt_legacy_ai_provider_credentialConvert a legacy Bedrock configuration into a managed credentialwrite
  • lightdash.ai_agents.append_instructionAppend instructionwrite
  • lightdash.ai_agents.append_to_evaluationAppend to evaluationwrite
  • lightdash.ai_agents.backfill_ai_review_jira_issuesBackfill AI review Jira issueswrite
  • lightdash.ai_agents.backfill_ai_review_linear_issuesBackfill AI review Linear issueswrite
  • and 166 more in this area
Projects135
  • lightdash.projects.create_dashboardCreate dashboardwrite
  • lightdash.projects.get_dashboardsList dashboardsread
  • lightdash.projects.get_projectGet projectread
  • lightdash.projects.list_charts_in_projectList charts in projectread
  • lightdash.projects.calculate_subtotals_from_queryCalculate subtotals from queryread
  • lightdash.projects.calculate_total_from_queryCalculate total from queryread
  • and 129 more in this area
Organizations70
  • lightdash.organizations.create_group_in_organizationCreate groupwrite
  • lightdash.organizations.get_organization_member_by_uuidGet organization member by UUIDread
  • lightdash.organizations.list_groups_in_organizationList organization groupsread
  • lightdash.organizations.list_organization_membersList organization membersread
  • lightdash.organizations.activate_invite_linkActivate invite linkwrite
  • lightdash.organizations.clear_default_organization_designClear default organization designdestructive
  • and 64 more in this area
Catalog27
  • lightdash.catalog.acquire_metrics_tree_lockAcquire tree lockwrite
  • lightdash.catalog.add_category_to_catalog_itemAdd category to catalog itemwrite
  • lightdash.catalog.create_metrics_treeCreate metrics treewrite
  • lightdash.catalog.create_metrics_tree_edgeCreate metrics tree edgewrite
  • lightdash.catalog.delete_metrics_treeDelete metrics treedestructive
  • lightdash.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 loginwrite
  • lightdash.my_account.complete_user_onboarding_tourComplete onboarding tourwrite
  • lightdash.my_account.create_personal_access_tokenCreate personal access tokenwrite
  • lightdash.my_account.get_authenticated_userGet authenticated userread
  • lightdash.my_account.create_email_one_time_passcodeCreate email one-time passcodewrite
  • lightdash.my_account.create_warehouse_credentialsCreate warehouse credentialswrite
  • and 20 more in this area
Roles25
  • lightdash.roles.create_organization_roleCreate custom rolewrite
  • lightdash.roles.duplicate_roleDuplicate rolewrite
  • lightdash.roles.get_organization_role_assigneesList role assigneesread
  • lightdash.roles.get_organization_role_assignmentsList organization role assignmentsread
  • lightdash.roles.add_scopes_to_roleAdd scopes to roledestructive
  • lightdash.roles.delete_organization_roleDelete custom roledestructive
  • and 19 more in this area
Homepage22
  • lightdash.homepage.create_project_announcementCreate project announcementwrite
  • lightdash.homepage.create_project_homepageCreate project homepagewrite
  • lightdash.homepage.get_homepage_assignmentsGet homepage assignmentsread
  • lightdash.homepage.get_homepage_recently_viewedGet homepage recently viewedread
  • lightdash.homepage.delete_project_announcementDelete project announcementdestructive
  • lightdash.homepage.delete_project_homepageDelete project homepagedestructive
  • and 16 more in this area
SQL runner22
  • lightdash.sql_runner.create_sql_chartCreate SQL chartwrite
  • lightdash.sql_runner.create_sql_chart_schedulerCreate SQL chart schedulerwrite
  • lightdash.sql_runner.create_virtual_viewCreate virtual viewwrite
  • lightdash.sql_runner.get_sql_chart_schedulersList SQL chart schedulersread
  • lightdash.sql_runner.delete_sql_chartDelete SQL chartdestructive
  • lightdash.sql_runner.delete_virtual_viewDelete virtual viewdestructive
  • and 16 more in this area
Integrations20
  • lightdash.integrations.get_jira_issue_typesList Jira issue typesread
  • lightdash.integrations.get_jira_projectsList Jira projectsread
  • lightdash.integrations.get_jira_sitesList Jira sitesread
  • lightdash.integrations.get_linear_projectsList Linear projectsread
  • lightdash.integrations.delete_slack_installDelete Slack installationdestructive
  • lightdash.integrations.get_access_tokenGet Google Drive access tokenread
  • and 14 more in this area
Query20
  • lightdash.query.download_resultsDownload resultswrite
  • lightdash.query.estimate_async_metric_queryEstimate metric queryread
  • lightdash.query.estimate_async_sql_queryEstimate SQL queryread
  • lightdash.query.execute_async_calculate_totalCalculate totalsread
  • lightdash.query.schedule_download_resultsDownload resultswrite
  • lightdash.query.cancel_async_queryCancel querydestructive
  • and 14 more in this area
Scim20
  • lightdash.scim.create_scim_groupCreate groupwrite
  • lightdash.scim.create_scim_userCreate userwrite
  • lightdash.scim.get_scim_groupsList groupsread
  • lightdash.scim.get_scim_resource_typesList resource typesread
  • lightdash.scim.delete_scim_groupDelete groupdestructive
  • lightdash.scim.delete_scim_userDelete userdestructive
  • and 14 more in this area
Dashboards18
  • lightdash.dashboards.create_dashboard_schedulerCreate dashboard schedulerwrite
  • lightdash.dashboards.delete_project_dashboardDelete dashboarddestructive
  • lightdash.dashboards.get_project_dashboardGet dashboardread
  • lightdash.dashboards.update_project_dashboardUpdate dashboardwrite
  • lightdash.dashboards.delete_dashboard_custom_metricDelete dashboard custom metricdestructive
  • lightdash.dashboards.export_dashboard_content_v2Export dashboard contentwrite
  • and 12 more in this area
Documents17
  • lightdash.documents.create_documentCreate documentwrite
  • lightdash.documents.duplicate_documentDuplicate documentwrite
  • lightdash.documents.execute_document_chart_queryExecute document chart queryread
  • lightdash.documents.export_document_pdfExport document as PDFwrite
  • lightdash.documents.get_documentGet documentread
  • lightdash.documents.get_document_as_codeGet document as coderead
  • and 11 more in this area
Schedulers17
  • lightdash.schedulers.get_scheduled_jobsGet scheduled jobsread
  • lightdash.schedulers.get_scheduler_runsList scheduler runsread
  • lightdash.schedulers.list_schedulersList schedulersread
  • lightdash.schedulers.list_user_schedulersList user schedulersread
  • lightdash.schedulers.delete_schedulerDelete schedulerdestructive
  • lightdash.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 chartread
  • lightdash.charts.create_saved_chart_schedulerCreate saved chart schedulerwrite
  • lightdash.charts.export_saved_chart_imageExport chart imagewrite
  • lightdash.charts.get_chart_version_resultsGet chart version resultsread
  • lightdash.charts.get_chart_historyGet chart version historyread
  • lightdash.charts.get_chart_versionGet chart versionread
  • and 8 more in this area
Content14
  • lightdash.content.bulk_move_contentBulk move contentwrite
  • lightdash.content.get_favoritesGet favoritesread
  • lightdash.content.get_pinned_itemsGet pinned itemsread
  • lightdash.content.get_recently_viewedGet recently viewedread
  • lightdash.content.bulk_delete_contentBulk delete contentdestructive
  • lightdash.content.delete_contentDelete contentdestructive
  • and 8 more in this area
Roles permissions14
  • lightdash.roles_permissions.create_space_in_projectCreate spacewrite
  • lightdash.roles_permissions.get_project_access_listList project accessread
  • lightdash.roles_permissions.get_space_access_listList space accessread
  • lightdash.roles_permissions.update_organization_memberUpdate organization memberwrite
  • lightdash.roles_permissions.add_space_group_accessGrant group access to spacedestructive
  • lightdash.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 requestwrite
  • lightdash.content_review_requests.compare_similar_content_for_reviewFind related charts using names and query definitionsread
  • lightdash.content_review_requests.create_content_review_requestSubmit a review requestwrite
  • lightdash.content_review_requests.find_similar_content_for_reviewFind similar contentread
  • lightdash.content_review_requests.cancel_content_review_requestCancel your own review requestdestructive
  • lightdash.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 serverwrite
  • lightdash.github.connect_github_mcp_server_appConnect github mcp server appwrite
  • lightdash.github.create_github_repositoryCreate GitHub repositorywrite
  • lightdash.github.get_github_list_repositoriesList GitHub repositoriesread
  • lightdash.github.configuration_github_app_for_organizationGet GitHub App configurationread
  • lightdash.github.get_github_mcp_availabilityGet github mcp availabilityread
  • and 3 more in this area
User groups9
  • lightdash.user_groups.delete_groupDelete groupdestructive
  • lightdash.user_groups.get_groupGet groupread
  • lightdash.user_groups.get_group_membersGet group membersread
  • lightdash.user_groups.update_groupUpdate groupwrite
  • lightdash.user_groups.add_project_access_to_groupAdd project access to groupdestructive
  • lightdash.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 codewrite
  • lightdash.code.upsert_code_organization_groupUpsert code organization groupwrite
  • lightdash.code.upsert_code_organization_userUpsert code organization userwrite
  • lightdash.code.upsert_code_user_attributeUpsert code user attributewrite
  • lightdash.code.get_code_custom_rolesList custom roles as coderead
  • lightdash.code.get_code_organization_groupsGet code organization groupsread
  • and 2 more in this area
Spaces8
  • lightdash.spaces.get_code_spacesList spaces as coderead
  • lightdash.spaces.get_personal_spaceGet personal spaceread
  • lightdash.spaces.upsert_code_spaceUpsert space as codewrite
  • lightdash.spaces.upsert_space_as_codeUpsert space as code (deprecated)write
  • lightdash.spaces.delete_spaceDelete spacedestructive
  • lightdash.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 accountread
  • lightdash.agent_identity.get_organization_agent_identity_settingsGet organization agent identity settingsread
  • lightdash.agent_identity.get_organization_agent_identity_snowflake_setupGet organization agent identity snowflake setupread
  • lightdash.agent_identity.verify_organization_agent_identity_snowflake_setupVerify organization agent identity snowflake setupwrite
  • lightdash.agent_identity.update_organization_agent_identity_ruleUpdate organization agent identity rulewrite
  • lightdash.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 accountread
  • lightdash.ai_access.get_capabilities_ai_accessGet capabilities ai accessread
  • lightdash.ai_access.test_ai_service_accountTest ai service accountwrite
  • lightdash.ai_access.test_marker_ai_accessTest marker ai accesswrite
  • lightdash.ai_access.delete_ai_service_accountDelete ai service accountdestructive
  • lightdash.ai_access.get_my_access_ai_accessGet my access ai accessread
  • and 1 more in this area
Agent connections6
  • lightdash.agent_connections.decide_approvalDecide approvalwrite
  • lightdash.agent_connections.get_connection_statusGet connection statusread
  • lightdash.agent_connections.listList agent connectionsread
  • lightdash.agent_connections.request_approvalRequest approvalwrite
  • lightdash.agent_connections.review_approvalReview approvalread
  • lightdash.agent_connections.revokeRevoke agent connectiondestructive
Direct access6
  • lightdash.direct_access.list_direct_access_assignmentsList direct accessread
  • lightdash.direct_access.list_direct_access_groupsList groups eligible for direct accessread
  • lightdash.direct_access.list_direct_access_usersList users eligible for direct accessread
  • lightdash.direct_access.replace_direct_access_roleReplace direct access roledestructive
  • lightdash.direct_access.reset_direct_accessReset direct accessdestructive
  • lightdash.direct_access.revoke_direct_accessRevoke direct accessdestructive
Git files6
  • lightdash.git_files.create_git_branchCreate branchwrite
  • lightdash.git_files.create_git_pull_requestCreate pull requestwrite
  • lightdash.git_files.get_git_file_or_directoryGet file or directoryread
  • lightdash.git_files.list_git_branchesList branchesread
  • lightdash.git_files.delete_git_fileDelete filedestructive
  • lightdash.git_files.save_git_fileSave filewrite
Git integration6
  • lightdash.git_integration.create_pull_request_for_custom_dimensionsCreate PR for custom dimensionswrite
  • lightdash.git_integration.create_pull_request_for_custom_metricsCreate PR for custom metricswrite
  • lightdash.git_integration.create_pull_request_for_file_changeCreate file PRwrite
  • lightdash.git_integration.preview_pull_request_for_custom_dimensionsPreview custom dimension YAMLread
  • lightdash.git_integration.get_git_file_for_exploreGet explore fileread
  • lightdash.git_integration.get_git_file_path_for_exploreGet explore file pathread
Service accounts6
  • lightdash.service_accounts.create_service_accountCreate service accountwrite
  • lightdash.service_accounts.get_service_account_project_grantsList service-account project grantsread
  • lightdash.service_accounts.get_service_accountsList service accountsread
  • lightdash.service_accounts.update_service_accountUpdate service accountwrite
  • lightdash.service_accounts.delete_service_accountDelete service accountdestructive
  • lightdash.service_accounts.rotate_service_accountRotate service accountdestructive
Exploring5
  • lightdash.exploring.compile_merge_queryCompile merge queryread
  • lightdash.exploring.post_run_underlying_data_queryRun underlying data queryread
  • lightdash.exploring.run_merge_queryRun merge queryread
  • lightdash.exploring.run_metric_queryRun metric queryread
  • lightdash.exploring.run_sql_queryRun SQL queryread
Learn5
  • lightdash.learn.get_learn_workspace_command_outputGet workspace command outputread
  • lightdash.learn.get_learn_workspace_fileGet workspace fileread
  • lightdash.learn.list_learn_workspace_filesList workspace filesread
  • lightdash.learn.run_learn_workspace_commandRun workspace commandwrite
  • lightdash.learn.save_learn_workspace_fileSave workspace filewrite
Organization warehouse credentials5
  • lightdash.organization_warehouse_credentials.create_organization_warehouse_credentialsCreate warehouse credentialswrite
  • lightdash.organization_warehouse_credentials.get_organization_warehouse_credentialsGet warehouse credentialread
  • lightdash.organization_warehouse_credentials.list_organization_warehouse_credentialsList warehouse credentialsread
  • lightdash.organization_warehouse_credentials.update_organization_warehouse_credentialsUpdate warehouse credentialswrite
  • lightdash.organization_warehouse_credentials.delete_organization_warehouse_credentialsDelete warehouse credentialsdestructive
Analytics project4
  • lightdash.analytics_project.delete_analytics_projectDelete the organization's internal analytics projectdestructive
  • lightdash.analytics_project.ensure_analytics_projectEnsure internal analytics projectwrite
  • lightdash.analytics_project.get_analytics_project_statusGet internal analytics project statusread
  • lightdash.analytics_project.install_analytics_sample_contentInstall sample charts and dashboard in the internal analytics projectwrite
Comments4
  • lightdash.comments.create_commentCreate commentwrite
  • lightdash.comments.delete_commentDelete commentdestructive
  • lightdash.comments.get_commentsGet commentsread
  • lightdash.comments.resolve_commentResolve commentwrite
Feature flag4
  • lightdash.feature_flag.delete_feature_flag_overrideDelete feature flag overridedestructive
  • lightdash.feature_flag.get_feature_flagGet feature flagread
  • lightdash.feature_flag.list_feature_flagsList feature flagsread
  • lightdash.feature_flag.set_feature_flag_overrideSet feature flag overridewrite
Mobile push notifications4
  • lightdash.mobile_push_notifications.get_mobile_push_notification_statusGet mobile push notification statusread
  • lightdash.mobile_push_notifications.register_mobile_push_installationRegister mobile push installationwrite
  • lightdash.mobile_push_notifications.register_mobile_push_live_activity_push_to_start_tokenRegister mobile push live activity push to start tokenwrite
  • lightdash.mobile_push_notifications.revoke_mobile_push_installationRevoke mobile push installationdestructive
Pre aggregates4
  • lightdash.pre_aggregates.get_dashboard_pre_aggregate_auditGet dashboard pre-aggregate auditread
  • lightdash.pre_aggregates.get_pre_aggregate_materializationsGet pre-aggregate materializationsread
  • lightdash.pre_aggregates.get_pre_aggregate_statsGet pre-aggregate statsread
  • lightdash.pre_aggregates.run_dashboard_pre_aggregate_auditRun dashboard pre-aggregate auditwrite
Project4
  • lightdash.project.add_deploy_batchAdd deploy batchwrite
  • lightdash.project.deploy_exploresDeploy exploresdestructive
  • lightdash.project.finalize_deploy_sessionFinalize deploywrite
  • lightdash.project.start_deploy_sessionStart deploy sessionwrite
Query sources4
  • lightdash.query_sources.execute_source_queriesExecute source queriesread
  • lightdash.query_sources.get_source_query_statusGet source query statusread
  • lightdash.query_sources.list_query_sourcesList query sourcesread
  • lightdash.query_sources.scan_query_source_schemaScan query source schemaread
Saved4
  • lightdash.saved.delete_project_saved_chartDelete chartdestructive
  • lightdash.saved.get_project_saved_chartGet chartread
  • lightdash.saved.get_saved_chart_scheduler_runsList chart scheduler runsread
  • lightdash.saved.get_saved_chart_schedulersList chart schedulersread
User attributes4
  • lightdash.user_attributes.create_user_attributeCreate user attributewrite
  • lightdash.user_attributes.get_user_attributesList user attributesread
  • lightdash.user_attributes.remove_user_attributeDelete user attributedestructive
  • lightdash.user_attributes.update_user_attributeUpdate user attributewrite
Agent permissions3
  • lightdash.agent_permissions.get_agent_capability_policyGet agent capability policyread
  • lightdash.agent_permissions.reset_agent_capability_policyReset agent capability policydestructive
  • lightdash.agent_permissions.save_agent_capability_ceilingSave agent capability ceilingwrite
Metrics explorer3
  • lightdash.metrics_explorer.compile_metric_total_queryCompile metric total queryread
  • lightdash.metrics_explorer.run_metric_seriesRun metric series queryread
  • lightdash.metrics_explorer.run_metric_totalRun metric total queryread
Parameters3
  • lightdash.parameters.get_project_parametersGet project parametersread
  • lightdash.parameters.get_project_parameters_listList project parametersread
  • lightdash.parameters.replace_project_parametersReplace project parameterswrite
Spotlight3
  • lightdash.spotlight.get_spotlight_table_configGet spotlight table configread
  • lightdash.spotlight.post_spotlight_table_configUpdate spotlight table configwrite
  • lightdash.spotlight.reset_spotlight_table_configReset spotlight table configdestructive
Validate3
  • lightdash.validate.get_validation_resultGet validation resultread
  • lightdash.validate.get_validation_summaryGet validation summaryread
  • lightdash.validate.list_validation_resultsList validation resultsread
AI agent live activities2
  • lightdash.ai_agent_live_activities.register_ai_agent_live_activityRegister ai agent live activitywrite
  • lightdash.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 audiencewrite
  • lightdash.aws_web_identity.get_aws_web_identityGet web identity subjectread
Defaults2
  • lightdash.defaults.get_project_defaultsGet project defaultsread
  • lightdash.defaults.replace_project_defaultsReplace project defaultswrite
Funnel2
  • lightdash.funnel.get_funnel_event_namesGet event namesread
  • lightdash.funnel.run_funnel_queryRun funnel queryread
Gitlab2
  • lightdash.gitlab.get_gitlab_projectsList GitLab projectsread
  • lightdash.gitlab.uninstall_gitlab_integrationUninstall GitLab integrationdestructive
Groups2
  • lightdash.groups.get_organization_groups_as_codeList organization groups as code (deprecated)read
  • lightdash.groups.upsert_organization_group_as_codeUpsert organization group as code (deprecated)write
Notifications2
  • lightdash.notifications.get_notificationsGet notificationsread
  • lightdash.notifications.update_notificationUpdate notificationwrite
Share links2
  • lightdash.share_links.create_share_urlCreate share URLwrite
  • lightdash.share_links.get_share_urlGet share URLread
Users2
  • lightdash.users.get_organization_users_as_codeList organization users as code (deprecated)read
  • lightdash.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.