Skip to main content
POST
Test a connector and list its tools

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
id
string

The saved connector being edited. Omit for a connector that is being added.

institution
string

The Digital Twin, required when id is omitted. Ignored for a saved connector (its own twin is used).

name
string

The connector label; the identity headers are signed for it. Required when id is omitted.

server_url
string
Example:

"https://docs.praxis-ai.com/mcp"

authorization_header
string | null
Example:

"Bearer XXXX"

Response

The test ran

success
boolean
Example:

true

ok
boolean

Whether the server answered with its tool list

count
integer
Example:

2

truncated
boolean

The server offers more tools than are listed here

tools
object[]
error
string | null

Why the test failed, in words an administrator can act on

Example:

"HTTP 401: Unauthorized"

ms
integer