MCP Server

Mercur exposes a Model Context Protocol (MCP) server that lets AI tools search Mercur documentation directly. Instead of relying on training data that may be outdated, your AI assistant queries the actual docs in real time.

https://docs.mercurjs.com/mcp

Available tool

SearchMercurJsDocumentation

Searches across all Mercur documentation and returns:

Relevant excerpts matching your query
Page titles for context
Direct links to documentation pages

Use it when you need to look up API references, understand how a module works, find CLI commands, or retrieve examples during development.

Connect to your AI environment

Cursor
VS Code
Windsurf
Claude
Claude Code

Open MCP settings

Press Cmd + Shift + P
Search for Open MCP settings
Select Add custom MCP

Configure the server

Add the following to your mcp.json:

{
  "mcpServers": {
    "mercur": {
      "url": "https://docs.mercurjs.com/mcp"
    }
  }
}

Use it

Restart Cursor and ask: “Search Mercur docs for how to add a block”

See Cursor MCP docs for more.

Create MCP config

Create a file at .vscode/mcp.json in your project root.

Configure the server

{
  "servers": {
    "mercur": {
      "type": "http",
      "url": "https://docs.mercurjs.com/mcp"
    }
  }
}

Use it

Open the Copilot Chat panel and ask: “List available MCP servers.”

See VS Code MCP docs for more.

Open MCP config

Press Cmd + Shift + P
Search for Open Windsurf MCP Configuration

Configure the server

{
  "mcpServers": {
    "mercur": {
      "serverUrl": "https://docs.mercurjs.com/mcp"
    }
  }
}

Use it

Open Cascade and ask: “Search Mercur docs for seller setup”

Add the MCP server

Go to Claude → Settings → Connectors
Select Add custom connector
Enter:
- Name: Mercur
- URL: https://docs.mercurjs.com/mcp
Save

Use it

In chat, click the attachments (+) button and select your Mercur MCP connector.

See Claude connector docs for more.

Install the MCP server

claude mcp add --transport http mercur https://docs.mercurjs.com/mcp

Verify installation

claude mcp list

Use it

Claude Code can now query Mercur documentation directly during any conversation.

See Claude Code MCP docs for more.

Choosing an approach

Approach	Best for
Bundled docs	Coding agents inside a project — version-matched, offline, no setup
MCP Server	Live search from your editor, always the latest published docs
llms.txt	Feeding full context to a chat assistant (Claude, ChatGPT)

Tutorials

Customization

Integrations

Best practices

Deployment

Building with AI

MCP Server

MCP Server

Available tool

SearchMercurJsDocumentation

Connect to your AI environment

Choosing an approach

​MCP Server

​Available tool

​SearchMercurJsDocumentation

​Connect to your AI environment

​Choosing an approach

MCP Server

Available tool

SearchMercurJsDocumentation

Connect to your AI environment

Choosing an approach