Last updated April 2026. Tested on Cursor 2.6.22 on macOS 15 Sequoia and Windows 11.

---

What MCP servers do in Cursor

MCP servers give Cursor access to external tools and data. Without them, Cursor can only work with the files open in your project. With them, Cursor can search the web, read documentation, query databases, call APIs — anything the server provides.

When you install an MCP server, Cursor discovers its tools automatically. You don't need to tell Cursor "use the search tool" — it reads the tool descriptions and calls the right one based on your prompt.

Method 1: One-command install (recommended)

The fastest way to add an MCP server to Cursor:

bashCOPY
# Install the AgenticMarket CLI (once)
npm install -g agenticmarket

# Authenticate (once)
agenticmarket auth am_live_your_key

# Install any server — Cursor gets configured automatically
agenticmarket install agenticmarket/web-reader

The CLI detects that Cursor is installed, writes the correct config to ~/.cursor/mcp.json, and the server appears in Cursor's MCP settings immediately.

Why this is better than manual setup: The CLI handles the config key name (mcpServers for Cursor), file paths, and auth headers. You never touch JSON.

---

Method 2: Manual JSON setup

Create or edit ~/.cursor/mcp.json (global config) or .cursor/mcp.json in your project root (workspace config):

Remote HTTP server

jsonCOPY
{
  "mcpServers": {
    "web-reader": {
      "url": "https://your-server-url/mcp"
    }
  }
}

Local stdio server

jsonCOPY
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

After saving, go to Cursor Settings → Tools & MCP → MCP Servers to verify. A green dot means connected.

Critical: Cursor uses mcpServers as the root key. If you copied a config from a VS Code guide, the key might be servers — Cursor will silently ignore it.

---

Verifying the server is active

1. Open Cursor Settings (Cmd+, or Ctrl+,)
2. Navigate to Tools & MCP → MCP Servers
3. Check the status indicator:
   • 🟢 Green = connected and ready
   • 🔴 Red = connection failed (hover for error details)
   • ⚪ Grey = not initialized

If the status is red, see the troubleshooting section below.

---

Recommended MCP servers for Cursor

Browse all available servers at agenticmarket.dev/servers.

---

Troubleshooting Cursor MCP issues

Server doesn't appear in settings Cursor reads from ~/.cursor/mcp.json. Make sure:

1. The file exists at the correct path
2. The root key is mcpServers (not servers)
3. The JSON is valid — paste into jsonlint.com to check

Status shows red dot Hover over the server entry for the actual error. Common causes:

• Connection refused: The server URL is unreachable. For remote servers, check if the URL is correct.
• MCP disabled: Make sure MCP server is enabled.
• Auth error: The auth header is missing or malformed.
• npx not found: For stdio servers, use the full path from which npx instead of just npx.

Tools appear but Cursor doesn't use them Check the 40-tool limit. Cursor deprioritizes tools when too many servers are installed. Disable servers you're not actively using in the MCP settings panel.

Still stuck? See our complete MCP troubleshooting guide for every error code and fix.

---

Next steps

• Browse all MCP servers available on AgenticMarket
• What is MCP? — understand the protocol from the ground up
• How to Install MCP Servers Without JSON — full multi-IDE guide

---

This guide is updated when Cursor changes its MCP handling. Last reviewed April 2026 on Cursor 2.6.22.