Skip to content

Update from code changes: document resolve_url tool for AI agents / MCP #983

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update from code changes: document resolve_url tool for AI agents / MCP #983

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions references/integrations/lightdash-mcp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -359,6 +359,15 @@ MCP provides AI assistants with powerful tools to interact with your Lightdash d
- **Find content** - Search for existing spaces, charts, and dashboards by name or description. Results include space breadcrumbs and direct links. Optionally scope the search to a single space (and its descendants) by passing a space slug.
- **List content** - Browse accessible content as a hierarchy. By default it returns root-level spaces; pass a space slug to list the charts, dashboards, and nested spaces directly inside that space. Use this when you want the agent to walk space → content rather than search by keyword.
- **List verified content** - Discover charts and dashboards that admins have marked as verified, so agents can reference trusted, canonical patterns when building new content. If you want your agent to prefer verified patterns, ask it to in your prompt (e.g. _"Use verified charts as the reference for any new chart you build."_).
- **Resolve URL** (`resolve_url`) - Expand a Lightdash share link (`<siteUrl>/share/<id>`) into the full destination URL so the agent can read the project, chart, dashboard, or explore identifiers from the path and act on them. Use this when a user pastes a `/share/...` link into a chat — the tool only follows the redirect, so pair it with `read_content` (or any other read tool) to fetch the underlying content. Access is enforced through the same sharing permissions as the Lightdash app, so an agent can only expand links the current user can see. Non-share Lightdash URLs (e.g. `/projects/<uuid>/saved/<uuid>`) don't need to be resolved — the agent can read identifiers from the path directly — and foreign-host URLs return an error.

```text
# A user pastes:
https://<your_instance_name>.lightdash.cloud/share/aBcD1234ecomXyZ

# resolve_url returns the full URL, e.g.:
https://<your_instance_name>.lightdash.cloud/projects/<project-uuid>/dashboards/<dashboard-uuid>/view
```

#### Query execution

Expand Down
Loading