# Management MCP server

Layer exposes a **second, separate MCP server** for workspace administration. Where the [creative server](/docs/mcp) generates assets, the management server handles the operational side of a workspace: projects, groups, members, and Creative-Units usage.

It runs at a different endpoint (`https://mcp.app.layer.ai/mcp-management`) and is connected as its own server in your client.

[Setup](/docs/mcp/management/setup)Connect the management server to your client.

[Creative server](/docs/mcp)The generation server (images, 3D, video, audio).

## Why a separate server?

MCP agents choose tools better when the toolset in front of them is small and focused. Every tool loaded into a conversation consumes context and adds another option the model has to reason about — and past a certain point, **too many tools pollute the context**: the agent gets slower, picks the wrong tool more often, and loses the thread of what the user actually asked for.

Workspace administration and creative generation are genuinely different jobs. Someone generating game assets rarely needs to suspend a member or set a group’s Creative-Units cap in the same breath — and an automation that manages seats has no use for forge parameters. Bundling \~40 tools into one server would make **both** jobs worse.

So we split them by concern. Each agent connects only to the surface it needs:

* **Creators & pipelines** connect to the [creative server](/docs/mcp) — generation, models, workflows, files.
* **Admins & provisioning automation** connect to the **management server** — the tools on this page.

You can connect to both at once if you need to; they’re independent servers with independent tool lists, so neither dilutes the other.

Note

Both servers use the same Layer account and OAuth flow. Every management operation runs as **your** Layer user and is subject to your workspace role — the server doesn’t grant new permissions.

## What it manages

## Projects

Create and manage projects and their members within a workspace.

* [list\_projects](/docs/mcp/management/tools/projects/list%5Fprojects)List projects in a workspace with their name, status, and linked object count.
* [get\_project](/docs/mcp/management/tools/projects/get%5Fproject)Get details for a single project in a workspace.
* [create\_project](/docs/mcp/management/tools/projects/create%5Fproject)Create a new project in a workspace.
* [update\_project](/docs/mcp/management/tools/projects/update%5Fproject)Update a project's name, description, instructions, or archive status.
* [delete\_project](/docs/mcp/management/tools/projects/delete%5Fproject)Delete a project (soft-delete: it is removed from listings and can't be used).
* [add\_project\_members](/docs/mcp/management/tools/projects/add%5Fproject%5Fmembers)Add existing workspace members to a project by email.
* [remove\_project\_member](/docs/mcp/management/tools/projects/remove%5Fproject%5Fmember)Remove a member from a project by email.

## Groups

Manage workspace groups — the role they grant, their members, and their Creative-Units caps.

* [list\_groups](/docs/mcp/management/tools/groups/list%5Fgroups)List a workspace's groups with their name and granted role.
* [create\_group](/docs/mcp/management/tools/groups/create%5Fgroup)Create a workspace group, optionally granting its members a role.
* [update\_group\_role](/docs/mcp/management/tools/groups/update%5Fgroup%5Frole)Set or clear the workspace role a group grants its members.
* [delete\_group](/docs/mcp/management/tools/groups/delete%5Fgroup)Delete a workspace group, revoking its role and cap from members.
* [list\_group\_members](/docs/mcp/management/tools/groups/list%5Fgroup%5Fmembers)List a group's members with their email and status.
* [add\_group\_member](/docs/mcp/management/tools/groups/add%5Fgroup%5Fmember)Add a workspace member to a group by email (they must already be a workspace member).
* [remove\_group\_member](/docs/mcp/management/tools/groups/remove%5Fgroup%5Fmember)Remove a member from a group by email.
* [set\_group\_usage\_limit](/docs/mcp/management/tools/groups/set%5Fgroup%5Fusage%5Flimit)Set a group's Creative-Units cap for a period.
* [remove\_group\_usage\_limit](/docs/mcp/management/tools/groups/remove%5Fgroup%5Fusage%5Flimit)Remove a group's Creative-Units cap.

## Members

Invite, list, and manage the access of workspace members.

* [list\_workspace\_members](/docs/mcp/management/tools/members/list%5Fworkspace%5Fmembers)List the members of a workspace with their email, role, and status.
* [invite\_member](/docs/mcp/management/tools/members/invite%5Fmember)Invite a user to a workspace by email, creating the Layer user if needed.
* [suspend\_member](/docs/mcp/management/tools/members/suspend%5Fmember)Suspend a workspace member, revoking their access without deleting them.
* [reactivate\_member](/docs/mcp/management/tools/members/reactivate%5Fmember)Reactivate a suspended workspace member, restoring their access.

## Usage

Inspect a workspace’s Creative-Units balance and consumption.

* [get\_workspace\_usage](/docs/mcp/management/tools/usage/get%5Fworkspace%5Fusage)Report a workspace's Creative Units balance and recent consumption.
