MCP Servers

Retrieve an MCP server

Returns a single org-level MCP server. secret_names lists the names of the credentials stored on the server itself (for example MCP_API_KEY). They are set with the server's secrets field and belong to that server only: they are not workspace or personal secrets, so listSecrets does not list them and deleteSecret cannot remove them. Secret values are never returned.

<sub>Scope: mcp:read</sub>

get/v3/organizations/{orgId}/mcp-servers/{id}

Request

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

Response

The 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.