• Tech Dev NotesTech Dev Notes
Apps
  • App lookup
  • App compare
Market movement
  • App charts
  • App rankings
Visual proof
  • App screens
  • App listing screenshots
  • App icons
Build intelligence
  • App tech stacks
  • Tool releases
  • Developers
More
  • X feature flags
  • Grokipedia
  • Blog
  • Follow on X
Skip to content
All content/ filesChangelog

cursor-docs/latest/content · Jun 26, 20:20 UTC

pages/cli/mcp.txt

TXT·2.8 KB·60 lines

content/

  • pages

    • api.txt
    • approval-agents.txt
    • bugbot.txt
    • cloud-agent.txt
    • customize-cursor.txt
    • enterprise.txt
    • evals.txt
    • extension-api.txt
    • hooks.txt
    • mcp.txt
    • models-and-pricing.txt
    • plugins.txt
    • rules.txt

  • pages/account

    • regions.txt
    • update-access.txt

  • pages/account/enterprise

    • billing-groups.txt
    • cyber-safeguards.txt
    • service-accounts.txt

  • pages/account/organizations

    • organization-admin-api.txt

  • pages/account/pricing

    • request-based-legacy.txt

  • pages/account/teams

    • admin-api.txt
    • ai-code-tracking-api.txt
    • analytics-api.txt
    • analytics.txt
    • dashboard.txt
    • members.txt
    • pricing.txt
    • scim.txt
    • setup.txt
    • sso.txt

  • pages/agent

    • agent-review.txt
    • agents-window.txt
    • debug-mode.txt
    • design-mode.txt
    • overview.txt
    • plan-mode.txt
    • prompting.txt
    • security.txt

  • pages/agent/security

    • run-modes.txt

  • pages/agent/tools

    • browser.txt
    • canvas.txt
    • search.txt
    • terminal.txt

  • pages/cli

    • acp.txt
    • changelog.txt
    • github-actions.txt
    • headless.txt
    • installation.txt
    • mcp.txt
    • overview.txt
    • shell-mode.txt
    • using.txt

  • pages/cli/reference

    • authentication.txt
    • configuration.txt
    • output-format.txt
    • parameters.txt
    • permissions.txt
    • slash-commands.txt
    • terminal-setup.txt

  • pages/cloud-agent

    • automations.txt
    • best-practices.txt
    • capabilities.txt
    • choose-runtime.txt
    • my-machines.txt
    • private-workers.txt
    • security-network.txt
    • self-hosted-cloud-run.txt
    • self-hosted-k8s.txt
    • self-hosted-pool.txt
    • settings.txt
    • setup.txt

  • pages/cloud-agent/api

    • endpoints.txt
    • webhooks.txt

  • pages/configuration

    • worktrees.txt

  • pages/configuration/migrations

    • vscode.txt

  • pages/cursor-review

    • merge-queue.txt
    • overview.txt
    • pr-inbox.txt
    • pr-page.txt

  • pages/cursor-review/cli

    • authentication.txt
    • parameters.txt
    • stacking.txt

  • pages/customizing

    • aws-bedrock.txt

  • pages/enterprise

    • baa.txt
    • compliance-and-monitoring.txt
    • deployment-patterns.txt
    • endpoint-security.txt
    • identity-and-access-management.txt
    • llm-safety-and-controls.txt
    • model-and-integration-management.txt
    • network-configuration.txt
    • organization-groups.txt
    • organizations.txt
    • pooled-usage.txt
    • privacy-and-data-governance.txt
    • private-connectivity.txt
    • security-hardening.txt

  • pages/get-started

    • quickstart.txt

  • pages/integrations

    • azure-devops.txt
    • bitbucket.txt
    • cursor-blame.txt
    • github.txt
    • gitlab.txt
    • jetbrains.txt
    • jira.txt
    • linear.txt
    • microsoft-teams.txt
    • notion.txt
    • slack.txt
    • xcode.txt

  • pages/mcp

    • install-links.txt

  • pages/models

    • claude-4-5-haiku.txt
    • claude-4-5-sonnet.txt
    • claude-4-6-sonnet.txt
    • claude-4-sonnet-1m.txt
    • claude-4-sonnet.txt
    • claude-fable-5.txt
    • claude-opus-4-5.txt
    • claude-opus-4-6-fast.txt
    • claude-opus-4-6.txt
    • claude-opus-4-7-fast.txt
    • claude-opus-4-7.txt
    • claude-opus-4-8.txt
    • cursor-composer-1-5.txt
    • cursor-composer-1.txt
    • cursor-composer-2-5.txt
    • cursor-composer-2.txt
    • gemini-2-5-flash.txt
    • gemini-3-1-pro.txt
    • gemini-3-5-flash.txt
    • gemini-3-flash.txt
    • gemini-3-pro-image-preview.txt
    • gemini-3-pro.txt
    • glm-5-2.txt
    • gpt-5-1-codex-max.txt
    • gpt-5-1-codex-mini.txt
    • gpt-5-1-codex.txt
    • gpt-5-2-codex.txt
    • gpt-5-2.txt
    • gpt-5-3-codex.txt
    • gpt-5-4-mini.txt
    • gpt-5-4-nano.txt
    • gpt-5-4.txt
    • gpt-5-5.txt
    • gpt-5-codex.txt
    • gpt-5-fast.txt
    • gpt-5-mini.txt
    • gpt-5.txt
    • grok-4-20.txt
    • grok-4-3.txt
    • grok-build-0-1.txt
    • kimi-k2-5.txt

  • pages/reference

    • deeplinks.txt
    • ignore-file.txt
    • keyboard-shortcuts.txt
    • permissions.txt
    • plugins.txt
    • sandbox.txt
    • third-party-hooks.txt

  • pages/sdk

    • python.txt
