How to Set Up an MCP Server in Cursor (Complete 2026 Guide)

What is Model Context Protocol in Cursor?

Cursor has rapidly become the flagship AI code editor for software engineers. While LLM code autocompletion and agent chat in Cursor are world-class, standard AI models are fundamentally sandboxed: they cannot execute live network calls, query search engine ranking databases, or analyze live production sites unless you provide external tool integration.

Enter the Model Context Protocol (MCP), created by Anthropic and adopted as the universal standard for AI agent tool execution. By configuring an MCP server in Cursor, you empower Composer and Cursor Agent with native function-calling capabilities. When you ask Cursor to audit a URL or discover keyword gaps, it invokes your MCP server directly over standard JSON-RPC 2.0 without leaving your workspace.

Server-Sent Events (SSE) vs Stdio: Which Transport Should You Pick?

Cursor supports two primary transport protocols for MCP servers:

For cloud-native intelligence like RankForge, SSE is the recommended standard. It requires zero package installations, runs entirely on Cloudflare edge workers, and stays persistent across any computer where you log into Cursor.

Step-by-Step: Adding an MCP Server to Cursor Settings

Step 1: Open Cursor Settings

Launch Cursor. Click the gear icon in the top right corner (or press Ctrl+, on Windows/Linux or Cmd+, on macOS). Navigate to Features → MCP Servers in the left sidebar.

Step 2: Click “+ Add New MCP Server”

Cursor provides a straightforward modal dialog where you define three parameters:

• Name: rankforge-seo
• Type: Select sse
• Server URL: https://mcp.rankforge.app/sse?token=YOUR_API_TOKEN

Step 3: Alternative — Direct JSON File Configuration

If you manage multiple projects or prefer version-controlled configs, Cursor also reads configuration from ~/.cursor/mcp.json or project-level .cursor/mcp.json.

{
  "mcpServers": {
    "rankforge": {
      "url": "https://mcp.rankforge.app/sse?token=YOUR_RANKFORGE_TOKEN",
      "transport": "sse"
    }
  }
}

Use Our Free 1-Click MCP Config Generator

Tired of manually formatting JSON and escaping quotes? We built a 100% free, ungated utility to generate perfect configs for Cursor, Claude Code, Windsurf, Cline, and Zed in seconds.

Testing Your SEO Tools in Cursor Agent

Once connected, the status light in Cursor Settings turns green (✓ Connected - 8 Tools Available). Open Cursor Composer (Ctrl+I or Cmd+I) in Agent Mode and try these natural language commands:

Cursor Agent will immediately execute rankforge.seo_audit, retrieve the 100-point audit JSON from RankForge, inspect the issues, and propose a code diff directly in your editor.

Troubleshooting Common Cursor MCP Issues

Issue 1: Status shows “Disconnected” or red dot

Verify that your token has not expired or been revoked. You can test your connection directly by pasting the SSE URL in your browser — it should return a stream connection header or event: endpoint.

Issue 2: Composer does not call tools

Make sure Cursor is in Agent Mode rather than basic Chat or Edit mode. In basic edit mode, function calls are disabled to preserve local token quotas.

Issue 3: Stdio transport says “command not found: npx”

Cursor needs your global system PATH to resolve Node.js binaries. Launch Cursor from your terminal by typing cursor . within your workspace directory so it inherits your shell environment variables.

Summary & Next Steps

Setting up an MCP server transforms Cursor from a simple text editor into an autonomous developer agency. With RankForge connected, you no longer need multiple subscription dashboards or manual exports: SEO audits, keyword gap discovery, and Core Web Vitals checks happen in real-time as you write code.