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

# Identity and projects tools

> MCP tools for checking who you are signed in as and listing, creating, renaming, and deleting projects.

Read your signed-in identity and organization, switch project scope, and create, rename, or delete projects. See [Projects](https://docs.oqoqo.ai/setup/projects.md) for how projects organize resources.

* **Badges** are explained under [Approvals](https://docs.oqoqo.ai/mcp-server/overview.md#approvals).
* **`project_id`** is optional on most tools; without it, the server picks a project for that call only ([Projects](https://docs.oqoqo.ai/mcp-server/overview.md#projects)).
* **`expected_organization_id`** is an optional string on every write tool, omitted from parameter tables; pass `organization.id` from [`get_identity`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#get_identity) ([Organization check](https://docs.oqoqo.ai/mcp-server/overview.md#organization-check)).
* **`limit`** values above a tool's maximum are capped, not refused.

## Tools

### get\_identity

**Get the signed-in user and organization.** Returns your Oqoqo user and signed-in organization. Send `organization.id` as `expected_organization_id` on every write.

Read-only · CLI: [`oqoqo whoami`](https://docs.oqoqo.ai/cli/sign-in#oqoqo-whoami)

This tool takes no parameters.

### get\_project\_context

**Get the organization and its projects.** Returns the organization and its projects, with the values `manage_project` needs to rename one.

Read-only · CLI: [`oqoqo projects list`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-list), [`oqoqo projects current`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-current), [`oqoqo projects use`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-use), [`oqoqo projects inspect`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-inspect)

| Parameter | Type | Required | Description |
| - | - | - | - |
| `project_id` | string | No | Use this project for this call only. Oqoqo does not remember it. |

When the installed [Oqoqo Plugin needs an update](https://docs.oqoqo.ai/operate/plugin.md#update-the-plugin), the result also has `pluginUpdate`: the `level` (`recommended` or `required`), `installedVersion`, `latestVersion`, a `message` for the person, and `steps` with the update commands for each host. Tell the person, then continue their request.

### manage\_project

**Create or rename a project.** It follows the same rules as the dashboard ([Projects](https://docs.oqoqo.ai/setup/projects.md)).

Changes data · CLI: [`oqoqo projects create`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-create), [`oqoqo projects update`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-update)

| Parameter | Type | Required | Description |
| - | - | - | - |
| `action` | `create`, `update` | Yes | Create a project or rename one. |
| `name` | string | Yes | The project name, 1 to 120 characters. |
| `mutation_attempt_id` | string | With `create` | An ID you choose, so that a retry doesn't repeat the change. It has 1 to 100 characters. |
| `project_id` | string | With `update` | The `prj_` project to rename. Omit when `action` is `create`. |
| `expected_updated_at` | string (date-time) or null | No | With `update`: the project's `updatedAt` from `get_project_context`. A stale value returns `project_update_stale`. |

### preview\_delete\_project

**Preview project deletion.** Counts what deleting a project removes by kind, the running experiments it stops, and the blockers. Show the result to the person before `delete_project`.

Read-only · CLI: [`oqoqo projects delete --dry-run`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-delete)

| Parameter | Type | Required | Description |
| - | - | - | - |
| `project_id` | string | Yes | The `prj_` project to preview. |

### delete\_project

**Permanently delete a project.** Deletes a project and everything in it, from tasks, tools, and treatments to experiments, schedules, runs, Evals, and Insights. Running experiments stop first; the result says how many.

Destructive · Irreversible · CLI: [`oqoqo projects delete`](https://docs.oqoqo.ai/cli/projects#oqoqo-projects-delete)

| Parameter | Type | Required | Description |
| - | - | - | - |
| `project_id` | string | Yes | The `prj_` project to delete. |

With blockers, it returns `project_deletion_blocked` and deletes nothing. An already deleted project returns `project_not_found`.

## Related

> [card] [Catalog, resources, and uploads tools](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads.md)
>
> Create and manage tasks, files, machines, tools, and treatments.

> [card] [oqoqo projects](https://docs.oqoqo.ai/cli/projects.md)
>
> The matching CLI commands and flags.


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