Guides

MCP / IDE

The PRs.md MCP server lets AI-powered editors (Cursor, Windsurf, Claude Desktop, and any other MCP-compatible client) trigger challenges and retrieve proof badges without leaving your IDE.

What is MCP?

The Model Context Protocolis an open standard that lets LLM-powered tools call external capabilities defined as “tools.” PRs.md exposes two:

• prs_start_challenge — create a quiz from a PR URL and return the questions
• prs_submit_answers — submit answers and get your score + proof URL back

Getting your MCP token

Go to Dashboard → MCP Server and generate a token. This token authenticates the MCP server with your PRs.md account. Keep it secret — it has the same permissions as your full session.

Cursor setup

Add the server to your Cursor MCP config. Open ~/.cursor/mcp.json(create it if it doesn't exist) and add:

{
  "mcpServers": {
    "prs-md": {
      "command": "npx",
      "args": ["-y", "prs-md-mcp"],
      "env": {
        "PRS_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Cursor. You should see prs-md appear in the MCP tools panel.

Windsurf setup

Open Settings → MCP Servers and click Add server. Use the same npx -y prs-md-mcp command with the PRS_TOKEN environment variable set. Windsurf will prompt you for the env value in a secure field.

Claude Desktop setup

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS (or the equivalent on Windows) and add the server under mcpServers:

{
  "mcpServers": {
    "prs-md": {
      "command": "npx",
      "args": ["-y", "prs-md-mcp"],
      "env": {
        "PRS_TOKEN": "your-token-here"
      }
    }
  }
}

Using the tools

Once configured, you can ask the AI in your editor to run a challenge. For example:

BYOK vs token mode

The MCP server supports two authentication modes, selectable in the Dashboard → MCP Server setup screen:

• Token mode — uses the API key saved to your PRs.md account. Simplest setup.
• BYOK mode— you pass an API key directly in the MCP config. Useful if you don't want to save keys to the server.

Troubleshooting

Server not appearing in the tools list

Make sure npx can reach the internet and is on your PATH. Run npx -y prs-md-mcp --version in a terminal to confirm the package resolves correctly.

Authentication errors

Regenerate your MCP token from the dashboard and update the PRS_TOKEN value in your config. Tokens do not expire but can be revoked from the dashboard.