P4mcp Server MCP Server
[Community Supported] Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system.
P4mcp Server is an open-source mcp server by perforce, written mainly in Python, with 123 GitHub stars and the MIT license. Its code was last updated Sep 25, 2026. The latest PyPI release is p4mcp-server 2026.4.3126709, published Nov 2, 2026, with 431 downloads last week.
Scan summary: scanned Nov 5, 2026 at commit 808b328. Seen able to read environment and secrets, connect to databases, connect to the internet. Scan policy
How to install P4mcp Server
Built from the start command in the project's README: uvx p4mcp-server --readonly --allow-usage. Check the README for required keys or settings.
claude mcp add p4mcp-server -- uvx p4mcp-server --readonly --allow-usage{
"mcpServers": {
"p4mcp-server": {
"command": "uvx",
"args": [
"p4mcp-server",
"--readonly",
"--allow-usage"
]
}
}
}{
"mcpServers": {
"p4mcp-server": {
"command": "uvx",
"args": [
"p4mcp-server",
"--readonly",
"--allow-usage"
]
}
}
}code --add-mcp '{"name":"p4mcp-server","command":"uvx","args":["p4mcp-server","--readonly","--allow-usage"]}'What P4mcp Server can touch
- Our checks did not find this. The tool may still do it.Run shell commandsNot seen in this scan
- Our checks did not find this. The tool may still do it.Run dynamic codeNot seen in this scan
- Our checks did not find this. The tool may still do it.Read or write filesNot seen in this scan
- Seen in this scan, either in the code or while it ran.Read environment and secretsFound in the code by our scan
- Our checks did not find this. The tool may still do it.Control a web browserNot seen in this scan
- The server lists a tool that does this.Connect to databasesListed as a tool: query_server
- Our checks did not find this. The tool may still do it.Read or send messagesNot seen in this scan
- Our checks did not find this. The tool may still do it.Touch money or tradingNot seen in this scan
- Seen in this scan, either in the code or while it ran.Connect to the internetContacted pypi.org
"Not seen" means our checks did not find it, and the tool may still do it. Covers commit 808b328, Nov 5, 2026. See the scan policy.
Before you install P4mcp Server
AgenticMart scanned P4mcp Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What it can access
- An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.
Before you install
- Pin the version you reviewed instead of always installing the latest release.
- Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
- Maintained by perforce on GitHub, 123 stars and 28 forks. Popularity is not proof of safety.
- Last code change: Sep 25, 2026.
- Open-source license: MIT.
Tools P4mcp Server exposes (38)
Listed by the server itself during our scan of commit 808b328.
query_serverGet server info and current user information (READ permission)
query_workspacesGet workspace details, list workspaces, check type and status (READ permission)
modify_workspacesCreate/delete workspace, Update workspace specs, and switch active workspace (WRITE permission)
query_filesGet file content, history, info, diff, annotations, search by name, grep by content (READ permission)
modify_filesAdd, edit, move, delete, revert, reconcile, resolve, and sync files (WRITE permission)
query_changelistsGet changelist details and list changelists (READ permission)
modify_changelistsCreate/delete changelists, update changelists and organize files/jobs (WRITE permission)
query_shelvesList shelves, get shelve diff and files (READ permission)
modify_shelvesCreate/delete, update shelves and unshelve files (WRITE permission)
query_jobsGet jobs from changelist and get job details (READ permission)
modify_jobsLink or unlink jobs (WRITE permission)
query_reviewsGet review details and list reviews (READ permission). Open review - state is 'approved but pending=true' or 'needsReview' or 'needsRevision'. Closed review - state is 'approved but pending=false' or 'rejected' or 'archived'.
modify_reviewsCreate/update/delete reviews (WRITE permission)
query_streamsQuery streams: list, get spec, children/parent/graph, integration status, workspaces, validate files, check resolve, interchanges (READ permission)
modify_streamsCreate/update/delete streams, edit/resolve/revert/shelve stream specs, copy/merge/integrate/populate between streams, switch workspace, create stream workspace (WRITE permission)
query_p4dam_assetsSearch P4 DAM assets. Supports filtering by keyword, filename, tag, file type, depot path, project, repository, uploader, file size, and date range. Returns a list of matching assets with metadata and URLs. Use when you don't have a specific depot path yet. For full metadata on a known asset, use qu
query_p4dam_assetFetch full metadata for a single P4 DAM asset. Pass depot_path when project/repository scope is unknown; pass path + project_id + repository_id when scope is known (more efficient). For discovery without a known path, use query_p4dam_assets instead.
query_p4dam_projectsList P4 DAM projects.
query_p4dam_repositoriesList repositories (collections) in a P4 DAM project. The response includes repository type (helix_stream or helix_classic) and linked_streams.
query_p4dam_helix_classic_branchesList Helix Classic branches in a repository. Only applies to helix_classic repositories.
fetch_p4dam_mediaFetch P4 DAM media and return it as a viewable image. Use thumbnail_url, preview_url, or sprite_url from query_p4dam_assets / query_p4dam_asset results — these are only present for image files. For file_url of non-image assets, returns the MIME type and size instead of image content.
query_p4dam_file_reviewsList P4 DAM file (asset) reviews for a project. Returns paginated results with metadata (total_count, more_results). For full detail on a single review including download_url, use query_p4dam_file_review instead.
query_p4dam_file_reviewFetch a single P4 DAM file review by UUID. Returns full detail including state, view_paths, asset_bundle, creator, and download_url (for bundle reviews). Use query_p4dam_file_reviews to discover review UUIDs.
query_p4dam_workflowsList P4 DAM workflows. Each workflow defines the set of states an asset review can be in (open, review, done kinds). Pass include=['states'] to get all states in one call. Use query_p4dam_workflow_states for the states of a specific workflow.
query_p4dam_workflowFetch a single P4 DAM workflow by short name or UUID. Pass include=['states'] to see all available review states with their kind (open/review/done), color, and position. Pass include=['transition_rules'] to see which state transitions are allowed and for which users.
query_p4dam_workflow_statesList states for a P4 DAM workflow. Each state has: name, short_name, kind (open/review/done), color, and position. The short_name is the value to pass as state when creating or updating a file review. State kinds: 'open' — initial state; 'review' — under review; 'done' — terminal. Preconfigured sta
query_p4dam_custom_attribute_templatesList custom file attribute templates available in a P4 DAM project. Each template defines an attribute name, type (text, single-select, multi-select, checkbox), and for select types the list of allowed values. Use the returned UUID when setting attribute values with update_p4dam_asset_custom_attribu
create_p4dam_commentAdd a comment to a file review (asset bundles only), a file within a file review, a committed file or asset bundle without a review, or reply to an existing comment.
regenerate_p4dam_previewTrigger P4Search to regenerate the thumbnail and preview image for a specific asset revision. Deletes the existing preview attributes and asks P4Search to re-index the file. Returns 'accepted' immediately — the actual regeneration happens asynchronously. Requires P4.P4Search.URL and P4.P4Search.AUTH
create_p4dam_asset_bundleCreate a P4 DAM asset bundle — a named collection of depot files scoped for review. Requires a project, repository, depot_path (must end .p4bundle), and view_paths. Supply stream_path for helix_stream repos, or helix_classic_branch for helix_classic repos.
update_p4dam_asset_bundleUpdate a P4 DAM asset bundle. Only description, view_paths, and hero_file_path can be changed after creation. depot_path is immutable. Provide only the fields you want to change.
delete_p4dam_asset_bundleDelete a P4 DAM asset bundle. Prompts for confirmation before deleting.
sync_p4dam_asset_bundleSync an asset bundle's depot files to the local P4CLIENT workspace via p4 sync. Requires P4CLIENT to be set — returns an error if it is not. Sync is scoped to view_paths only; files outside those paths are not touched even if the client's View is broader.
create_p4dam_file_reviewCreate a P4 DAM file (asset) review. Supports both single-file reviews and asset bundle reviews (.p4bundle). For bundle reviews supply asset_bundle UUID (auto-detected from depot_path when omitted). For helix_classic repos supply helix_classic_branch. Always set base_commit_id to the changelist the
update_p4dam_file_reviewUpdate a P4 DAM file review. Provide only the fields you want to change. State transitions must be permitted by the project's workflow for the current user.
delete_p4dam_file_reviewDelete a P4 DAM file review. Prompts for confirmation before deleting.
update_p4dam_asset_tagsAdd or remove user tags and auto-tags on one or more P4 DAM assets in a single call. Supports individual files, specific revisions, and recursive folder paths (//depot/folder/...). All three operations (create, delete, delete_auto) can be combined in one request. Returns an array with the updated t
update_p4dam_asset_custom_attributesSet or remove custom attribute values on one or more P4 DAM assets. Use query_p4dam_custom_attribute_templates first to discover available templates and their UUIDs. Supports individual files, specific revisions (identifier in path), and recursive folders (//depot/folder/...).
Hosts it contacted while running
P4mcp Server is an open-source mcp server by perforce, written mainly in Python. [Community Supported] Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system.
At a glance
- Stars
- 123
- Forks
- 28
- Language
- Python
- License
- MIT
- Created
- Sep 2025
- Last update
- Sep 25, 2026
- Type
- MCP Server
- Price
- Free
Topics
Questions about P4mcp Server
What is P4mcp Server?
[Community Supported] Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system.
Who maintains P4mcp Server?
P4mcp Server is maintained by perforce on GitHub (perforce/p4mcp-server). AgenticMart lists it from public repository data.
Is P4mcp Server safe to use?
AgenticMart scanned P4mcp Server on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.
What license does P4mcp Server use?
It is published under the MIT license.
P4mcp Server alternatives
View more →Similar mcp servers in Coding Agents, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.
| Name | Stars | Licence | Last updated | Scan |
|---|---|---|---|---|
| P4mcp Server (this page) perforce | 123 | MIT | Sep 25, 2026 | Scanned, no flagged issues |
| Context Mode mksglu | 33k | None found | Nov 1, 2026 | Not scanned yet |
| Serena oraios | 31k | None found | Oct 28, 2026 | Not scanned yet |
| Fastmcp PrefectHQ | 28k | Apache-2.0 | Nov 1, 2026 | Scanned, no flagged issues |
| Nuclear nukeop | 19k | AGPL-3.0 | Nov 1, 2026 | Scanned, no flagged issues |
| MCP For Beginners microsoft | 18k | MIT | Oct 30, 2026 | Scanned, no flagged issues |