Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polarity.cc/llms.txt

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

Add Paragon as an MCP server in Claude Code to get code review, testing, and analysis tools directly in your terminal.

​
Prerequisites

​
Get your API key

  1. Go to app.paragon.run
  2. Sign in or create an account
  3. Navigate to Settings → API Keys
  4. Copy your API key
Some tools like generate_tests, run_paragon, list_test_suites, and save_to_suite require an API key. Other tools work without one.

​
Setup

1

Install Claude Code

npm install -g @anthropic-ai/claude-code
2

Add Paragon as an MCP server

Run the following command to register Paragon with Claude Code:
claude mcp add-json paragon '{"command":"paragon","args":["mcp-server"],"env":{"POLARITY_API_KEY":"your-api-key-here"}}'
Replace your-api-key-here with your API key from app.paragon.run.
3

Verify the server is connected

claude mcp list
You should see paragon listed as a configured MCP server.

​
Available tools

Once connected, Paragon exposes 12 tools to Claude Code:

​
Code review

ToolDescription
run_paragonRun a Paragon AI prompt — reads/writes files, runs shell commands, and performs complex coding tasks. Requires API key.
list_reviewed_prsList pull requests with Paragon review comments in the current repository. Supports filtering by state (open, closed, all).
get_review_commentsGet parsed review findings from a PR, including severity, descriptions, file locations, and suggested fixes. Auto-detects PR from current branch if omitted.
resolve_review_commentReply to a review comment and optionally resolve the thread.

​
Testing

ToolDescription
detect_test_frameworkScan the repository and detect test frameworks in use. Returns framework details, run commands, file patterns, and confidence level.
find_testsDiscover existing test files using framework-aware file patterns. Returns file paths and count.
run_testsExecute unit/integration tests using the detected or specified framework. Returns pass/fail status and full output.
run_e2e_testsRun Playwright E2E tests locally. Installs browsers if needed, optionally starts a dev server, and captures results.
generate_testsGenerate unit, integration, or E2E tests using Paragon AI. Detects patterns, writes tests, verifies compilation, runs them, and fixes failures. Requires API key.

​
Test suite management

ToolDescription
list_test_suitesList your test repositories and suites from the Paragon cloud dashboard. Requires API key.
save_to_suiteSave locally generated test files to a Paragon cloud test suite. Requires API key.

​
Utility

ToolDescription
check_setupCheck if the MCP server is properly configured. Reports the status of the API key, Paragon binary, and GitHub CLI.

​
Usage

After setup, Claude Code can automatically use Paragon tools when relevant. You can also request them directly: 
> Review the comments on my current PR and fix the issues

> Generate unit tests for src/auth.ts

> Run the test suite and show me what's failing

> Find all Playwright tests and run them in headed mode

​
Configuration

To update your API key or other environment variables, remove and re-add the server: 
claude mcp remove paragon
claude mcp add-json paragon '{"command":"paragon","args":["mcp-server"],"env":{"POLARITY_API_KEY":"your-new-api-key"}}'