MCP Docs Setup - Emerge API

The Model Context Protocol (MCP) allows AI tools to search and query documentation directly. An MCP server is automatically generated for these docs.

Looking for the Query API MCP server? This page covers the documentation MCP server. For AI agent access to the Query API (data retrieval), see Query API MCP Setup.

MCP Servers

Emerge provides two MCP servers:

Server	Purpose	URL
Documentation	Search and query these docs	`https://docs.emergedata.ai/mcp`
Query API	Retrieve user data	`https://mcp.emergedata.ai/mcp`

This page covers the Documentation MCP server setup. For Query API MCP server setup, see Query API MCP Setup.

Documentation MCP Server URL

https://docs.emergedata.ai/mcp

Transport: Streamable HTTP (http)

Setup by tool

Add MCP server

claude mcp add --transport http emerge https://docs.emergedata.ai/mcp

Verify connection

claude mcp list

You should see:

emerge: https://docs.emergedata.ai/mcp (connected)

Usage

Claude Code will automatically use the docs when relevant:

claude "How do I implement delta queries in Emerge?"

Configuration file

Update claude_desktop_config.json:

{
  "mcpServers": {
    "emerge": {
      "command": "",
      "url": "https://docs.emergedata.ai/mcp"
    }
  }
}

Configuration file

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "Emerge": {
      "type": "http",
      "url": "https://docs.emergedata.ai/mcp"
    }
  }
}

Global configuration

For all projects, add to your global Cursor settings:

Open Cursor
Press Cmd/Ctrl + , for settings
Search for “MCP”
Add the server configuration

Usage

Once configured, Cursor can:

Answer questions about Emerge API in chat
Generate integration code with context
Explain error messages and suggest fixes

MCP configuration

Create .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "Emerge": {
      "type": "http",
      "url": "https://docs.emergedata.ai/mcp"
    }
  }
}

With GitHub Copilot

If using Copilot Chat, the MCP connection provides:

Accurate Emerge API suggestions
Code completion with real examples
Documentation-backed explanations

With other AI extensions

Any VS Code AI extension supporting MCP can use this configuration.

Add MCP server

codex mcp add emerge --url https://docs.emergedata.ai/mcp

Verify connection

codex mcp list

Configuration file

Update mcp_config.json:

{
  "mcpServers": {
    "emerge": {
      "url": "https://docs.emergedata.ai/mcp",
      "headers": {}
    }
  }
}

Verifying the connection

After setup, test the connection by asking your AI tool:

“Search the Emerge documentation for how to handle callbacks”

The AI should:

Query the MCP server
Find the callbacks documentation
Return a detailed answer with code examples

If the AI gives a generic response or says it can’t find information, the MCP connection may not be configured correctly.

Troubleshooting

AI doesn't use the MCP server

Some AI tools require explicit activation:

Restart the tool after adding configuration
Check that the config file is in the correct location
Verify the URL is exactly https://docs.emergedata.ai/mcp
Verify transport is http (not sse)

Connection timeout

The MCP server should respond within seconds. If timeouts occur:

Check your internet connection
Try accessing the URL in a browser
Contact support if the issue persists

Outdated responses

The MCP server reflects the current live documentation. If responses seem outdated:

The AI may be using cached context
Start a new conversation
Explicitly ask it to search the docs again

What the AI can access

The MCP server provides access to:

All guide pages (Link API, Query API, etc.)

API reference documentation

Code examples in TypeScript and Python

Troubleshooting and best practices

The AI cannot:

Access your API credentials
Make API calls on your behalf
See your application’s data

Next steps

Contextual Menu

One-click AI integrations on every page

Examples

See AI workflow examples

Getting Started

MCP Servers

Examples

​MCP Servers

​Documentation MCP Server URL

​Setup by tool

​Add MCP server

​Verify connection

​Usage

​Configuration file

​Configuration file

​Global configuration

​Usage

​MCP configuration

​With GitHub Copilot

​With other AI extensions

​Add MCP server

​Verify connection

​Configuration file

​Verifying the connection

​Troubleshooting

​What the AI can access

​Next steps

Contextual Menu

Examples

MCP Servers

Documentation MCP Server URL

Setup by tool

Add MCP server

Verify connection

Usage

Configuration file

Configuration file

Global configuration

Usage

MCP configuration

With GitHub Copilot

With other AI extensions

Add MCP server

Verify connection

Configuration file

Verifying the connection

Troubleshooting

What the AI can access

Next steps