Replicate

v1.0.0Data Science & MLstable

Enables users to access and manage Replicate's AI models and predictions via the Model Context Protocol, offering tools for creating, canceling, and retrieving model predictions and parameters.

replicate-mcp-servermcpai-integration
Share:
95
Stars
0
Downloads
0
Weekly
0/5

What is Replicate?

Replicate is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables users to access and manage replicate's ai models and predictions via the model context protocol, offering tools for creating, canceling, and retrieving model predictions and parameters.

Enables users to access and manage Replicate's AI models and predictions via the Model Context Protocol, offering tools for creating, canceling, and retrieving model predictions and parameters.

This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables users to access and manage Replicate's AI models and

Use Cases

Create and manage AI model predictions via Replicate API.
deepfates

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx replicate-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Replicate

The mcp-replicate server connects your AI assistant to Replicate's cloud platform, giving it the ability to search Replicate's model library, create and monitor predictions, view generated images, and manage prediction lifecycle — all through natural language. It is useful for developers who want to run image generation, video, audio, or other ML model predictions from within their AI workflow without switching to the Replicate web UI or writing API calls manually.

Prerequisites

  • Node.js 18 or later (for npx / global npm install)
  • A Replicate account and API token (create at replicate.com → Account Settings → API Tokens)
  • An MCP client such as Claude Desktop, Cursor, or Cline
  • The REPLICATE_API_TOKEN environment variable set to your token
1

Get your Replicate API token

Sign in at replicate.com, go to Account Settings → API Tokens, and create a new token. Copy it — you will need it in the MCP config.

2

Install mcp-replicate globally (optional)

You can install the package globally so it is available as a binary, or use npx to run it without installing. The global install approach is shown here.

npm install -g mcp-replicate
3

Configure your MCP client

Add the replicate server to your MCP client config. Set REPLICATE_API_TOKEN to your actual token. If you used the global install, the command is 'mcp-replicate'; for npx use the npx form shown.

{
  "mcpServers": {
    "replicate": {
      "command": "mcp-replicate",
      "env": {
        "REPLICATE_API_TOKEN": "r8_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
4

Restart your MCP client

Restart Claude Desktop or your chosen client to load the new server configuration. The AI should now have access to Replicate model and prediction tools.

5

Test by searching for a model

Ask your AI assistant to search for an image generation model on Replicate to confirm the integration is working.

Replicate Examples

Client configuration

Claude Desktop configuration using mcp-replicate with a Replicate API token.

{
  "mcpServers": {
    "replicate": {
      "command": "mcp-replicate",
      "env": {
        "REPLICATE_API_TOKEN": "r8_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Prompts to try

Use natural language to interact with Replicate models and predictions through your AI assistant.

- "Search Replicate for the best text-to-image models"
- "Run a prediction with stability-ai/stable-diffusion using the prompt 'a sunset over mountain peaks'"
- "List my recent predictions on Replicate and show their status"
- "Show me the available collections of models on Replicate"
- "Cancel the prediction with ID xyz123 on Replicate"

Troubleshooting Replicate

Authentication error or 401 Unauthorized

Verify REPLICATE_API_TOKEN is set correctly in the env block of your MCP config. The token should start with r8_. You can test it with: curl -H 'Authorization: Token r8_your_token' https://api.replicate.com/v1/account

Prediction times out or stays in 'starting' state

Replicate cold-starts GPU instances for some models, which can take 30-120 seconds. Use the create_and_poll_prediction tool (or ask the AI to poll for results) rather than create_prediction alone if you want the AI to wait for completion automatically.

mcp-replicate command not found after global install

Ensure npm's global bin directory is on your PATH. Check with: npm bin -g. Add that directory to your shell's PATH, or use the npx form in the MCP config: "command": "npx", "args": ["-y", "mcp-replicate"].

Frequently Asked Questions about Replicate

What is Replicate?

Replicate is a Model Context Protocol (MCP) server that enables users to access and manage replicate's ai models and predictions via the model context protocol, offering tools for creating, canceling, and retrieving model predictions and parameters. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Replicate?

Follow the installation instructions on the Replicate GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Replicate?

Replicate works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Replicate free to use?

Yes, Replicate is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Data Science & ML MCP Servers

Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "replicate-mcp-server": { "command": "npx", "args": ["-y", "replicate-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Replicate?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides