perforce avatar

Perforce P4 MCP Server

perforce/p4mcp-server

Connects Claude directly to Perforce version control through Python bindings and FastMCP. You get read/write tools for changelists, shelves, workspaces, jobs, and P4's code review system, including voting, commenting, and participant management. Runs in read-only mode by default with ownership checks and interactive confirmations for destructive operations like obliterate. Configure which tool categories to expose (files, streams, server metadata) based on your workflow. Ships as pre-built binaries for offline environments or runs via uvx without installation. Useful when you're managing code reviews, tracking shelved changes, or automating workspace operations without leaving your AI conversation.

tools
18
transport
STDIO
env vars
5
last updated
Nov 2, 2026

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

query_serverGet server information and current user details

Get server information and current user details

No parameter schema in public metadata yet.

query_workspacesWorkspace information and management

Workspace information and management

No parameter schema in public metadata yet.

query_changelistsAccess changelist information and history

Access changelist information and history

No parameter schema in public metadata yet.

query_filesFile operations and information

File operations and information

No parameter schema in public metadata yet.

query_shelvesShelved changelist operations and inspection

Shelved changelist operations and inspection

No parameter schema in public metadata yet.

query_jobsJob tracking and defect management

Job tracking and defect management

No parameter schema in public metadata yet.

query_reviewsReview discovery, details, and activity

Review discovery, details, and activity

No parameter schema in public metadata yet.

query_streamsStream hierarchy, integration status, and workspace validation

Stream hierarchy, integration status, and workspace validation

No parameter schema in public metadata yet.

query_p4dam_assetsSearch P4 DAM assets by keyword or filters

Search P4 DAM assets by keyword or filters

No parameter schema in public metadata yet.

query_p4dam_assetFetch full metadata for a single P4 DAM asset

Fetch full metadata for a single P4 DAM asset

No parameter schema in public metadata yet.

query_p4dam_projectsList P4 DAM projects

List P4 DAM projects

No parameter schema in public metadata yet.

query_p4dam_repositoriesList repositories in a P4 DAM project

List repositories in a P4 DAM project

No parameter schema in public metadata yet.

query_p4dam_helix_classic_branchesList Helix Classic branches in a repository

List Helix Classic branches in a repository

No parameter schema in public metadata yet.

fetch_p4dam_mediaFetch and render a P4 DAM media URL as an image

Fetch and render a P4 DAM media URL as an image

No parameter schema in public metadata yet.

query_p4dam_file_reviewsList file (asset) reviews for a project

List file (asset) reviews for a project

No parameter schema in public metadata yet.

query_p4dam_file_reviewFetch a single file review by UUID

Fetch a single file review by UUID

No parameter schema in public metadata yet.

query_p4dam_workflowsList P4 DAM workflows

List P4 DAM workflows

No parameter schema in public metadata yet.

query_p4dam_workflowFetch a single workflow by short name or UUID

Fetch a single workflow by short name or UUID

No parameter schema in public metadata yet.

Sponsors

Configuration

P4PORT

Perforce server address (e.g. ssl:perforce.example.com:1666)

P4USER

Perforce username

P4CLIENT

Perforce workspace/client name

P4PASSWD

Perforce password or ticket

P4DAM_API_KEY

P4 DAM API key (account_key). When unset, P4 DAM tools are not registered.

Readme

Perforce P4 MCP Server


Support

GitHub release

Perforce P4 MCP Server

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.


View the full README on GitHub

Details

Repository
github.com/perforce/p4mcp-server
Package
ghcr.io/perforce/p4mcp-server:2026.4.3126709
Transport
STDIO
Registry
MCP registry, active

More from perforce