---
title: "Dashboard MCP"
description: "Manage your apps from any AI client, without the CLI or a token."
canonical_url: "https://docs.lightdrop.cloud/guides/dashboard-mcp"
---
# Dashboard MCP

> Manage your apps from any AI client, without the CLI or a token.

The [dashboard](https://docs.lightdrop.cloud/guides/dashboard) is an MCP server too. Agents that can't run the CLI, or
shouldn't hold a token for it, manage your apps through it: Claude Code on the web, claude.ai,
Cursor and other MCP clients.

```bash
claude mcp add --transport http wervt https://dashboard.lightdrop.cloud/mcp
```

The first call opens the wervt login, as with any app's [`/mcp`](https://docs.lightdrop.cloud/guides/mcp): sign in and allow
the client. It then keeps itself signed in. On a machine where the CLI is signed in, agents use the
CLI instead (the [`wervt` skill](https://docs.lightdrop.cloud/guides/agents) does). Which MCP is for what is in
[Agents](https://docs.lightdrop.cloud/guides/agents#which-mcp-server).

## Who may do what

The tools act as you, with the same rights as in the dashboard: admins on every app, everyone
else on the apps they own or are members of (see
[Owners and members](https://docs.lightdrop.cloud/guides/private-apps#owners-and-members)). Only people the dashboard lets in
can connect. Every change lands in the [audit log](https://docs.lightdrop.cloud/guides/deploys#audit-log) under your email.

## Tools

Tool names group by topic. Each tool takes the app as `app`; preview names like `todos--pr-12`
work wherever an app does.

### Apps and releases

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      CLI
    </th>
    
    <th>
      
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        whoami
      </code>
    </td>
    
    <td>
      <code>
        whoami
      </code>
    </td>
    
    <td>
      Your email, whether you're an admin, your app limit
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.list
      </code>
    </td>
    
    <td>
      <code>
        apps
      </code>
    </td>
    
    <td>
      Apps you can see, with URL, access and active release
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.get
      </code>
    </td>
    
    <td>
      <code>
        releases
      </code>
    </td>
    
    <td>
      One app and its releases, newest first
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        releases.activate
      </code>
    </td>
    
    <td>
      <code>
        activate
      </code>
    </td>
    
    <td>
      Switch to a kept release, if the active one is still <code>
        ifActive
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        releases.rollback
      </code>
    </td>
    
    <td>
      <code>
        rollback
      </code>
    </td>
    
    <td>
      Back to the release before the active one
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.delete
      </code>
    </td>
    
    <td>
      <code>
        delete
      </code>
    </td>
    
    <td>
      Delete an app (and its previews) or one preview
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.reprovision
      </code>
    </td>
    
    <td>
      <code>
        reprovision <app>
      </code>
    </td>
    
    <td>
      Admins: recreate an app's database role and run its migrations
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.reprovisionAll
      </code>
    </td>
    
    <td>
      <code>
        reprovision --all
      </code>
    </td>
    
    <td>
      Admins: the same for every app
    </td>
  </tr>
</tbody>
</table>

### Access and settings

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      CLI
    </th>
    
    <th>
      
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        access.get
      </code>
      
      , <code>
        access.update
      </code>
    </td>
    
    <td>
      <code>
        access
      </code>
    </td>
    
    <td>
      Public, private or invite-only, the allow-list, who may invite
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        members.get
      </code>
      
      , <code>
        members.update
      </code>
    </td>
    
    <td>
      <code>
        members
      </code>
    </td>
    
    <td>
      Owner and members; hand an app to a new owner
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        domains.get
      </code>
      
      , <code>
        domains.update
      </code>
    </td>
    
    <td>
      <code>
        domains
      </code>
    </td>
    
    <td>
      Custom domains: add, verify, make primary, remove
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        env.list
      </code>
      
      , <code>
        env.update
      </code>
    </td>
    
    <td>
      <code>
        env
      </code>
    </td>
    
    <td>
      Env var keys; set and unset values (write-only)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        env.previewList
      </code>
      
      , <code>
        env.previewUpdate
      </code>
    </td>
    
    <td>
      <code>
        env --preview
      </code>
    </td>
    
    <td>
      The preview env, on top of the env in every preview
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        identity.get
      </code>
      
      , <code>
        identity.update
      </code>
    </td>
    
    <td>
      <code>
        identity
      </code>
    </td>
    
    <td>
      Workload identity for provider trust rules
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        mailLimits.get
      </code>
      
      , <code>
        mailLimits.update
      </code>
    </td>
    
    <td>
      <code>
        mail-limits
      </code>
    </td>
    
    <td>
      Mails per hour an app may send; admins make exceptions
    </td>
  </tr>
</tbody>
</table>

### Tokens and clients

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      CLI
    </th>
    
    <th>
      
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        tokens.list
      </code>
      
      , <code>
        tokens.create
      </code>
      
      , <code>
        tokens.revoke
      </code>
    </td>
    
    <td>
      <code>
        tokens
      </code>
    </td>
    
    <td>
      Deploy tokens for CI; a new one is shown once
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        apps.token
      </code>
    </td>
    
    <td>
      <code>
        token
      </code>
    </td>
    
    <td>
      A short-lived token for your account on an app (1m–1h), for curl or Playwright
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        clients.list
      </code>
      
      , <code>
        clients.create
      </code>
      
      , <code>
        clients.delete
      </code>
    </td>
    
    <td>
      <code>
        clients
      </code>
    </td>
    
    <td>
      <a href="https://docs.lightdrop.cloud/guides/native-apps">
        Native app
      </a>
      
       clients
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        clients.link
      </code>
    </td>
    
    <td>
      <code>
        clients link
      </code>
    </td>
    
    <td>
      Admins: assign a self-registered client to an app
    </td>
  </tr>
</tbody>
</table>

### Logs, tasks and stats

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      CLI
    </th>
    
    <th>
      
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        logs.query
      </code>
    </td>
    
    <td>
      <code>
        logs
      </code>
    </td>
    
    <td>
      Log lines, filtered by LogsQL, levels and time
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        logs.requests
      </code>
    </td>
    
    <td>
      <code>
        logs --requests
      </code>
    </td>
    
    <td>
      HTTP requests with status, duration and user
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        logs.hits
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      Matching lines per time bucket
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        queries.list
      </code>
      
      , <code>
        .create
      </code>
      
      , <code>
        .update
      </code>
      
      , <code>
        .delete
      </code>
    </td>
    
    <td>
      <code>
        queries
      </code>
    </td>
    
    <td>
      Saved queries and their alerts
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        queries.all
      </code>
    </td>
    
    <td>
      <code>
        queries
      </code>
    </td>
    
    <td>
      Saved queries across apps
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        tasks.list
      </code>
      
      , <code>
        tasks.run
      </code>
    </td>
    
    <td>
      <code>
        tasks
      </code>
    </td>
    
    <td>
      Tasks and schedules; run one now (with a payload)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        services.list
      </code>
    </td>
    
    <td>
      <code>
        services
      </code>
    </td>
    
    <td>
      Service containers of the active release and their state
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        stats.get
      </code>
    </td>
    
    <td>
      <code>
        stats
      </code>
    </td>
    
    <td>
      Page views and visitors, with drill-down
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        audit.list
      </code>
      
      , <code>
        audit.all
      </code>
    </td>
    
    <td>
      <code>
        audit
      </code>
    </td>
    
    <td>
      Who changed what, for one app or all
    </td>
  </tr>
</tbody>
</table>

### Users, accounts and system (admins)

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      CLI
    </th>
    
    <th>
      
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        apps.inventory
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      Every app on the server, with owner and blocked owners
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        users.list
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      Everyone on the server, with role and sign-in
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        users.get
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      One person: access per app and why, limits, sessions
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        users.signOut
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      End someone's login and CLI sessions
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.list
      </code>
    </td>
    
    <td>
      <code>
        accounts
      </code>
    </td>
    
    <td>
      Accounts with apps, limits and state
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.update
      </code>
    </td>
    
    <td>
      <code>
        accounts <email> --apps …
      </code>
    </td>
    
    <td>
      Limits, or block on every app
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.invite
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      Invite someone to the dashboard, with an app limit
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.delete
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      Delete an account without apps
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.merge
      </code>
    </td>
    
    <td>
      <code>
        accounts <from> --into …
      </code>
    </td>
    
    <td>
      Merge two accounts of the same person
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        accounts.changeEmail
      </code>
    </td>
    
    <td>
      <code>
        accounts <from> --change-email …
      </code>
    </td>
    
    <td>
      Give an account a new address when its mailbox is gone
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        system.list
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      The platform's containers and apps, with their state
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        system.logs
      </code>
    </td>
    
    <td>
      –
    </td>
    
    <td>
      A platform container's last lines from <code>
        docker logs
      </code>
    </td>
  </tr>
</tbody>
</table>

## Not included

- **Deploying and building** (`wervt deploy`, `wervt build`): they pack a build made on your
machine. Deploy from CI with a deploy token instead
([From GitHub Actions](https://docs.lightdrop.cloud/guides/deploys#from-github-actions)); `tokens.create` makes one. Or
build and deploy in a sandbox with the [Build MCP](https://docs.lightdrop.cloud/guides/build-mcp).
- **Following logs live** (`wervt logs --follow`): a stream. `logs.query` with `since` reads recent lines.
- **wervt login** and **skill install**: they set up the machine the CLI runs on.

## Safety

- Reading tools are marked read-only (`readOnlyHint`) and the others aren't, so clients can tell
which calls change something and ask you first.
- Tools that can't be undone or hand out a lasting secret (`apps.delete`, `access.update` to
public, `members.update` with a new owner, `accounts.delete`, `accounts.merge`,
`accounts.changeEmail`, `tokens.create`, `clients.delete`) tell the agent to use them only when you asked for exactly
that.
- Env values are write-only: no tool returns them.
- The tools aren't offered to agents in the browser (WebMCP), where a page agent would get your
admin rights with them.

## Local development

`nuxt dev` in `apps/dashboard` serves `/mcp` without a login, as the dev user, against the local
stack ([Local stack](https://docs.lightdrop.cloud/self-hosting/local-stack)):

```bash
CONTROL_TOKEN=dev-deploy-token pnpm dev --port 3210
claude mcp add --transport http wervt-dev http://localhost:3210/mcp
```

A tool is an API route declared with `defineToolRoute` in `apps/dashboard/server/api/`: the page
and agents share its validation. New routes that mirror a CLI command belong there too.


## Sitemap

See the full [sitemap](https://docs.lightdrop.cloud/sitemap.md) for all pages.
