Developer Tools·Beginner

MCP Server

Set up the FinishKit MCP server to scan repos and analyze code directly from your editor.

The FinishKit MCP server gives your AI editor direct access to production readiness scanning, Intelligence Packs, and findings.

Setup

The quickest way to get started:

npx @finishkit/mcp login

This opens your browser, signs you in with GitHub or Google, and stores your API key locally. Your editor picks up the key automatically.

To configure a specific editor:

npx @finishkit/mcp setup --claude-code
npx @finishkit/mcp setup --cursor
npx @finishkit/mcp setup --windsurf
npx @finishkit/mcp setup --vscode

Step 2: Verify the connection

Ask your AI assistant:

"Check my FinishKit connection status."

The assistant will call finishkit_setup and confirm your account is connected.

Step 3: Start scanning

Ask your AI to scan your project:

"Scan this repo with FinishKit."

Manual configuration

If you prefer to configure manually, add this to your editor's MCP config:

Claude Code:

claude mcp add finishkit -- npx -y @finishkit/mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), VS Code (.vscode/mcp.json):

{
  "mcpServers": {
    "finishkit": {
      "command": "npx",
      "args": ["-y", "@finishkit/mcp"],
      "env": {
        "FINISHKIT_API_KEY": "fk_live_your_key_here"
      }
    }
  }
}

Available tools

Tool	Description
`finishkit_setup`	Authenticate and check connection status
`scan_repo`	Trigger a cloud scan on a connected project
`get_scan_status`	Check scan progress and current phase
`get_findings`	Retrieve findings filtered by category or severity
`get_patches`	Get auto-generated code patches
`list_projects`	List your connected projects
`create_project`	Get instructions to connect a new repo
`request_intelligence_pack`	Request stack-specific analysis context for local scanning
`sync_findings`	Upload locally-generated findings to your dashboard

Available resources

URI	Description
`finishkit://projects`	All your projects as JSON
`finishkit://projects/{id}`	Single project details
`finishkit://runs/{run_id}/findings`	Findings for a completed scan
`finishkit://runs/{run_id}/events`	Event log for a scan run

The MCP server works without an API key. Without a key, tools return setup guidance and finishkit_setup provides a browser activation link. After authenticating, all tools work on the next call with no restart required.

Next step

SDK & API Keys →