Test MCP server connectivity.
This endpoint tests the connectivity to the MCP server using the provided URL and headers.
On success, it returns the full list of available tools with their schemas.
On failure, it returns an appropriate error status code (400 or 502).
Parameters:
- url: The MCP server URL to test
- headers: Optional authentication headers
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Tests connectivity to an MCP server using the URL and optional headers you provide. On success it returns the full list of available tools with their schemas.
When to use it
Use it before Create an MCP tool to confirm the server is reachable and offers the tools you expect.
Required parameters
url(body): the MCP server URL to test.
Optional body fields: headers.
Response
A successful call returns 200 OK with success, message, tools_count, and tools, the tool schemas. A 400 means the server returned invalid JSON, and a 502 means SUPERWISE could not connect.
Related: Create an MCP tool, List MCP tools, Test an agent tool connection
Invalid JSON from MCP server
Validation error
Internal server error
Failed to connect to MCP server