Connect Cursor to Prometheux using the Local MCP Server. This guide covers the Cursor-specific setup steps.
Recommended: Use the Local ServerWe recommend using the local MCP server (stdio) with Cursor for the most reliable experience. The remote server uses OAuth 2.0 which may not work reliably in all Cursor versions.

​
Prerequisites

​
1. Install the MCP Package

If you haven’t already, install prometheux-mcp: macOS: 
brew install pipx
pipx ensurepath
pipx install prometheux-mcp
Windows/Linux: 
pip install pipx
pipx ensurepath
pipx install prometheux-mcp

​
2. Configure Cursor

Create or edit the MCP configuration file:
ScopePathNotes
Project-specific.cursor/mcp.json (inside your project root)Shared with your team via git
Global (all projects)~/.cursor/mcp.json (your home directory)Available everywhere
Add the following configuration: 
{
  "mcpServers": {
    "prometheux": {
      "command": "/Users/YOUR_USERNAME/.local/bin/prometheux-mcp",
      "args": ["--url", "https://api.prometheux.ai"],
      "env": {
        "PROMETHEUX_TOKEN": "your_token_here",
        "PROMETHEUX_USERNAME": "your_username",
        "PROMETHEUX_ORGANIZATION": "your_organization"
      }
    }
  }
}
Finding Your PathRun which prometheux-mcp (macOS/Linux) or where prometheux-mcp (Windows) to find the correct path for the command field.Common paths after pipx install:
  • macOS: /Users/YOUR_USERNAME/.local/bin/prometheux-mcp
  • Windows: C:\\Users\\YOUR_USERNAME\\.local\\bin\\prometheux-mcp.exe
  • Linux: /home/YOUR_USERNAME/.local/bin/prometheux-mcp

​
3. Activate the Server

  1. Open Cursor Settings (Cmd+Shift+J on macOS, Ctrl+Shift+J on Windows/Linux)
  2. Click Tools & MCP in the sidebar
  3. Toggle the prometheux server on
  4. The server should show a green status indicator
New Chat RequiredMCP tools are loaded when a chat session starts. After enabling the server, open a new chat (Cmd+N) to use the Prometheux tools.

​
Alternative: Remote Server

You can also use the remote server, though the local server is more reliable with Cursor: 
{
  "mcpServers": {
    "prometheux": {
      "url": "https://api.prometheux.ai/px-remote-mcp-server"
    }
  }
}
This requires completing an OAuth flow in your browser. See the Remote MCP Server page for details.

​
Usage

Once connected, interact naturally with Cursor’s AI agent. It will automatically use the Prometheux MCP tools when relevant.
Example Conversations & Available ToolsSee the MCP overview page for example conversations and a complete list of available tools.

​
Troubleshooting

​
Server shows as “failed” in Tools & MCP

Solution:
  • Verify the path to prometheux-mcp is correct — run which prometheux-mcp in your terminal
  • Check that your credentials are valid
  • Toggle the server off and on again
  • Restart Cursor completely (Cmd+Q, then reopen)

​
Tools not appearing in chat

Solution:
  • MCP tools are loaded when a chat starts — open a new chat after enabling the server
  • Check that the server shows a green indicator in Settings → Tools & MCP
  • Be more explicit in your query: “Use the prometheux tools to list concepts in project X”

​
OAuth flow not working (remote server)

If using the remote server, the OAuth browser redirect may fail silently in some Cursor versions. Switch to the local server configuration instead (see Setup above). For general troubleshooting, see the Local MCP Server troubleshooting section.