---
title: "Get MCP preferences"
method: GET
path: "/api/mcp/preferences"
tags: ["User"]
---

# Get MCP preferences

`GET /api/mcp/preferences`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/mcp/preferences`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Read account defaults used by the hosted MCP service. Change defaults in the dashboard; this REST operation is read-only.

## Response `200`

Successful response

- McpPreferences
  - `defaultProfile` 'creator' | 'readonly' | 'automation' | 'developer', required
  - `defaultMaxRenderCredits` integer, required
  - `profiles` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required

## Other responses

- `400`: Invalid input or semantic validation error
- `401`: Missing or invalid credentials
- `404`: Not found for this account
- `500`: Server error

---

[API](https://skmtc.dev/zvid/apis/zvid-api.md) · [All operations](https://skmtc.dev/zvid/apis/zvid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zvid/apis/zvid-api/revisions/8a665b293b37?raw)