Reduce installation friction for your MCP servers
MCPs can be installed in dozens of clients, and usually requires the user to run commands or edit a JSON configuration file somewhere, sometimes also restart the client. When you're building an MCP server, it's a giant overhead having to provide these instructions to your users for every client. That's where install-this-mcp comes in. This library and website generates comprehensive installation guides for MCP (Model Context Protocol) servers across different clients. Check the latest demo here
To fit everyones needs, you can get the installation guide in a multitude of ways:
| Method | Example |
|---|---|
| Simple Link | https://installthismcp.com/NAME?url=https://example.com/mcp |
| Iframe Embed | <iframe src="https://installthismcp.com/Parallel%20Task%20MCP?url=https%3A%2F%2Ftask-mcp.parallel.ai%2Fmcp&iframe=1" width="100%" height="600px"></iframe> |
| Structured JSON | Render the installation methods in any way you like. npm i install-this-mcp |
| Markdown Button |  |
| Markdown Client List | - Cursor - VS Code - Claude Desktop / Claude.ai - Claude Code - Windsurf - Cline - Gemini CLI - ChatGPT |
| Full Markdown Guide | Example: https://github.com/jaw9c/awesome-remote-mcp-servers |
Changelog:
const {
generateMCPConfig,
generateMCPInstallationGuide,
} = require("mcp-installation-guide");
// Get configuration objects
const configs = generateMCPConfig("https://api.example.com/mcp", "My Server");
// Get markdown guide
const markdown = generateMCPInstallationGuide(
"https://api.example.com/mcp",
"My Server"
);The Cloudflare Worker is hosted at installthismcp.com and provides:
- Landing page: Visit the root URL to access a form for entering server details
- Guide generation: Visit
/{serverName}?url={mcpUrl}to generate a styled HTML guide
- Landing page: https://installthismcp.com
- Direct guide: https://installthismcp.com/Weather%20Server?url=https://api.example.com/mcp
- Install dependencies:
npm install - Test locally:
wrangler dev - Deploy:
wrangler publish
Does this support local MCPs?
No, this is currently out of scope for us. installthismcp.com only supports remote MCPs. However, please reach out if you want to contribute and maintain this part.
Does this support MCPs requiring API keys?
No, also this is out of scope, and we are working towards a world where every client offers one-click installation without complex configuration instructions. Currently only public MCPs (without auth) or MCPs with OAuth (according to the MCP protocol spec) are supported.
Can you add LLM client XYZ?
We favor clients with wide adoption, but less popular clients are also welcome if they have one-click-install deeplink support and support oauth. To add a client, please open a PR altering index.js.
- Do more testing regarding the iframe opening one-click installation things across browsers and possibly automate this and connect with vendors
- Support official registry entries
- Align this with server-cards spec that comes out of modelcontextprotocol/modelcontextprotocol#1649