route: /docs/cli/mcp
title: MCP
description: Use Model Context Protocol servers with Cursor CLI for extended functionality. Configure MCP tools and manage server connections from the command line.

MCP
Overview
The Cursor CLI supports Model Context Protocol (MCP) servers, allowing you to connect external tools and data sources to agent. MCP in the CLI uses the same configuration as the editor - any MCP servers you've configured will work with both.
Learn about MCP
New to MCP? Read the complete guide on configuration, authentication, and
available servers
CLI commands
Use the agent mcp command to manage MCP servers
List configured servers
View all configured MCP servers and their current status:
agent mcp list
This opens an interactive menu where you can browse, enable, and configure MCP servers at a glance. The list shows:
Server names and identifiers
Connection status (connected/disconnected)
Configuration source (project or global)
Transport method (stdio, HTTP, SSE)
You can also use the /mcp list slash command in interactive mode for the same interface.
List available tools
View tools provided by a specific MCP server:
agent mcp list-tools <identifier>
This displays:
Tool names and descriptions
Required and optional parameters
Parameter types and constraints
Login to MCP server
Authenticate with an MCP server configured in your mcp.json:
agent mcp login <identifier>
The CLI uses a streamlined login flow with automatic callback handling. The agent gets access to authenticated MCPs immediately after login completes.
Enable MCP server
Enable an MCP server:
agent mcp enable <identifier>
This adds the server to the local approved list.
Disable MCP server
Disable an MCP server:
agent mcp disable <identifier>
Disabled servers won't load or prompt for approval.
MCP server names with spaces are supported in CLI commands and /mcp list-tools.
Using MCP with Agent
Once you have MCP servers configured (see the main MCP guide for setup), agent automatically discovers and uses available tools when relevant to your requests.
# Check what MCP servers are available
agent mcp list
# See what tools a specific server provides
agent mcp list-tools playwright
# Use agent - it automatically uses MCP tools when helpful
agent -p "Navigate to google.com and take a screenshot of the search page"
# Auto-approve all MCP servers (skip approval prompts)
agent --approve-mcps "query my database for recent errors"
The CLI follows the same configuration precedence as the editor (project → global → nested), automatically discovering configurations from parent directories.
MCP vs ACP
Use MCP when you want Cursor to call external tools and services. Use ACP when you want to build a custom client that talks to Cursor CLI itself over protocol messages.
Related
MCP Overview
Complete MCP guide: setup, configuration, and authentication
Available MCP Tools
Browse pre-built MCP servers you can use
Previouspages/cli/installation.txtNextpages/cli/overview.txt

© 2026 Tech Dev Notes

RSSAboutAPIPrivacyTermsSitemap@techdevnotes