Replit | xmcp Documentation

For the complete documentation index, see llms.txt. Markdown variants of every page are available by appending .md to the URL.

Get started by remixing the xmcp Replit template.

Remixing creates your own copy of the template in a Replit workspace. Run it to get a development endpoint in the Preview pane, then select Publish to deploy it to a production URL. Your server will be available at https://<your-app>.replit.app/mcp, ready to connect from any MCP client.

Deploy an existing project

You can deploy your xmcp server to Replit in three steps:

Import your repository at replit.com/import. For public repositories, you can also open https://replit.com/github.com/<owner>/<repo> directly.
Configure the HTTP server to listen on 0.0.0.0. Published Replit apps are not reachable when the server binds to xmcp's default host, 127.0.0.1. Leave the port unset: Replit maps the first port your server opens to the public URL.
Select Publish in the workspace and choose a deployment type. Autoscale is a good fit for stateless HTTP MCP servers.

Your configuration should look like this:

xmcp.config.ts

const config: XmcpConfig = {
  http: {
    host: "0.0.0.0",
  },
};

export default config;

The run command should build the project and start the HTTP server:

npm run build && node dist/http.js

Learn more about deploying xmcp to Replit in the Replit documentation.