listAgentMCPServers

GET

/api/v1/agents/{agentId}/mcp-servers

The agent's own servers and attached workspace servers.

listAgentMCPServers

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

const url = '<base-url>/api/v1/agents/<agentId>/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/agents/<agentId>/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

agentId
string
required

Returns

200

MCP servers used by the agent.

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