---
title: "Register a new MCP server for the current tenant"
method: POST
path: "/v1/mcp/server/register"
tags: ["AI Agent"]
---

# Register a new MCP server for the current tenant

`POST /v1/mcp/server/register`

Register a new MCP server for the tenant.

## Request body

- McpServerRequest
  - `name` string, required — Server name for MCP
  - `display_name` string — Human-readable display name for the MCP server.
  - `description` string — MCP Server description.
  - `transport` 'stdio' | 'streamable-http' | 'rss', required — MCP transport type (stdio, streamable-http, or rss).
  - `tenant_id` string, required — ID of the tenant
  - `command` string — Command for stdio transport.
  - `args` string[] — Command arguments.
  - `env` object — Environment variables (values are sensitive).
  - `base_url` string — Base URL for HTTP transport.
  - `headers` object — HTTP headers (values are sensitive).
  - `is_enabled` boolean — Whether the server is active.
  - `business_agents` string[], required — Agents allowed to use this server.
  - `timeout_ms` integer — Timeout in milliseconds.
  - `tools` object[] — Tool definitions.
  - `freshness` string — Data freshness hint used for tool selection: real_time | daily | weekly | static.
  - `priority` integer — Tool selection priority — lower value means higher preference (e.g. 10 beats 100).

## Response `201`

Created

- RecordIdentity
  - `sysId` string — Unique Identifier of the tracked item
  - `lastUpdate` string, date-time — Last update of the tracked item
  - `table` string — Context of the tracked item

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)