MCP Installation

Installation

Quick Install (pip)
uvx (no install)
From Source
PyPI

Install directly from GitHub using pip:

pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git

Pin to a specific version:

pip install git+https://github.com/ZeroPathAI/zeropath-mcp-server.git@v0.1.0

Run without installing using uvx:

uvx --from git+https://github.com/ZeroPathAI/zeropath-mcp-server zeropath-mcp-server

Pin to main branch:

uvx --from "git+https://github.com/ZeroPathAI/zeropath-mcp-server@main" zeropath-mcp-server

Clone and install with uv:

git clone https://github.com/ZeroPathAI/zeropath-mcp-server.git
cd zeropath-mcp-server
uv sync

pip install zeropath-mcp-server

Python 3.12+ is required. Check your version with python3 --version.

Setup

Generate API Key

Create a user-scoped or admin API key from ZeroPath Settings. You need the Token ID and Token Secret.

Set Environment Variables

export ZEROPATH_TOKEN_ID=your_token_id
export ZEROPATH_TOKEN_SECRET=your_token_secret
export ZEROPATH_ORG_ID=your_org_id
export ZEROPATH_BASE_URL="https://zeropath.com"  # optional, defaults to https://zeropath.com

Set ZEROPATH_BASE_URL to target a different environment, e.g. https://your-instance.example.com

Configure Your MCP Client

Add the ZeroPath MCP server to your AI tool’s config file. See the client configuration section below.

Client Configuration

Claude Desktop / Cursor (uvx)
From Source

For Claude Desktop, edit your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

For Cursor, add to MCP settings (Settings → MCP).

{
  "mcpServers": {
    "zeropath": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ZeroPathAI/zeropath-mcp-server",
        "zeropath-mcp-server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

If you installed from source, point to the local project:

{
  "mcpServers": {
    "zeropath": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/zeropath-mcp-server",
        "python",
        "-m",
        "zeropath_mcp_server"
      ],
      "env": {
        "ZEROPATH_BASE_URL": "https://zeropath.com",
        "ZEROPATH_TOKEN_ID": "your_token_id",
        "ZEROPATH_TOKEN_SECRET": "your_token_secret",
        "ZEROPATH_ORG_ID": "your_org_id"
      }
    }
  }
}

Troubleshooting

'Unknown tool' error

The MCP server may not have started or failed to fetch the manifest. Check your terminal for startup errors. Ensure the server process is running and can reach https://zeropath.com/mcp-manifest.json.

Authentication failed

Verify ZEROPATH_TOKEN_ID and ZEROPATH_TOKEN_SECRET are correct and the API key is active. You can test by visiting ZeroPath Settings to confirm the key status.

Organization not found

Confirm ZEROPATH_ORG_ID matches an organization you have access to. You can find your org ID in ZeroPath Settings.

'organizationId is required' error

Pass organizationId explicitly in the tool input, or set ZEROPATH_ORG_ID in your environment. The server auto-injects the org ID when the environment variable is configured.

Schema validation failed

Check the error details — the server validates all inputs before calling ZeroPath’s API. Common causes: wrong field names (e.g., status instead of issueStatus), wrong types (e.g., string instead of number for severity).

General Tips

Restart your AI client after changing MCP configuration.
Ensure Python 3.12+ is in your PATH.
Use uvx for the simplest setup — no installation required.
Check the GitHub repo for updates and known issues.

Getting Started

Scanning

SCA

Platform

Developer Tools

Integrations

Authentication

Installation

Setup

Client Configuration

Troubleshooting

General Tips

​Installation

​Setup

​Client Configuration

​Troubleshooting

​General Tips

Installation

Setup

Client Configuration

Troubleshooting

General Tips