# Perforce P4 MCP server

> Lets an AI client read and manage Perforce P4 changelists, files, shelves, workspaces, jobs, reviews, and DAM assets.

- Repository: https://github.com/perforce/p4mcp-server
- Page: https://hostedmcp.org/servers/perforce/p4mcp-server
- Official: yes
- Transport: —
- Stars: 127
- License: MIT
- Latest version: 2025.1.2830393

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `P4DAM_API_KEY` | no | no |  |

## Tools (106)

- `server_info`
- `current_user`
- `list`
- `get`
- `type`
- `status`
- `content`
- `history`
- `info`
- `metadata`
- `diff`
- `annotations`
- `search`
- `grep`
- `ranges`
- `files`
- `list_jobs`
- `get_job`
- `dashboard`
- `transitions`
- `files_readby`
- `activity`
- `comments`
- `review_id`
- `review_fields`
- `comments_fields`
- `up_voters`
- `max_results`
- `children`
- `parent`
- `graph`
- `integration_status`
- `get_workspace`
- `list_workspaces`
- `validate_file`
- `validate_submit`
- `check_resolve`
- `interchanges`
- `stream_name`
- `stream_path`
- `filter`
- `fields`
- `workspace`
- `file_paths`
- `view_without_edit`
- `at_change`
- `both_directions`
- `force_refresh`
- `create`
- `refresh_projects`
- `vote`
- `transition`
- `append_participants`
- `replace_participants`
- `delete_participants`
- `add_comment`
- `reply_comment`
- `edit_comment`
- `append_change`
- `replace_with_change`
- `join`
- `leave`
- `archive_inactive`
- `update_author`
- `update_description`
- `obliterate`
- `change_id`
- `description`
- `reviewer_groups`
- `vote_value`
- `version`
- `body`
- `task_state`
- `notify`
- `comment_id`
- `context`
- `update`
- `delete`
- `edit_spec`
- `resolve_spec`
- `revert_spec`
- `shelve_spec`
- `unshelve_spec`
- `copy`
- `merge`
- `integrate`
- `populate`
- `switch`
- `create_workspace`
- `stream_type`
- `options`
- `parent_view`
- `changelist`
- `resolve_mode`
- `parent_stream`
- `branch`
- `preview`
- `force`
- `reverse`
- `max_files`
- `quiet`
- `output_base`
- `virtual`
- `schedule_branch_resolve`
- `integrate_around_deleted`
- `skip_cherry_picked`

## FAQ

### Does the Perforce P4 MCP server support read-only mode?

Yes. The server runs in read-only mode by default, and destructive operations require confirmation.

### How does the P4 MCP server authenticate to Perforce?

It uses a valid P4 login via ticket-based authentication or a password.

### Which transports does the Perforce P4 MCP server support?

It supports STDIO transport locally or in Docker, and HTTP transport for VM deployments.

### Can I choose which tool categories the P4 MCP server exposes?

Yes. You can configure which tool categories such as server, files, changelists, shelves, workspaces, jobs, reviews, streams, and p4dam are enabled.

### Does the P4 MCP server collect usage data?

It has optional telemetry that is consent-gated and disabled by default.
