Cursor

Cursor supports MCP servers via a JSON config file. You can register Perfai globally (available in every workspace) or per-project (checked into your repo).

The package binary is perfai-mcp-server. Always launch it with npx --yes --package=@perfai/mcp@latest perfai-mcp-server — npx @perfai/mcp alone fails with “could not determine executable to run.”

Authentication uses your Perfai username and password via the PERFAI_USERNAME / PERFAI_PASSWORD environment variables. Because these sit in plaintext in the config, prefer global config and don’t commit credentials to a shared repo.

Global installation

macOS / Linux
Windows

File: ~/.cursor/mcp.json

{
  "mcpServers": {
    "perfai-mcp": {
      "command": "npx",
      "args": ["--yes", "--package=@perfai/mcp@latest", "perfai-mcp-server"],
      "env": {
        "PERFAI_USERNAME": "you@example.com",
        "PERFAI_PASSWORD": "your-password"
      }
    }
  }
}

Create the file if it doesn’t exist:

mkdir -p ~/.cursor
touch ~/.cursor/mcp.json

File: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "perfai-mcp": {
      "command": "npx",
      "args": ["--yes", "--package=@perfai/mcp@latest", "perfai-mcp-server"],
      "env": {
        "PERFAI_USERNAME": "you@example.com",
        "PERFAI_PASSWORD": "your-password"
      }
    }
  }
}

Create the file if it doesn’t exist (run in PowerShell):

New-Item -Path "$env:USERPROFILE\.cursor\mcp.json" -Force

Project-scoped installation

Add the config to .cursor/mcp.json at the root of your project. This makes the server available only when that project is open.

{
  "mcpServers": {
    "perfai-mcp": {
      "command": "npx",
      "args": ["--yes", "--package=@perfai/mcp@latest", "perfai-mcp-server"],
      "env": {
        "PERFAI_USERNAME": "you@example.com",
        "PERFAI_PASSWORD": "your-password"
      }
    }
  }
}

Do not commit .cursor/mcp.json if it contains your PERFAI_PASSWORD. Add it to .gitignore, or keep credentials in your global ~/.cursor/mcp.json instead.

Enable the server in Cursor

After saving the config file:

Open Cursor Settings → MCP (or search “MCP” in the command palette).
Confirm perfai-mcp appears in the server list with a green status indicator.
If it shows as disconnected, click Restart next to the server entry.

The prompts below run inside Cursor’s Agent chat, not your terminal. The only terminal/file steps are creating the config file.

In Cursor’s Agent mode, type:

Login to Perfai

The server reads PERFAI_USERNAME / PERFAI_PASSWORD from the config, signs you in, and saves the session locally. Confirm with:

What's my Perfai auth status?

Select an organization and app

List my Perfai organizations

Select organization 1

List my Perfai apps

Select the app called "payment-api"

List issues

Findings are grouped into security, design, and quality categories.

Summarize all issues for the selected app

Show critical and high security issues

Show all design issues

Show quality issues

Generate fixes

By ID (sequence number, issue ID, or description):

Generate a fix for security issue 14

By category:

Generate fixes for all design issues

For all / by severity — ask Cursor to iterate:

List all critical security issues, then generate a fix for each one

Getting Started

Core Concepts

Hybrid Deployment

Changelog

Global installation

Project-scoped installation

Enable the server in Cursor

Select an organization and app

List issues

Generate fixes

​Global installation

​Project-scoped installation

​Enable the server in Cursor

​Login

​Select an organization and app

​List issues

​Generate fixes

Global installation

Project-scoped installation

Enable the server in Cursor

Login

Select an organization and app

List issues

Generate fixes