P4mcp Server MCP Server

by perforce• 123•• Scanned•Claim this listing•Request removal
Coding Agentsmcpmcp serverp4p4 code reviewp4 mcp

[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 Code · Terminal
claude mcp add p4mcp-server -- uvx p4mcp-server --readonly --allow-usage
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "p4mcp-server": {
      "command": "uvx",
      "args": [
        "p4mcp-server",
        "--readonly",
        "--allow-usage"
      ]
    }
  }
}
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "p4mcp-server": {
      "command": "uvx",
      "args": [
        "p4mcp-server",
        "--readonly",
        "--allow-usage"
      ]
    }
  }
}
VS Code · Terminal
code --add-mcp '{"name":"p4mcp-server","command":"uvx","args":["p4mcp-server","--readonly","--allow-usage"]}'

What P4mcp Server can touch

  • Run shell commandsNot seen in this scan
  • Run dynamic codeNot seen in this scan
  • Read or write filesNot seen in this scan
  • Read environment and secretsFound in the code by our scan
  • Control a web browserNot seen in this scan
  • Connect to databasesListed as a tool: query_server
  • Read or send messagesNot seen in this scan
  • Touch money or tradingNot seen in this scan
  • 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

  1. Pin the version you reviewed instead of always installing the latest release.
  2. 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_server

    Get server info and current user information (READ permission)

  • query_workspaces

    Get workspace details, list workspaces, check type and status (READ permission)

  • modify_workspaces

    Create/delete workspace, Update workspace specs, and switch active workspace (WRITE permission)

  • query_files

    Get file content, history, info, diff, annotations, search by name, grep by content (READ permission)

  • modify_files

    Add, edit, move, delete, revert, reconcile, resolve, and sync files (WRITE permission)

  • query_changelists

    Get changelist details and list changelists (READ permission)

  • modify_changelists

    Create/delete changelists, update changelists and organize files/jobs (WRITE permission)

  • query_shelves

    List shelves, get shelve diff and files (READ permission)

  • modify_shelves

    Create/delete, update shelves and unshelve files (WRITE permission)

  • query_jobs

    Get jobs from changelist and get job details (READ permission)

  • modify_jobs

    Link or unlink jobs (WRITE permission)

  • query_reviews

    Get 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_reviews

    Create/update/delete reviews (WRITE permission)

  • query_streams

    Query streams: list, get spec, children/parent/graph, integration status, workspaces, validate files, check resolve, interchanges (READ permission)

  • modify_streams

    Create/update/delete streams, edit/resolve/revert/shelve stream specs, copy/merge/integrate/populate between streams, switch workspace, create stream workspace (WRITE permission)

  • query_p4dam_assets

    Search 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_asset

    Fetch 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_projects

    List P4 DAM projects.

  • query_p4dam_repositories

    List repositories (collections) in a P4 DAM project. The response includes repository type (helix_stream or helix_classic) and linked_streams.

  • query_p4dam_helix_classic_branches

    List Helix Classic branches in a repository. Only applies to helix_classic repositories.

  • fetch_p4dam_media

    Fetch 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_reviews

    List 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_review

    Fetch 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_workflows

    List 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_workflow

    Fetch 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_states

    List 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_templates

    List 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_comment

    Add 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_preview

    Trigger 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_bundle

    Create 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_bundle

    Update 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_bundle

    Delete a P4 DAM asset bundle. Prompts for confirmation before deleting.

  • sync_p4dam_asset_bundle

    Sync 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_review

    Create 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_review

    Update 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_review

    Delete a P4 DAM file review. Prompts for confirmation before deleting.

  • update_p4dam_asset_tags

    Add 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_attributes

    Set 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

pypi.org

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

mcpmcp-serverp4p4-code-reviewp4-mcpp4-mcp-serverp4pythonperforce

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.

NameStarsLicenceLast updatedScan
P4mcp Server (this page)
perforce
123MITSep 25, 2026Scanned, no flagged issues
Context Mode
mksglu
33kNone foundNov 1, 2026Not scanned yet
Serena
oraios
31kNone foundOct 28, 2026Not scanned yet
Fastmcp
PrefectHQ
28kApache-2.0Nov 1, 2026Scanned, no flagged issues
Nuclear
nukeop
19kAGPL-3.0Nov 1, 2026Scanned, no flagged issues
MCP For Beginners
microsoft
18kMITOct 30, 2026Scanned, no flagged issues