---
title: "Pixeltable Cloud MCP tools"
description: "Every hosted Pixeltable Cloud MCP tool, with parameters, read-only and confirm flags, and create_organization, which a sign-in with no organization also lists."
url: "https://www.pixeltable.com/developers/mcp-cloud/tools"
---

# Pixeltable Cloud MCP tools

Rendered from the tool definitions that the hosted server at https://www.pixeltable.com/mcp/cloud advertises in `tools/list`. Setup: [https://www.pixeltable.com/developers/mcp-cloud](https://www.pixeltable.com/developers/mcp-cloud).

## Tools after you have an organization

Every sign-in lists these tools. When the account belongs to several organizations and the sign-in chose none, `org` names the one to act in. `get_table_rows` returns JSON, at most 25 rows per call, and clips each string to 2000 characters. `get_logs` returns at most 500 lines. Stopping, restarting, and setting a secret return a preview until `confirm: true`.

### `get_current_organization`

Get current organization. Return the signed-in Pixeltable Cloud organization, its default database, and the site serving this server: https://www.pixeltable.com is production. When the sign-in chose none, the account's organizations, or that it has none yet.

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `get_usage`

Get usage. Return the signed-in organization's usage this calendar month (UTC) against its plan: the plan, the dollars used at Pro's rates of what the plan includes (Community stops its databases and services past it until the 1st; Pro bills past it, an estimate), compute and storage with each one's quantity and cost, its databases, services, media and largest database storage against their limits, and what it runs now. For Community, limit_reached_at is when usage passes the limit if what runs now keeps running; full_month_usd is what its databases and services cost at Pro's rates running all month. month_end_usd is where the month ends if what runs now keeps running, each resource up to its monthly cap and storage at its latest day's amount; daily is the month's used dollars at the end of each UTC day so far, today at now. Compute counts up to now; storage lags up to a day.

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `list_databases`

List databases. List the signed-in organization's databases, each with its status as the dashboard shows it. settled: false means a change is still rolling out: call again in a few seconds. detail says why it failed or what it waits for; can_retry: true means retry_change can start a new attempt.

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `list_services`

List services. List the services of one database by name and base path, with status, settled, detail and can_retry as list_databases reports them, and each one's endpoint.

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `list_catalog`

List catalog entries. List direct child directories, tables, views, and snapshots at a database path. path names a Pixeltable catalog entry, such as demo/items, not a URL. Docs: https://www.pixeltable.com/developers/mcp-cloud

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `path` | string | no |  | Slash-separated path within the database |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `get_table_schema`

Get table schema. Read the column names and types of a table or view. path names a Pixeltable catalog entry, such as demo/items, not a URL. Docs: https://www.pixeltable.com/developers/mcp-cloud

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `path` | string | yes |  | Slash-separated path within the database |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `get_table_rows`

Get table rows. Read at most 25 rows from a table or view, with a starting offset. path names a Pixeltable catalog entry, such as demo/items, not a URL. Docs: https://www.pixeltable.com/developers/mcp-cloud

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `path` | string | yes |  | Slash-separated path within the database |
| `limit` | integer | no | min 1, max 25 |  |
| `offset` | integer | no | min 0, max 100000 |  |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `get_logs`

Get logs. Read up to 500 recent log lines of a database, or of one of its services, oldest first, with terminal colors and progress-bar redraws removed. With contains, only the lines among the most recent 500 of the window that contain it, ignoring case. A long answer keeps the newest lines and says how many it left out.

Flags: read-only.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `service_name` | string | no |  | Service name, as list_services reports it |
| `base_path` | string | no |  | Service base path, as list_services reports it; '' when it has none |
| `since_minutes` | integer | no | min 1, max 10080 |  |
| `limit` | integer | no | min 1, max 500 |  |
| `contains` | string | no |  | Text a line must contain, such as Error or a request id |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `start_database`

Start database. Start a stopped database. Plan limits on what an organization runs at once apply.

Flags: changes state.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `retry_change`

Retry failed change. Start a new attempt of a database's change, or with service_name of a service's, after it failed: only when list_databases or list_services reports can_retry: true. Then call that list again until it is settled.

Flags: changes state.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `service_name` | string | no |  | Service name, as list_services reports it |
| `base_path` | string | no |  | Service base path, as list_services reports it; '' when it has none |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `stop_database`

Stop database. Stop a database and the services it serves; its data is kept. Without confirm: true it changes nothing and returns a preview; show it to the user first.

Flags: changes state; destructive; confirm first.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `confirm` | boolean | no |  | true only after the user has seen the preview this tool returns without it |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `restart_service`

Restart service. Restart a running service's pods, which also applies changed secrets. Without confirm: true it changes nothing and returns a preview; show it to the user first.

Flags: changes state; destructive; confirm first.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `db` | string | yes |  | Database slug, such as main |
| `service_name` | string | yes |  | Service name, as list_services reports it |
| `base_path` | string | no |  | Service base path, as list_services reports it; '' when it has none |
| `confirm` | boolean | no |  | true only after the user has seen the preview this tool returns without it |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

### `set_secret`

Set secret. Set a secret that databases and services receive as an environment variable at their next start. With db, for that database only; without, for every database of the organization. Without confirm: true it changes nothing and returns a preview; show it to the user first.

Flags: changes state; destructive; confirm first.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `key` | string | yes |  | Environment variable name, such as OPENAI_API_KEY |
| `value` | string | yes |  |  |
| `db` | string | no |  | Database slug, such as main |
| `confirm` | boolean | no |  | true only after the user has seen the preview this tool returns without it |
| `org` | string | no |  | Organization slug. Needed only when the account belongs to several organizations and its sign-in chose none; get_current_organization lists them. |

## Tools before the first organization

A sign-in that names no organization also lists this tool, and the others say to call it first. After `create_organization`: The other tools act in it at once, on the same connection, with no new sign-in.

### `create_organization`

Create organization. Create this account's first Pixeltable Cloud organization. Ask the user what to name it and pass their answer; never choose a name for them. The name is permanent: every database address starts with it. Without confirm: true it changes nothing and returns a preview; show it to the user first.

Flags: changes state; confirm first.

| Name | Type | Required | Limits | Description |
|---|---|---|---|---|
| `name` | string | yes |  | The name the user chose: 3 to 31 letters, numbers, and hyphens |
| `confirm` | boolean | no |  | true only after the user has seen the preview this tool returns without it |