List MCP servers

GET

mcp-servers

curl -X GET "https://api.nedzo.ai/v1/mcp-servers?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Inventory",
    "url": "https://mcp.example.com/mcp",
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": [],
    "toolCount": 4,
    "lastConnectedAt": "2026-10-11T10:00:00Z",
    "createdAt": "2026-10-11T09:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

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

An MCP server gives a voice agent more tools. A workspace can have up to 10, and a voice agent can use up to 5.

Query Parameters

string

required

The workspace. Required.

curl -X GET "https://api.nedzo.ai/v1/mcp-servers?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Inventory",
    "url": "https://mcp.example.com/mcp",
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": [],
    "toolCount": 4,
    "lastConnectedAt": "2026-10-11T10:00:00Z",
    "createdAt": "2026-10-11T09:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

Errors

Status	When
`400`	`workspaceId` is not a valid UUID.
`400`	`workspaceId is required`: `workspaceId` is missing.
`404`	The workspace is not in your API key’s scope.

curl -X GET "https://api.nedzo.ai/v1/mcp-servers?workspaceId=789e4567-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "9b2f6c1a-3e4d-4a5b-8c7d-0e1f2a3b4c5d",
    "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
    "name": "Inventory",
    "url": "https://mcp.example.com/mcp",
    "authType": "bearer",
    "hasAuth": true,
    "headerNames": [],
    "toolCount": 4,
    "lastConnectedAt": "2026-10-11T10:00:00Z",
    "createdAt": "2026-10-11T09:00:00Z",
    "updatedAt": "2026-10-11T10:00:00Z"
  }
]

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

List MCP servers

Query Parameters

Errors