Probe an MCP server for available tools

Probe an MCP server URL and list the tools it exposes. Useful as a dry-run before creating a connection — verifies the URL is reachable, that authentication headers (if any) are correct, and surfaces the tool catalog. Performs no writes; sits alongside /v2/teams/:team_id/connections/oauth/mcp/check (which probes the same URL for OAuth support).

POST /v2/teams/{teamId}/connections/mcp/probe

Probe an MCP server for available tools

cURL

curl --request POST \
  --url https://api.duvo.ai/v2/teams/{teamId}/connections/mcp/probe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "server_url": "<string>",
  "headers": {}
}
'

200

{
  "success": true,
  "tools": [
    {
      "name": "<string>",
      "description": "<string>",
      "input_schema": {}
    }
  ],
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId · string · required

Body

application/json

server_url · string<uri> · required

MCP server URL to test

headers · object

Optional HTTP headers for authentication

Show child attributes

Response

200

application/json

Default Response

success · boolean · required

tools · object[]

Show child attributes

error · string