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.
Type
boolean
Default
false

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.
Type
string
Default
N/A
mcpbManifestOverlay.displayName
Description
A custom display name for your MCP server.
Type
string
Default
N/A
mcpbManifestOverlay.description
Description
A custom description for your MCP server.
Type
string
Default
N/A
mcpbManifestOverlay.version
Description
A custom version string for the MCPB manifest.
Type
string
Default
N/A

Last updated on