Replit MCP Server

The Replit MCP Server is in beta. Tools and behavior may change.

Replit’s MCP server lets external clients create, update, and manage full-stack applications on Replit using the Model Context Protocol. Powered by Replit Agent, it transforms natural language prompts into live, published apps. This page is the developer reference for connecting your own MCP client. Looking to use Replit from a tool you already use? See Replit in Claude, Replit in Slack, or Replit in ChatGPT.

Server details

Property	Value
URL	`https://replit-mcp.com/server/mcp`
Transport	Streamable HTTP
Authentication	OAuth 2.0 (handled automatically by MCP clients and SDKs)

Requirements

For developers:

An MCP client or SDK that supports Streamable HTTP transport

For builders (end users):

A Replit account (Free, Core, Pro, or Enterprise)

Authentication

The server uses OAuth 2.1 with PKCE. MCP clients like Claude Code handle the entire flow automatically. If you’re building with an MCP client SDK, it handles discovery, dynamic client registration, PKCE, and token exchange — you provide the UX (browser redirect, callback handler, token storage). See the MCP authorization spec for details.

Connecting

Configure the server URL in your MCP client. Builders will complete the OAuth consent flow when they first connect. MCP SDK (TypeScript):

TypeScript (MCP SDK)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://replit-mcp.com/server/mcp"),
  { authProvider: yourOAuthProvider } // Implement the OAuthClientProvider interface
);

const client = new Client({ name: "my-client", version: "1.0.0" });
await client.connect(transport);

See the MCP TypeScript SDK documentation for details. The SDK handles the internal OAuth flow automatically. Claude Code:

Claude Code

claude mcp add --transport http replit https://replit-mcp.com/server/mcp

Tools

The server exposes three public tools.

`create_app_from_prompt`

Create a new Replit App from a natural language description. Replit Agent immediately starts building the app.

Parameter	Type	Required	Description
`appDescription`	string	Yes	Natural language description of the app to build.
`app_stack`	string (enum)	Yes	One of: `"react_website"`, `"mobile_app"`, `"design"`, `"slides"`, `"animation"`, `"data_visualization"`, `"3d_game"`, `"document"`, `"spreadsheet"`. Use `"react_website"` for most web apps.
`userSpecifiedAppName`	string \| null	No	App name if provided by the user.
`userQuotes`	string \| null	No	Exact user quotes not fully captured in `appDescription`.
`attachmentSummary`	string \| null	No	Summary of essential details from attachments.

Response:

{
  "phase": "creating",
  "replId": "d44d994b-96e1-4a1c-8085-88401b870a9a",
  "turnId": "turn-id",
  "replUrl": "https://replit.com/@username/App-Name",
  "user": { "id": 12345, "username": "username" }
}

Agent builds the app asynchronously — direct the builder to the replUrl to track progress. Use replId and replUrl in subsequent tool calls.

`update_app_using_prompt`

Make changes to an existing Replit App. Use this to add features, fix bugs, or iterate on the app after it has been created.

Parameter	Type	Required	Description
`replId`	string (UUID)	Yes	The `replId` from `create_app_from_prompt`.
`changeDescription`	string	Yes	Description of the change to make.
`replUrl`	string	No	The `replUrl` from `create_app_from_prompt`.
`userQuotes`	string \| null	No	Exact user quotes not captured in `changeDescription`.
`attachmentSummary`	string \| null	No	Summary of attachment details.

`ask_question`

Ask Replit Agent about the current app. Runs in discussion mode — it won’t modify the app. Use this to check build status, ask about the tech stack, or relay builders’ questions.

Parameter	Type	Required	Description
`replId`	string (UUID)	Yes	The `replId` from `create_app_from_prompt`.
`question`	string	Yes	The question to send to Replit Agent.

Example workflows

These examples show the prompts an MCP client can translate into Replit tool calls. The exact phrasing is flexible.

Create and iterate on an app

Start with a detailed product prompt:

Create a mobile-friendly neighborhood seed-swap app. Include seed listings, pickup requests, profiles, and a warm, garden-inspired visual style. Name it Seed Circle.

Your client calls create_app_from_prompt, which returns a replId and replUrl. Replit Agent continues building asynchronously, so open the returned URL to follow progress. After the first build, request a focused change:

Add filters for plant type and pickup distance. Keep the existing visual style and make the filters easy to use on mobile.

Your client calls update_app_using_prompt with the original replId. You can continue sending changes against the same app.

Ask about an app without changing it

Use ask_question when you need context instead of an edit:

Which database tables does this app use, and where is the pickup request flow implemented?

The tool runs Replit Agent in discussion mode. It can explain the app or report build progress without modifying files.

Hand off between clients

The replId identifies the app across MCP calls. Store it with the conversation, then provide it when another client continues the work. For example:

Create an app from Claude Code.
Open the returned replUrl to review the live build in Replit.
Continue iterating from another MCP client using the same replId.

Troubleshooting

Error	Cause	Fix
`MCP error -32001: Request timed out`	Tool call took longer than the MCP timeout window. The operation is still running in the background.	Direct the user to the `replUrl`. Do not retry.
`"Replit was not able to build your Replit App."`	Access token is not scoped to the MCP server resource.	Verify your auth provider is configured correctly. If building a custom OAuth flow, ensure the `resource` parameter is set to `https://replit-mcp.com/server/mcp`.
`"Not authenticated"`	No valid session or token.	Re-authenticate through the OAuth flow.

Enterprise

Connectors

Warehouse Connectors

Developer Integrations

Identity and Access Management

Design Systems & Templates

Billing for Enterprise

Replit MCP Server

Server details

Requirements

Authentication

Connecting

Tools

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Example workflows

Create and iterate on an app

Ask about an app without changing it

Hand off between clients

Troubleshooting

​Server details

​Requirements

​Authentication

​Connecting

​Tools

​create_app_from_prompt

​update_app_using_prompt

​ask_question

​Example workflows

​Create and iterate on an app

​Ask about an app without changing it

​Hand off between clients

​Troubleshooting

Server details

Requirements

Authentication

Connecting

Tools

`create_app_from_prompt`

`update_app_using_prompt`

`ask_question`

Example workflows

Create and iterate on an app

Ask about an app without changing it

Hand off between clients

Troubleshooting