Create MCP server

Create a new MCP server for an assistant.

Request

POST https://superinterface.ai/api/cloud/assistants/{assistantId}/mcp-servers

Authentication

Include your private API key in the request headers:

Authorization: Bearer YOUR_PRIVATE_API_KEY

Path Parameters

Parameter	Type	Description
`assistantId`	string	The ID of the assistant

Request Body

Parameter	Type	Required	Description
`transportType`	`TransportType`	Yes	Transport type (`SSE` or `HTTP`)
`sseTransport`	object	Conditional	`{ url: string, headers: string }` when `transportType` is `SSE`; `headers` must be a JSON string
`httpTransport`	object	Conditional	`{ url: string, headers: string }` when `transportType` is `HTTP`; `headers` must be a JSON string

Example request

curl -X POST "https://superinterface.ai/api/cloud/assistants/00cfe680-fee5-49b9-b386-6a7097eb8497/mcp-servers" \ -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "transportType": "SSE", "sseTransport": { "url": "https://example.com/sse", "headers": "{\"Authorization\":\"Bearer token\"}" } }'

Response

Parameter	Type	Description
`mcpServer`	`McpServer`	New MCP server

Example response

{ "mcpServer": { "id": "00cfe680-fee5-49b9-b386-6a7097eb8497", "transportType": "SSE", "sseTransport": { "id": "10cfe680-fee5-49b9-b386-6a7097eb8497", "url": "https://example.com/sse", "headers": { "Authorization": "Bearer token" }, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-01-15T10:30:00Z" }, "httpTransport": null, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-01-15T10:30:00Z" } }

Errors

The endpoint may return the following errors:

401 Unauthorized

This error occurs if the API key is invalid or missing.

{ "error": "Unauthorized", "message": "Invalid or missing API key" }