Made in 10Docs
GuidesAPI
ReferenceMCP servers

Set a character's MCP servers

Replaces the servers the character takes with `servers`, in order (`[]` detaches all; a repeat keeps its first place).

PUT
/characters/{character_id}/mcp-servers

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Path Parameters

character_id*string

The character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"

Request Body

application/json
  1. body
Example
{  "servers": [    {      "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",      "tools": [        "get_weather"      ]    }  ]}
servers*array<>

The servers, in order. A repeat keeps its first place.

Itemsitems <= 5

Response Body

The character's servers, as getCharacterMcpServers answers.

application/json
  1. response
Example
{  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "mcp_servers": [    {      "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",      "name": "Calendar",      "tools": [        "get_weather"      ]    }  ]}
character_id*CharacterId

A character's id.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
mcp_servers*array<>

In order.

Example Request
curl -X PUT 'https://api.daxov.com/v1/characters/chr_4fT9kQ2mXw7LbN3pZs8V/mcp-servers' \  -H 'Content-Type: application/json' \  -d '{  "servers": [    {      "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",      "tools": [        "get_weather"      ]    }  ]}'
Example Response
{  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",  "mcp_servers": [    {      "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",      "name": "Calendar",      "tools": [        "get_weather"      ]    }  ]}