> ## Documentation Index
> Fetch the complete documentation index at: https://vms.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP reference

> The MCP endpoint, the OAuth settings, the access scopes, and the tools.

This reference gives the facts of the MCP server. To connect a client, see [Connect an MCP client](https://vms.dev/docs/install-mcp.md).

Check what an MCP client can do.

Ask which tool or scope I want to check.
Give me its facts from this reference.

## Endpoint

| Item | Value |
| - | - |
| MCP endpoint | `https://vms.dev/api/mcp` (Streamable HTTP) |
| Protected resource metadata | `https://vms.dev/.well-known/oauth-protected-resource/api/mcp` |
| Authorization server metadata | `https://vms.dev/.well-known/oauth-authorization-server/api/auth` |

## Other clients

A client must support:

* Remote MCP over Streamable HTTP.
* OAuth 2.1 with the authorization code grant and PKCE (`S256`).
* A Client ID Metadata Document (CIMD): an HTTPS URL as its `client_id`. Dynamic client registration is off.

An access token works for 15 minutes. With the `offline_access` scope, the client gets a refresh token.

An agent can also get a token without a browser sign-in, with [agent registration](https://vms.dev/docs/reference/agent-registration.md). Its tokens work with the same tools and limits.

## Access

The client acts as you. Two things limit it:

* The scopes that you allow on the consent screen.
* Your role in each workspace. See [roles](https://vms.dev/docs/reference/workspace-access.md#roles).

| Scope | Gives access to |
| - | - |
| `organization:read` | The list of your workspaces |
| `workspace:read` | The settings and the changes of a workspace |
| `offline_access` | A refresh token, so that the client stays connected |

## Tools

Each tool that works on one workspace takes an `organization` argument: the URL slug of the workspace, from `list_organizations`.

| Tool | Scope | Result |
| - | - | - |
| `list_organizations` | `organization:read` | Your workspaces, with the slug, the name, and your role |
| `get_workspace` | `workspace:read` | The name, the slug, the company website, and the default language of a workspace |
| `list_workspace_changes` | `workspace:read` | One page of the changes of a workspace, newest first. Send `cursor` for the next page. |

## Errors

| Error code | Cause |
| - | - |
| `insufficient_scope` | The client does not have the scope of the tool. Connect the client again and allow the scope. |
| `forbidden` | You are not a member of the workspace. |
| `invalid` | The input of the tool is not valid. |

Read the [changelog.](https://vms.dev/docs/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.