Você pode testar esta rota diretamente em nossa documentação interativa.

Retorna as configurações MCP do host. Com avatarId, filtra apenas as configurações daquele avatar.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/mcp/list

Parâmetros

hostId
string
required

UUID do host.

avatarId
string

UUID do avatar para filtrar (opcional).

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/mcp/list \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "hostId": "uuid-do-host",
    "avatarId": "uuid-do-avatar"
  }'

Resposta

{
  "code": 200,
  "message": "OK",
  "data": [
    {
      "mcpId": "uuid-da-configuracao-1",
      "hostId": "uuid-do-host",
      "avatarId": "uuid-do-avatar",
      "name": "Servidor MCP Exemplo 1",
      "controlConv": false,
      "transportType": "streamable",
      "config": {
        "url": "https://exemplo1.com/mcp"
      },
      "version": "1.0.0"
    },
    {
      "mcpId": "uuid-da-configuracao-2",
      "hostId": "uuid-do-host",
      "avatarId": "uuid-do-avatar",
      "name": "Servidor MCP Exemplo 2",
      "controlConv": true,
      "transportType": "sse",
      "config": {
        "url": "https://exemplo2.com/mcp",
        "headers": {
          "Authorization": "Basic auth-toke-12345"
        }
      },
      "version": "1.0.0"
    }
  ]
}

Campos da Resposta

data
array

Lista de configurações MCP.

Erros

CódigoDescrição
400hostId ausente ou inválido
401Token ausente ou inválido
500Erro interno do servidor