Deployment

Host Marketplace on any Node.js platform with the registry built into the artifact.

Requirements

  • Node.js 20.9 or later.
  • Outbound HTTPS from the server to every listed store and the AI provider.
  • A proxy that sets x-forwarded-host (or host) and x-forwarded-proto. The completion route calls its own /api/mcp-transport/http using those headers.

Environment

VariableEffect
OPENROUTER_API_KEY, OPENROUTER_MODELEnable shared AI mode when both are set
OPENROUTER_MAX_TOKENSOutput cap, default 4000, must be a positive whole number
MARKETPLACE_DISABLE_LOCAL_AItrue, 1, yes or on forces shared mode and disables /api/ai-models
MARKETPLACE_CUSTOM_AI_ORIGINSComma-separated allowlist for custom AI endpoints

All are optional. With none set each buyer brings their own key.

Deploy

Review the registry

Edit marketplace.config.json with the stores you trust.

Set secrets

Add the AI variables to your host's secret store.

Build and start

npm run build, then npm start. The README has Vercel and Railway buttons.

Verify

Open GET /api/mcp-transport/http and confirm the admitted store list.

Checks before release

npm test, npm run test:security, npm run test:platform, npm run typecheck, npm run lint, npm run build.

On this page