---
title: "Upsert Mcp Binding"
method: PUT
path: "/mcp/bindings"
---

# Upsert Mcp Binding

`PUT /mcp/bindings`

## Request

- Base URL: `https://api.voicelabs.now` (the document declares no server; this is the origin it was published from)
- URL: `https://api.voicelabs.now/mcp/bindings`
- Auth: none declared

Create-or-update a binding. Matches by client_id.

## Request body

- MCPClientBindingUpsert: Create or update a binding. Matched by ``client_id``.
  - `client_id` string, required
  - `label` string, nullable
  - `profile_id` string, nullable
  - `default_engine` string, nullable
  - `default_personality` boolean

## Response `200`

Successful Response

- MCPClientBindingResponse: Per-MCP-client voice binding — what voice / engine the server should use when a given client_id calls voicebox.speak without args, plus an opt-in personality-rewrite default.
  - `client_id` string, required
  - `label` string, nullable
  - `profile_id` string, nullable
  - `default_engine` string, nullable
  - `default_personality` boolean
  - `last_seen_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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