MCP Servers

Create an MCP server

Registers an org-level MCP server. Secret values supplied in secrets are stored write-only and never returned.

<sub>Scope: mcp:write</sub>

post/v3/organizations/{orgId}/mcp-servers

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/mcp-servers
  • Auth: HTTP bearer

Request body

namestring required
transport'http' | 'stdio' | 'sse' required
iconstring
descriptionstring
urlstring
commandstring
argsstring[]
envobject
headersobject
auth_type'none' | 'oauth' | 'bearer'
secretsobject

Write-only. Secret values to store on this server, by name; the names come back as secret_names. On update, a name you omit keeps its stored value and an empty string removes it. Stored apart from workspace and personal secrets. Never returned in any response.

enabledboolean

Response

The created MCP server.

idstring
slugstring
namestring
iconstring nullable
descriptionstring
sourcestring
transport'http' | 'stdio' | 'sse'
urlstring nullable
commandstring nullable
argsstring[]
envobject
headersobject
auth_type'none' | 'oauth' | 'bearer'
secret_namesstring[]

The names of the credentials stored on this server itself, set through secrets on create or update. They belong to this server only and are not workspace or personal secrets: the secrets endpoints do not list or delete them. Secret values are write-only and are never returned.

accessstring
enabledboolean
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.