Test an MCP server

POST

mcp-servers

{id}

test

curl -X POST "https://api.nedzo.ai/v1/mcp-servers/9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d/test" \
    -H "Authorization: Bearer YOUR_API_KEY"

{ "success": true, "tools": [{ "name": "check_stock", "description": "Look up stock for a product" }] }

This endpoint is for the VIP plan only. Other plans get a 403. See Plan access.

We connect with the saved URL, headers and auth and ask for the tool list. A redirect to a private or internal address is refused. When a redirect goes to another address (a different host, http or https, or port), we do not send your auth there. Your other headers go with it. You can test 10 times a minute per workspace.

Path Parameters

string

required

MCP server UUID

curl -X POST "https://api.nedzo.ai/v1/mcp-servers/9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d/test" \
    -H "Authorization: Bearer YOUR_API_KEY"

{ "success": true, "tools": [{ "name": "check_stock", "description": "Look up stock for a product" }] }

When the connection fails, success is false and error says why.

Errors

Status	When
`400`	`id` is not a valid UUID.
`404`	The server is not in your API key’s scope.
`429`	More than 10 tests in a minute. Wait a minute.

curl -X POST "https://api.nedzo.ai/v1/mcp-servers/9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d/test" \
    -H "Authorization: Bearer YOUR_API_KEY"

{ "success": true, "tools": [{ "name": "check_stock", "description": "Look up stock for a product" }] }

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Test an MCP server

Path Parameters

Errors