List External MCP servers

GET

public

api

external-mcps

curl --request GET \
  --url https://api.gennia.ai/public/api/v1/external-mcps \
  --header 'X-Api-Key: <api-key>'

{
  "items": [
    {
      "authHeaderName": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "errorMessage": "<string>",
      "lastDiscoveredAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tools": [
        {}
      ],
      "updatedAt": "2023-11-07T05:31:56Z",
      "url": "<string>"
    }
  ],
  "limit": 123,
  "page": 123,
  "total": 123,
  "totalPages": 123
}

Autorizações

X-Api-Key

string

header

obrigatório

Parâmetros de consulta

page

integer<int32>

padrão:1

limit

integer<int32>

padrão:20

status

string

Filter by status (PENDING | CONNECTED | ERROR | PENDING_AUTHORIZATION | EXPIRED)

string

Case-insensitive name match

Resposta

items

object[]

Show child attributes

limit

integer<int32>

page

integer<int32>

total

integer<int64>

totalPages

integer<int32>

Create an External MCP server (auth + sync discovery)Persists the server with status=PENDING, encrypts the auth value as a WorkspaceSecret, then runs synchronous tool discovery (~10s). Returns 201 with the populated tools list on success, or 201 with status=ERROR if discovery failed (server still persisted so the caller can update later). OAUTH_AUTHORIZATION_CODE rejected.

List External MCP servers

curl --request GET \
  --url https://api.gennia.ai/public/api/v1/external-mcps \
  --header 'X-Api-Key: <api-key>'

{
  "items": [
    {
      "authHeaderName": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "errorMessage": "<string>",
      "lastDiscoveredAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tools": [
        {}
      ],
      "updatedAt": "2023-11-07T05:31:56Z",
      "url": "<string>"
    }
  ],
  "limit": 123,
  "page": 123,
  "total": 123,
  "totalPages": 123
}