Skip to Content
DocumentationSpeakeasyGeneration ConfigMCP Server Configuration

MCP Server configuration options

This section details the available configuration options for MCP servers. All configuration is managed in the gen.yaml file under the mcp-typescript section.

Response validation

mcp-typescript:
  validateResponse: false
Property
validateResponse
Description
Controls whether HTTP responses are validated using generated Zod schemas before being returned as MCP tool results. When set to
, responses are validated against the OpenAPI schema using Zod, providing strict type checking. When set to
, no structured deserialization or validation is performed and the raw HTTP response data is passed through as MCP tool results. Disabling validation provides forward compatibility, allowing MCP tool calls to return data regardless of potential inconsistencies with the OpenAPI JSON Schema. This is useful when there is little value in blocking LLM agents from reading data that may not strictly conform to the schema.
Default
false
Type
boolean

MCPB manifest overlay

You can customize the generated MCP Bundle (MCPB) manifest through the gen.yaml configuration file.

mcp-typescript:
  mcpbManifestOverlay:
    icon: "https://example.com/my-icon.png"
    displayName: "My Custom API Tools"
    description: "Custom description for my MCP server"
    version: "1.0.0"
Property
mcpbManifestOverlay.icon
Description
URL to a custom icon for your MCP server.
Default
N/A
Type
string
mcpbManifestOverlay.displayName
Description
A custom display name for your MCP server.
Default
N/A
Type
string
mcpbManifestOverlay.description
Description
A custom description for your MCP server.
Default
N/A
Type
string
mcpbManifestOverlay.version
Description
A custom version string for the MCPB manifest.
Default
N/A
Type
string

Last updated on