---
title: "Register MCP servers dynamically at runtime"
method: POST
path: "/register/servers"
tags: ["registration"]
---

# Register MCP servers dynamically at runtime

`POST /register/servers`

## Headers

- `x-code-mode-session` string, required

## Request body

- RegisterMcpServersRequest — Request to register MCP servers
  - `servers` unknown[], required
    - unknown

## Response `200`

MCP servers registration result

- RegisterMcpServersResponse — Response after registering MCP servers
  - `failed` string[], required
  - `registered` integer, required

## Other responses

- `500` — Internal server error

## Changes

- **2026-01-13** `3e88fe31ab47` — 1 breaking, 3 warning
  - the `servers/items/` request property type changed from `object` to no type
  - removed the request property `servers/items/auth`
  - removed the request property `servers/items/name`
  - removed the request property `servers/items/url`
- **2025-12-10** `ddf13b171ba5` — 3 breaking, 1 info
  - added the new required request property `servers/items/name`
  - added the new required request property `servers/items/url`
  - the `servers/items/` request property type changed from no type to `object`
  - added the new optional request property `servers/items/auth`

[Change history](https://skmtc.dev/portofcontext/apis/pctx-agent-server-api/changes/register/servers/post.md)

---

[API](https://skmtc.dev/portofcontext/apis/pctx-agent-server-api.md) · [All operations](https://skmtc.dev/portofcontext/apis/pctx-agent-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/portofcontext/pctx-agent-server-api/revisions/d1f357cea012/schema)