Test an MCP connection
Connect to an MCP server with the given credentials, call tools/list, and return the tools it offers. Nothing is saved.
Endpoint
POST/mcp-tool-connection-proxy
Body
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | MCP server URL. |
authentication_type | string | No | none, api_key, custom_headers or oauth2. |
api_key | string | No | Sent as a Bearer token when authentication_type is api_key. |
custom_headers | array | No | { key, value } headers, used when authentication_type is custom_headers. |
oauth2_config | object | No | Its access_token is sent as a Bearer token when authentication_type is oauth2. |
Request
Response
The call always succeeds at the HTTP level; check success.
json
| Field | Description |
|---|---|
success | true when the server answered tools/list. |
tools | Tools to save in the connection's tools and choose from for enabled_tools. |
data | Raw JSON-RPC response (JSON or Server-Sent Events are both accepted). |
When the server cannot be reached, rejects the credentials or returns an MCP error:
json
Then save the connection with Update an AI assistant.
Report an issue with this documentation
Please log in to report issues with our documentation.