How to Install MCP Servers in Cursor

How to install MCP servers in Cursor — the global and per-project mcp.json files, adding a server from Settings, and enabling tools in the Agent.

Browse Cursor servers directory

Step-by-step installation guide

  1. Open MCP settings

    Go to Cursor Settings → MCP → Add new MCP server, or edit the JSON directly: ~/.cursor/mcp.json for every project, or .cursor/mcp.json in a project root to scope it to that repo.

  2. Add the server under mcpServers

    Add a named entry with a "command" and "args" (and "env" for secrets), using the same stdio shape as other MCP clients.

  3. Enable it and use it in the Agent

    Cursor picks up the change automatically; make sure the server is toggled on in the MCP settings. Its tools then become available to the Agent (Composer) — the model calls them when relevant.

Configuration

mcp.json
Location
~/.cursor/mcp.json
Snippet
JSON
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"],
      "env": {}
    }
  }
}
View all compatible servers
  • AllMCPs Server logo Verified ListingOwnership or active status confirmed on AllMCPs.
    The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.
    83 20
  • Define, ship & query your analytics tracking from one source of truth, trusted by humans and agents.
    65 0
  • Git logo Verified ListingOwnership or active status confirmed on AllMCPs.
    Tools to read, search, and manipulate Git repositories.
    61 0
  • Influxdb3 MCP Server logo Verified ListingOwnership or active status confirmed on AllMCPs.
    Official MCP server for InfluxDB 3 Core/Enterprise/Cloud Dedicated
    58 0
  • Line Bot MCP Server logo Verified ListingOwnership or active status confirmed on AllMCPs.
    MCP Server for Integrating LINE Official Account
    55 0
  • Feranor Resilience logo Verified ListingOwnership or active status confirmed on AllMCPs.
    Scan/purge hidden text & score web domains: TLS, DNS, headers, speed. Free scans, $0.01 actions. The Tools:
    • text_scan_v1 — free Scans a text string for invisible Unicode characters, homoglyphs, and normalization issues. Returns a risk score, a list of flagged characters, and detected homoglyphs. Never modifies the input text.
    • text_purge_v1 — $0.01 per call Removes invisible Unicode characters and replaces homoglyphs in a text string, then normalizes the result. Returns the cleaned text plus a before-and-after risk comparison.
    • domain_check_score_v1 — free Overall score, per-category scores, and how many findings each category raised. Use it to triage: rank a list of domains, confirm one is healthy, or decide whether the full report is worth pulling. It tells you which categories are weak and how many issues they hold, but not what the issues are.
    • domain_check_score_batch_v1 — free The same triage scores for up to 100 domains in a single call. One score summary per distinct domain: overall score, per-category scores, and how many findings each category raised. Never the findings themselves.
    • domain_check_v1 — $0.01 per call Full report for one domain: weighted score out of 100, per-category breakdown, and every individual finding with a prioritised remediation order.
    • domain_check_batch_v1 — from $0.005 per domain The same full report for up to 100 domains in a single call, with one payment for the whole batch instead of one per domain. Both cheaper per domain and much faster than calling domain_check_v1 in a loop.
    54 0
  • Hub MCP logo
    Hub MCPdocker
    Verified ListingOwnership or active status confirmed on AllMCPs.
    Official MCP server to interact with Docker Hub, providing access to repositories, hub search and Docker Hardened Images
    54 0
  • Vocuno logo Verified ListingOwnership or active status confirmed on AllMCPs.
    Official Vocuno plugin for Claude that connects to Vocuno's remote MCP server for AI song generation, covers, remixes, stem separation, voice conversion, audio editing, mixing, mastering, and music analysis.
    52 0
  • S2 Sdk Typescript logo
    S2 Sdk Typescripts2-streamstore
    Verified ListingOwnership or active status confirmed on AllMCPs.
    Official MCP server for the S2.dev serverless stream platform.
    51 0
  • Moxie Docs MCP logo Verified ListingOwnership or active status confirmed on AllMCPs.
    MCP & Agent Skills for Automated Documentation, and codebase conventions + context
    48 25
  • Infobip MCP logo Verified ListingOwnership or active status confirmed on AllMCPs.
    Official Infobip MCP server for integrating Infobip global cloud communication platform. It equips AI agents with communication superpowers, allowing them to send and receive SMS and RCS messages, interact with WhatsApp and Viber, automate communication workflows, and manage customer data, all in a production-ready environment.
    46 0
  • Keyless docs/discovery. RPC follows chain policy; indexed data and account tools need an API key.
    32 0

Frequently Asked Questions

Cursor reads ~/.cursor/mcp.json for a global configuration available in every project, and .cursor/mcp.json in a project root for servers scoped to that repository. Both use the same "mcpServers" JSON shape as Claude Desktop.

Confirm the server is toggled on in Cursor Settings → MCP, that the command runs on its own in a terminal, and that you are using the Agent (Composer), since MCP tools are called from agent mode. A red status in the MCP panel usually shows the underlying error.

Yes — commit a .cursor/mcp.json to your repository. Anyone who opens the project in Cursor gets the same servers, though each person still supplies their own secrets via env values.

Install MCP servers in other clients