# How to add an MCP server to Cursor - Vynix

> Where mcp.json lives, the exact JSON shape Cursor expects, project vs global servers, and how to confirm your tools show up in Agent mode.

[All articles](/blog/)

GuideBy Vynix Engineering·July 2, 2026· 5 min read

# How to add an MCP server to Cursor

Where mcp.json lives, the exact JSON shape Cursor expects, project vs global servers, and how to confirm your tools show up in Agent mode.

Cursor supports MCP (Model Context Protocol) servers in Agent mode: small programs that expose tools the agent can call, from database queries to browser control to structured website feedback. Setup is a single JSON file. This guide shows where that file lives, the exact shape Cursor expects, and how to confirm the tools are available.

## Two places the config can live

-   .cursor/mcp.json in a repository: the server is available only inside that project. Commit it (without secrets) to share with your team.
-   ~/.cursor/mcp.json in your home directory: the server is available in every Cursor window on your machine.

## The JSON shape

example

// .cursor/mcp.json
{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": \["-y", "@usevynix/mcp-server"\],
      "env": {
        "VYNIX\_API\_URL": "https://www.vynix.in",
        "VYNIX\_API\_TOKEN": "<your token>"
      }
    }
  }
}

Each key under mcpServers is a server name you choose. command plus args is what Cursor runs to start the server over stdio; env carries its configuration. You can list several servers side by side in the same file.

## Turn it on and check it

-   Open Cursor Settings, find the MCP section, and confirm your server is listed and enabled.
-   A green indicator and a tool list mean the server started; a red one means the command failed.
-   In an Agent chat, ask for something only that server can do. Cursor shows a tool-call approval the first time, which is also your proof the wiring works.

If the server never turns green, run the command from the config in a terminal (for the example above: npx -y @usevynix/mcp-server). A missing token or a mistyped package name fails loudly there, and the fix is usually obvious.

## What to connect first

The highest-value MCP servers remove copy-paste between your browser and your editor. Website feedback is the classic case: with the Vynix server connected, notes your team leaves on the live site (each with its selector, DOM, console and network context) become tools the Cursor agent can read directly. "Fix the top annotation" replaces a screenshot, three Slack messages and a guess about which element broke.

## Keep reading

[

### AI Bug Reporting: Bug Reports an AI Agent Can Fix

Read](/blog/ai-bug-reporting/)[

### Website Feedback: Collect It and Turn It Into Tickets

Read](/blog/website-feedback/)

## Stop describing bugs. Point at them.

Add one script tag and give your AI agent the context it has been missing. Free while we grow.

[Get started free](/register)[Read the install guide](/install/)

---

Source: https://www.vynix.in/blog/add-mcp-server-cursor/ | Markdown version for AI agents. Full site index: https://www.vynix.in/llms.txt