v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22216424765.0 KB

gateway.openapi_Gateway

Create MCP Server

post/v1/accounts/{account_id}/mcpServers

Path parameters

account_idstring required

The Account Id

Query parameters

mcpServerIdstring required

ID of the mcp server.

Request body

namestring

displayNamestring

Human-readable display name of the mcp. e.g. "My Mcp" Must be fewer than 64 characters long.

descriptionstring

The description of the mcp. Must be fewer than 4000 characters long.

createTimestring date-time

The creation time of the mcp.

updateTimestring date-time

The update time for the mcp.

endpointUrlstring

The URL of the MCP server. Required if self_hosted is true. For managed MCPs, this will be populated after deployment.

apiKeySecretstring

The resource name of the secret to use for authenticating with the MCP server. e.g. accounts/my-account/secrets/my-secret If provided for a remote-hosted MCP, the endpoint will be validated for connectivity during creation.

simulatedboolean

Whether this is a simulated MCP server.

state'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'FAILED' | 'DELETING'

remoteHostedboolean

Whether this MCP is remote-hosted (true) or managed by Fireworks (false).

annotationsobject

Annotations to identify MCP properties. Key/value pairs may be used by external tools or other services.

publicboolean

Whether this MCP is publicly available to all Fireworks users. If false, only accessible to the account that created it.

authenticationType'AUTHENTICATION_TYPE_UNSPECIFIED' | 'OPEN' | 'API_KEY' | 'OAUTH2' | 'BEARER_TOKEN'

OPEN: No authentication required (open access)
API_KEY: API key authentication via secrets
OAUTH2: OAuth 2.0 authentication
BEARER_TOKEN: Bearer token authentication

maxQpsnumber double

Max QPS of this MCP server. 0 means no ratelimit.

Response

A successful response.