Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/neon-solutions/add-mcp/llms.txt

Use this file to discover all available pages before exploring further.

The list command reads the configuration files of all detected AI coding agents and prints every MCP server they have installed, along with each server’s identity — its URL for remote servers, or its package/command for stdio servers. Use it to get a quick overview of what is installed and where.

Usage

npx add-mcp list [options]

Options

-g, --global
flag
List servers from user-level (global) config files instead of the project-level configs in the current directory.
-a, --agent <agent>
string (repeatable)
Filter output to one or more specific agents (e.g. -a cursor). The specified agent is shown even if it is not currently detected in the project. Can be repeated for multiple agents.

Behavior

Without any options, list scans the current directory for project-level config files (.cursor/mcp.json, .mcp.json, .vscode/mcp.json, etc.) and reports every MCP server found in each detected agent’s config. For each agent the output shows:
  • The agent display name as a heading.
  • Each installed server’s name and identity (URL or package name) in parentheses.
Agents that are detected but have no servers configured display a no servers configured message. If no agents are detected at all, the CLI prints a hint suggesting --global or -a to investigate further.
When you pass -a to target a specific agent, that agent is always shown in the output — even if no config file exists for it in the current directory.

Examples

npx add-mcp list

Example output

Cursor:
  - context7 (https://mcp.context7.com/mcp)
  - postgres (npx -y @modelcontextprotocol/server-postgres)

Claude Code:
  - context7 (https://mcp.context7.com/mcp)

VS Code:
  no servers configured
Run npx add-mcp list-agents to see all 15 supported agent names and their --agent flag values.

Build docs developers (and LLMs) love