> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Install Links

> Reference for MCP install links — URL format, payload schema, and badge customization.

Install links let users add your MCP server to Replit with a single click. To generate one, use the form on [Connect via MCP](/build/connect-via-mcp#share-an-install-link).

## Link format

Install links use a base64-encoded JSON payload containing your server configuration:

```
https://replit.com/integrations?mcp={payload}
```

The payload includes:

* **displayName**: The name shown to users during installation
* **baseUrl**: Your MCP server's HTTPS endpoint
* **headers**: Optional authentication headers

```json theme={null}
{
  "displayName": "My MCP Server",
  "baseUrl": "https://example.com/mcp",
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer your-token"
    }
  ]
}
```

## Using badges

Add a clickable badge to your README or documentation that installs your MCP server when clicked.

```markdown theme={null}
[![Install My MCP](https://replit.com/badge?caption=Install%20My%20MCP)](https://replit.com/integrations?mcp={payload})
```

<Frame>
  ![Install MCP Badge](https://replit.com/badge?caption=Install%20MCP%20Server)
</Frame>

You can customize the badge caption (maximum 30 characters) by URL-encoding the text in the `caption` parameter.