---
title: "MCP"
description: "Use MCP tools to query Mercur documentation directly from your AI environment."
---

# MCP

Mercur exposes an MCP server that allows AI tools to **query Mercur documentation directly**.\
This ensures assistants can provide accurate, context-aware answers based on the actual docs instead of relying on assumptions.

---

# Available Tool

## **SearchMercurJsDocumentation**

This MCP tool enables AI assistants to search across all Mercur documentation.\
It returns:

- relevant excerpts
- page titles
- direct documentation links

Useful when you need to locate API references, understand how a module works, or retrieve examples quickly during development.

---

# MCP Server URL

Your MCP server is available at:

https://docs.mercurjs.com/mcp

You can connect this URL to any MCP-compatible environment.

---

# Connecting the MCP Server

Use the tabs below to connect the Mercur MCP server in different environments:

<Tabs>
  <Tab title="Cursor">
    <Steps>
      <Step title="Open MCP settings">
        1. Press <kbd>Cmd</kbd>

            + <kbd>Shift</kbd>

            + <kbd>P</kbd>
        2. Search for **Open MCP settings**
        3. Select **Add custom MCP**
      </Step>
      <Step title="Configure the server">
        Add the following to your `mcp.json`:

        ```json
        {
          "mcpServers": {
            "mercur": {
              "url": "https://docs.mercurjs.com/mcp"
            }
          }
        }
        ```
      </Step>
      <Step title="Use it">
        Restart Cursor and ask:\
        **“What MCP tools are available?”**
      </Step>
    </Steps>
    See Cursor docs for more: https://docs.cursor.com/en/context/mcp
  </Tab>
  <Tab title="VS Code">
    <Steps>
      <Step title="Create MCP config">
        Create a file at:\
        `.vscode/mcp.json`
      </Step>
      <Step title="Configure the server">
        ```json
        {
          "servers": {
            "mercur": {
              "type": "http",
              "url": "https://docs.mercurjs.com/mcp"
            }
          }
        }
        ```
      </Step>
      <Step title="Use it">
        Open the Copilot Chat panel and ask:\
        **“List available MCP servers.”**
      </Step>
    </Steps>
    See VS Code docs for more: https://code.visualstudio.com/docs/copilot/chat/mcp-servers
  </Tab>
  <Tab title="Claude">
    <Steps>
      <Step title="Add the MCP server">
        1. Go to Claude → Settings → **Connectors**
        2. Select **Add custom connector**
        3. Enter:
           - **Name**: Mercur
           - **URL**: `https://docs.mercurjs.com/mcp`
        4. Save
      </Step>
      <Step title="Use it">
        In chat, click the **attachments (+)** button and select your Mercur MCP connector.
      </Step>
    </Steps>
    See Claude connector docs:\
    https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server
  </Tab>
  <Tab title="Claude Code">
    <Steps>
      <Step title="Install the MCP server">
        ```bash
        claude mcp add --transport http mercur https://docs.mercurjs.com/mcp
        ```
      </Step>
      <Step title="Verify installation">
        ```bash
        claude mcp list
        ```
      </Step>
      <Step title="Use it">
        Now Claude Code can query Mercur documentation directly.
      </Step>
    </Steps>
    Docs: https://docs.anthropic.com/en/docs/claude-code/mcp
  </Tab>
</Tabs>

---