---
title: "Application users, permissions and organizations | OwlMeans"
description: "Choose preview or production deliberately. An organization entity is the customer organization; its slug identifies that boundary in supported tool arguments."
url: "https://owlmeans.com/docs/mcp/reference/application-users-permissions-and-organizations/"
lang: "en"
---

# Application users, permissions and organizations

![](https://owlmeans.com/_astro/mcp-reference-application-users-permissions-and-organizations.vvuWqOFv_Z6lK1z.webp)

Choose preview or production deliberately. An organization entity is the customer organization; its slug identifies that boundary in supported tool arguments.

## Use these tools

1.  Call the relevant read or status tool first.
2.  Review the target and required arguments.
3.  Run one intended action, with explicit human confirmation where required.
4.  Inspect status or re-read the affected resource afterward.

Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.

## `app_users`

The generated app’s users.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `all` | No | boolean |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `manage_app_user`

Invite, update or remove an app user.

User removal or disabling can end access. Review scope and the selected profile before confirming destructive changes.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `action` | Yes | `invite`, `update`, `remove` |
| `email` | No | string; minLength 3; maxLength 254 |
| `name` | No | string; minLength 1; maxLength 128 |
| `role` | No | string; minLength 1; maxLength 32 |
| `disabled` | No | boolean |
| `profileId` | No | string; minLength 1; maxLength 256 |
| `confirm` | No | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `app_permissions`

The generated app’s permissions.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `set_app_permission_default`

Set a permission’s default holder.

Changes who receives a permission by default. Test an allowed and a denied user afterward.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `permission` | Yes | string; minLength 1; maxLength 128 |
| `defaultClass` | No | `none`, `user`, `member`, `owner` |
| `entityScoped` | No | boolean |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `app_grants`

Who holds which permission in the generated app.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `profileId` | No | string; minLength 1; maxLength 256 |
| `group` | No | string; minLength 1; maxLength 128 |
| `entitySlug` | No | string; minLength 1; maxLength 63 |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `manage_app_grant`

Grant or revoke a permission in the generated app.

Grant or revoke only the intended permission and audience. Use entitySlug for a customer organization boundary.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `action` | Yes | `assign`, `revoke` |
| `permission` | Yes | string; minLength 1; maxLength 128 |
| `profileId` | No | string; minLength 1; maxLength 256 |
| `group` | No | string; minLength 1; maxLength 128 |
| `entitySlug` | No | string; minLength 1; maxLength 63 |
| `resources` | No | array of string |
| `mode` | No | `blanket`, `resources`, `all` |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `app_organizations`

The generated app’s organizations.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `entitySlug` | No | string; minLength 1; maxLength 63 |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `manage_app_organization`

Rename an organization or manage its members.

Manages customer organization titles and membership. Confirm the intended organization entity and user.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `action` | Yes | `rename`, `add-member`, `update-member`, `remove-member` |
| `entitySlug` | Yes | string; minLength 1; maxLength 63 |
| `title` | No | string; minLength 1; maxLength 256 |
| `email` | No | string; minLength 3; maxLength 254 |
| `name` | No | string; minLength 1; maxLength 128 |
| `owner` | No | boolean |
| `profileId` | No | string; minLength 1; maxLength 256 |
| `groups` | No | array of string |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `app_groups`

The groups of an organization in the generated app.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `entitySlug` | Yes | string; minLength 1; maxLength 63 |
| `group` | No | string; minLength 1; maxLength 128 |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `manage_app_group`

Create, change or delete a group, or manage its members.

Group membership and permission bundles affect user access. Check the group and scope before changing or deleting it.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `scope` | No | `ephemeral`, `production` |
| `action` | Yes | `create`, `update`, `delete`, `add-members`, `remove-members` |
| `entitySlug` | Yes | string; minLength 1; maxLength 63 |
| `group` | Yes | string; minLength 1; maxLength 128 |
| `title` | No | string; minLength 1; maxLength 256 |
| `bundles` | No | array of object |
| `profileIds` | No | array of string |
| `confirm` | No | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## Related reference

[MCP home](https://owlmeans.com/docs/mcp) · [Recovery workflow](https://owlmeans.com/docs/mcp/workflows/review-answer-questions-and-resume-development) · [Costs](https://owlmeans.com/docs/help/how-ai-work-and-inference-costs-are-calculated)
