v1

latestOpenAPI 3.0.0CoreStack Inc License2026-07-248001,5071.7 MB
AI Agent

Register a new MCP server for the current tenant

Register a new MCP server for the tenant.

post/v1/mcp/server/register

Request body

namestring required

Server name for MCP

display_namestring

Human-readable display name for the MCP server.

descriptionstring

MCP Server description.

transport'stdio' | 'streamable-http' | 'rss' required

MCP transport type (stdio, streamable-http, or rss).

tenant_idstring required

ID of the tenant

commandstring

Command for stdio transport.

argsstring[]

Command arguments.

envobject

Environment variables (values are sensitive).

base_urlstring

Base URL for HTTP transport.

headersobject

HTTP headers (values are sensitive).

is_enabledboolean

Whether the server is active.

business_agentsstring[] required

Agents allowed to use this server.

timeout_msinteger

Timeout in milliseconds.

toolsobject[]

Tool definitions.

freshnessstring

Data freshness hint used for tool selection: real_time | daily | weekly | static.

priorityinteger

Tool selection priority — lower value means higher preference (e.g. 10 beats 100).

Example request

{
  "transport": "stdio",
  "business_agents": [
    "Assessment Agent"
  ]
}

Response

Created

sysIdstring

Unique Identifier of the tracked item

lastUpdatestring date-time

Last update of the tracked item

tablestring

Context of the tracked item