Create MCP Server

Registers a new MCP server with your account. Supports bearer token, custom headers, or no authentication. The server URL must use HTTPS in production.

POST/v1/mcp-servers

Usage

TypeScript Example

import { v0 } from 'v0-sdk'

const result = await v0.mcpServers.create({
  name: 'My MCP Server',
  url: 'https://mcp.example.com/sse',
})

console.log(result)

import { v0 } from 'v0-sdk'const result = await v0.mcpServers.create({  name: 'My MCP Server',  url: 'https://mcp.example.com/sse',})console.log(result)

API Signature

Request

Body

name: string

A human-readable name for the MCP server. Must be between 1 and 100 characters.

url: string

The URL of the MCP server endpoint. Must be a valid URL and use HTTPS in production. Maximum 500 characters.

description?: string

An optional description for the MCP server. Maximum 500 characters.

enabled?: boolean

Whether the MCP server should be enabled. Defaults to true.

auth?: object

Authentication configuration for the MCP server. Defaults to no authentication.

type: 'none' | 'bearer' | 'custom-headers'

The authentication method. Use 'bearer' for token-based auth or 'custom-headers' for key-value header pairs.

token?: string

The bearer token. Required when type is 'bearer'. Maximum 1000 characters.

headers?: Record<string, string>

Key-value pairs of custom headers. Required when type is 'custom-headers'. Maximum 10 headers.

scope?: 'user' | 'team'

Whether the server is scoped to the user or a team. Defaults to 'user'.

Response

id: string

A unique identifier for the MCP server.

object: 'mcp_server'

Fixed value identifying this object as an MCP server.

name: string

The name of the MCP server.

url: string

The URL of the MCP server endpoint.

description?: string

The description of the MCP server.

enabled: boolean

Whether the MCP server is currently enabled.

auth: object

The authentication configuration. Only the type is returned; sensitive values are redacted.

type: 'none' | 'bearer' | 'custom-headers' | 'oauth'

The authentication method used by the server.

scope: 'user' | 'team'

Whether the server is scoped to the user or a team.

createdAt: string

The ISO 8601 timestamp when the server was created.

updatedAt?: string

The ISO 8601 timestamp when the server was last updated.