Perforce P4 MCP Server

{
  "mcpServers": {
    "perforce-p4-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "P4PASSWD",
        "-e",
        "P4DAM_API_KEY",
        "ghcr.io/perforce/p4mcp-server:2026.4.3078076"
      ],
      "env": {
        "P4PASSWD": "your-value",
        "P4DAM_API_KEY": "your-value"
      }
    }
  }
}

claude mcp add --env P4PASSWD=your-value --env P4DAM_API_KEY=your-value --transport stdio perforce-p4-mcp-server -- docker run -i --rm -e P4PASSWD -e P4DAM_API_KEY ghcr.io/perforce/p4mcp-server:2026.4.3078076

{
  "mcpServers": {
    "perforce-p4-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "P4PASSWD",
        "-e",
        "P4DAM_API_KEY",
        "ghcr.io/perforce/p4mcp-server:2026.4.3078076"
      ],
      "env": {
        "P4PASSWD": "your-value",
        "P4DAM_API_KEY": "your-value"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "p4passwd",
      "description": "P4PASSWD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "p4dam_api_key",
      "description": "P4DAM_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "perforce-p4-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "P4PASSWD",
        "-e",
        "P4DAM_API_KEY",
        "ghcr.io/perforce/p4mcp-server:2026.4.3078076"
      ],
      "env": {
        "P4PASSWD": "${input:p4passwd}",
        "P4DAM_API_KEY": "${input:p4dam_api_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• server_info

  Get P4 version, uptime, and configuration

• current_user

  Get current user information and permissions

• list

  List all workspaces (optionally filtered by user)

• type

  Check workspace type and configuration

• status

  Check workspace sync status

• content

  Get file content at a specific revision

• history

  Get file revision history and integration records

• info

  Get file basic details (type, size, permissions)

• metadata

  Get file metadata (attributes, filesize, etc.)

• diff

  Compare file versions (depot-to-depot or mixed)

• annotations

  Get file annotations with blame information

• search

  Search for files by name pattern (wildcard matching)

• grep

  Search for files by content pattern (text search)

• ranges

  Optional list of [start, end] line pairs, 1-based and inclusive (e.g. [[10, 20], [50, 60]]).

• files

  List files in a specific shelf

• list_jobs

  List jobs associated with a changelist

• get_job

  Get detailed job information and status

• dashboard

  Get current user's review dashboard (my reviews, needs attention)

• transitions

  Get available state transitions for a review

• files_readby

  Get files read status by users

• activity

  Get review activity history

• comments

  Get comments on a review

• review_id

  Review ID (required for get, transitions, files_readby, files, comments, activity)

• review_fields

  Comma-separated fields to return (e.g., "id,description,author,state")

• comments_fields

  Fields for comments (default: "id,body,user,time")

• up_voters

  List of up voters for transitions

• from_version

  , toversion - Version range for files action

• max_results

  Maximum results (default: 10)

• children

  Get child streams of a given stream

• parent

  Get the parent stream

• graph

  Get the full stream graph (parent + children)

• integration_status

  Get integration status between stream and parent (p4 istat)

• get_workspace

  Get a workspace spec bound to a stream

• list_workspaces

  List workspaces bound to a stream

• validate_file

  Validate file paths against a stream's view

• validate_submit

  Validate opened files for submit in a stream workspace

• check_resolve

  Check for pending stream spec conflicts

• interchanges

  List changelists awaiting integration between streams

• stream_name

  Stream depot path (required for get, children, parent, graph, check_resolve, interchanges)

• stream_path

  Path pattern(s) for list (e.g., ["//depot/..."])

Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system. It is built on FastMCP with direct P4 Python bindings to expose safe, structured read/write tools for changelists, files, shelves, workspaces, jobs, reviews, and server metadata. It also integrates with P4 DAM through its REST API to manage resources .

• mcp
• mcp-server
• p4
• perforce
• p4python
• p4-code-review
• p4-mcp
• p4-mcp-server