Made in 10Docs
GuidesAPI
ReferenceMCP servers

Register an MCP server

Registers your own MCP server (Streamable HTTP, over https) so characters can call its tools mid-call, like your own tools.

POST
/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.

Request Body

application/json
  1. body
Example
{  "name": "Calendar",  "url": "https://mcp.example.com/mcp",  "auth": {    "value": "Bearer your-server-token"  },  "filler": "One moment."}
name*string

One per organization.

Length1 <= length <= 80
url*string

Its Streamable HTTP address. https, through the same address rules as webhooks.

Formaturi
Lengthlength <= 2000
auth?|null
enabled?|
Defaulttrue
timeout_ms?|
Range500 <= value <= 15000
Default10000
filler?|
Lengthlength <= 200

Response Body

The server, its tools listed (or refresh_error saying why they couldn't be).

application/json
  1. response

One of your MCP servers (never its credential).

Example
{  "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",  "name": "Calendar",  "url": "https://mcp.example.com/mcp",  "has_auth": true,  "auth_header": "Authorization",  "enabled": true,  "timeout_ms": 10000,  "filler": "One moment.",  "protocol_version": "2025-11-25",  "server_info": {    "name": "calendar",    "title": null,    "version": "1.2.0"  },  "tools": [    {      "id": "mcp_mcps_7Lc2Vx9QbN4tWm1KzR8h_get_weather",      "name": "get_weather",      "title": null,      "description": "The weather for a city.",      "input_schema": {        "type": "object",        "properties": {          "city": {            "type": "string"          }        }      }    }  ],  "skipped_tools": [],  "refreshed_unix": 1793300000,  "refresh_error": null,  "character_ids": [    "chr_4fT9kQ2mXw7LbN3pZs8V"  ],  "created_unix": 1793300000,  "updated_unix": 1793300000}
id*McpServerId
Match^mcps_[0-9A-Za-z]{20}$
Example"mcps_7Lc2Vx9QbN4tWm1KzR8h"
name*string
Length1 <= length <= 80
url*string
Formaturi
has_auth*boolean

Whether it has a credential.

auth_header*|

The credential's header (never its value).

enabled*boolean

Off keeps its tools out of calls.

timeout_ms*integer

How long one tool call may take.

Range500 <= value <= 15000
filler*|

What the character says at once while one of its tools runs.

Lengthlength <= 200
protocol_version*|

The MCP version it spoke when last listed.

server_info*|

What it said about itself when last listed.

tools*array<>

The tools we keep, in its order.

Itemsitems <= 100
skipped_tools*array<>

Tools left out, and why.

Itemsitems <= 50
refreshed_unix*|

When its tools were last listed.

Formatint64
refresh_error*|

Why its tools couldn't be listed the last time we tried; null when that worked.

character_ids*array<>
created_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
updated_unix*Unix

Unix seconds, UTC.

Formatint64
Example1793300000
Example Request
curl -X POST 'https://api.daxov.com/v1/mcp-servers' \  -H 'Content-Type: application/json' \  -d '{  "name": "Calendar",  "url": "https://mcp.example.com/mcp",  "auth": {    "value": "Bearer your-server-token"  },  "filler": "One moment."}'
Example Response
{  "id": "mcps_7Lc2Vx9QbN4tWm1KzR8h",  "name": "Calendar",  "url": "https://mcp.example.com/mcp",  "has_auth": true,  "auth_header": "Authorization",  "enabled": true,  "timeout_ms": 10000,  "filler": "One moment.",  "protocol_version": "2025-11-25",  "server_info": {    "name": "calendar",    "title": null,    "version": "1.2.0"  },  "tools": [    {      "id": "mcp_mcps_7Lc2Vx9QbN4tWm1KzR8h_get_weather",      "name": "get_weather",      "title": null,      "description": "The weather for a city.",      "input_schema": {        "type": "object",        "properties": {          "city": {            "type": "string"          }        }      }    }  ],  "skipped_tools": [],  "refreshed_unix": 1793300000,  "refresh_error": null,  "character_ids": [    "chr_4fT9kQ2mXw7LbN3pZs8V"  ],  "created_unix": 1793300000,  "updated_unix": 1793300000}