> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Test an MCP server

> Connect to an MCP server with its saved settings and list its tools.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#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

**id** `string` *required*

MCP server UUID

```bash cURL theme={null}
curl -X POST "https://api.nedzo.ai/v1/mcp-servers/9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d/test" \
    -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
{ "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.