# Custom MCP servers in Replit

Source: https://www.youtube.com/watch?v=4fBDCiWn9Eo
Recap page: https://rapidrecap.app/video/4fBDCiWn9Eo
Generated: 2025-12-08T17:33:40.931+00:00

---
## Quick Overview

Replit Agent supports connecting to custom Model Context Protocol (MCP) servers, enabling users to integrate private or self-hosted context sources like the demonstrated "Context Awesome" server or the Amplitude MCP server, which requires OAuth authorization, by adding the server details in the Integrations settings.

**Key Points:**
- Replit Agent now supports connecting to custom Model Context Protocol (MCP) servers via the Integrations page by clicking "Add Custom MCP".
- A self-hosted example, "Context Awesome," which provides access to over 8,500 curated lists, is configured using its URL and API key authentication.
- The process for custom MCP servers involves adding a Display Name and the MCP Server URL, followed by testing and saving.
- For OAuth-based servers, like the Amplitude MCP server shown, the connection process requires authorization via a pop-up window after clicking "Authorize with OAuth".
- Once connected, the custom MCP server appears in the list alongside built-in options like Figma MCP and is immediately available for use by the Replit Agent.
- The agent successfully utilized the custom "Awesome List" MCP integration to find curated resources for technical writing upon request (01:39).

![Screenshot at 00:22: The interface displays the "Connect Custom MCP" modal, showing where users input the Display Name and MCP Server URL for a new integration, highlighting the mechanism for adding external context sources to Replit Agent.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-00-22.png)

**Context:** This video tutorial demonstrates how to extend the capabilities of the Replit Agent by integrating custom Model Context Protocol (MCP) servers beyond the pre-configured options like Figma. MCP servers provide external context, data, or resources to the AI agent to improve its responses, and Replit now allows users to connect their own private or third-party MCP endpoints, which can use either API key authentication or OAuth.

## Detailed Analysis

The video walks through adding custom Model Context Protocol (MCP) servers to Replit Agent via the Integrations settings page (00:01). The presenter first shows the existing integrations list, which includes services like Outlook, Zendesk, and GitHub providers. The key feature demonstrated is the ability to add custom MCP servers by clicking the "+ Add Custom MCP" button (00:23). The presenter first uses a publicly available example called "Context Awesome," a hosted MCP server providing access to over 8,500 curated lists, by inputting its URL and configuring it as an API key authenticated server (00:37-00:57). After adding and testing the connection, this server appears in the list (01:13). Next, the presenter demonstrates connecting an OAuth-required server, specifically the Amplitude MCP server, which is used for data analysis context (02:33). This requires clicking "Authorize with OAuth," which triggers a browser pop-up prompting the user to authorize Replit's MCP Connector to access their Amplitude account (02:41-02:48). Upon successful authorization, the Amplitude server is added to the active list (02:51). Finally, the presenter confirms that the Replit Agent can immediately use these newly added custom servers, showing the agent successfully querying the custom "Awesome List" MCP for resources on technical writing (01:39-01:48). The presenter concludes by mentioning that deploying your own custom MCP server with OAuth authentication from within Replit is coming soon.

### Navigating Integrations

- Accessing the Integrations page in Replit settings
- Viewing existing service integrations like Git Providers and MCP Servers
- Locating the "+ Add Custom MCP" option.

### Configuring API Key Authenticated MCP

- Setting up the "Context Awesome" server by providing Display Name and URL
- Testing and saving the configuration for API-key based servers.

### Configuring OAuth Authenticated MCP

- Adding the Amplitude MCP server
- The system prompts for OAuth authorization via a pop-up window requiring user consent to grant access to the external service.

### Agent Utilization

- Demonstrating the agent instantly using the newly added custom MCP server ("Awesome List") to answer a query about technical writing resources (01:39)
- Showing search results sourced from the custom context.

### Future Features

- Mentioning upcoming capability to deploy custom MCP servers directly within Replit using OAuth authentication (03:32).

![Screenshot at 00:16: The Replit Integrations page showing the list of available third-party services and the section for MCP Servers for Replit Agent.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-00-16.png)
![Screenshot at 00:38: A slide detailing the features of the "Context Awesome" MCP server, including access to 8,500+ awesome lists and direct integration with Claude, Cursor, and VS Code.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-00-38.png)
![Screenshot at 01:17: The Replit chat interface showing the Agent performing a task, indicating it is using the newly integrated "Awesome List" MCP tool to find resources for technical writing.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-01-17.png)
![Screenshot at 02:22: The "Connect Custom MCP Server" modal open, showing the input fields for Display Name, MCP Server URL, and optional custom headers.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-02-22.png)
![Screenshot at 02:46: The Amplitude authorization pop-up window, requesting permission for the "Replit MCP Connector" to access the user's Amplitude account.](https://ss.rapidrecap.app/screens/4fBDCiWn9Eo/00-02-46.png)
