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

NameTypeRequiredDescription
urlstringYesMCP server URL.
authentication_typestringNonone, api_key, custom_headers or oauth2.
api_keystringNoSent as a Bearer token when authentication_type is api_key.
custom_headersarrayNo{ key, value } headers, used when authentication_type is custom_headers.
oauth2_configobjectNoIts 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
FieldDescription
successtrue when the server answered tools/list.
toolsTools to save in the connection's tools and choose from for enabled_tools.
dataRaw 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.