OpenAI

HTTP transport

The http configuration customizes the HTTP server. Set it to true to use defaults, or provide an object to override specific options:

xmcp.config.ts

const config: XmcpConfig = {
  http: {
    port: 3001,
    host: "127.0.0.1",
    endpoint: "/mcp",
    bodySizeLimit: 10485760, // 10MB
    cors: {
      origin: "*",
      methods: ["GET", "POST"],
      allowedHeaders: [
        "Content-Type",
        "Authorization",
        "mcp-session-id",
        "mcp-protocol-version",
      ],
      exposedHeaders: ["Content-Type", "Authorization", "mcp-session-id"],
      credentials: false,
      maxAge: 86400,
    },
    debug: false, // adds extra logging to the console
  },
};

export default config;

These are the default values. Override only what you need to customize.

STDIO transport

The stdio configuration customizes the STDIO transport. Set it to true to use defaults, or provide an object to override specific options:

By default you enable STDIO transport by setting it to true.

xmcp.config.ts

const config: XmcpConfig = {
  stdio: true,
};

You can also customize the debug mode and this would enable it as well.

xmcp.config.ts

const config: XmcpConfig = {
  stdio: {
    debug: false, // adds extra logging to the console
  },
};

Troubleshooting

Keep in mind that clients like Claude Desktop are not compatible with STDIO logging and would cause a JSON parsing error.

Transports

HTTP transport

STDIO transport

Troubleshooting

One framework to rule them all