listWorkspaceMCPServers

GET

/api/v1/workspaces/{workspaceId}/mcp-servers

curl --request GET \
  --url '<base-url>/api/v1/workspaces/<workspaceId>/mcp-servers' \
  --cookie 'agenthold_session=<agenthold_session>'

const url = '<base-url>/api/v1/workspaces/<workspaceId>/mcp-servers';
const options = {
  method: 'GET',
  headers: {cookie: 'agenthold_session=<agenthold_session>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "<base-url>/api/v1/workspaces/<workspaceId>/mcp-servers"

headers = {"cookie": "agenthold_session=<agenthold_session>"}

response = requests.get(url, headers=headers)

print(response.text)

Response example

[
  {
    "name": "string",
    "transport": "stdio",
    "command": "string",
    "args": [
      "string"
    ],
    "env": {
      "property1": "string",
      "property2": "string"
    },
    "url": "string",
    "headers": {
      "property1": "string",
      "property2": "string"
    },
    "id": "string",
    "workspaceId": "string",
    "scope": "workspace",
    "agentId": "string",
    "secretRefs": [
      "string"
    ],
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
]

{
  "error": "string"
}

Authorization

session
optional
API key in cookie

token
optional
HTTP Bearer
Authorization: Bearer <token>

Path parameters

workspaceId
string
required

Returns

200

Workspace-level MCP servers (attachable to agents).

JSON

name
string
required
Letters, digits, dashes and underscores.
transport
stdio
or
http
required
command
string
required
stdio only; runs inside the sandbox.
args
array of
string
required
env
map of
string
required
stdio only. Values may reference secrets as {{secret:NAME}}.
url
string
required
http only.
headers
map of
string
required
http only. Values may reference secrets as {{secret:NAME}}; the sandbox sees a placeholder and the egress proxy injects the value.
id
string
required
workspaceId
string
required
scope
workspace
or
agent
required
secretRefs
array of
string
required
createdAt
string
required
format: date-time
updatedAt
string
required
format: date-time
agentId
optional
string

404

Error.

JSON

error
string
required