Private Agent Commerce Protocol MCP Server

@p-acp/mcp-server brings P-ACP workflows to MCP-compatible agent applications through a local stdio server.

It exposes guarded tools for session creation, commitment-based negotiation, unsigned Solana settlement planning, externally observed settlement references, sealed-delivery commitments, evaluation, verifiable receipts, and selective disclosure.

Run locally

npx -y @p-acp/mcp-server

Example client configuration:

{
  "mcpServers": {
    "p-acp": {
      "command": "npx",
      "args": ["-y", "@p-acp/mcp-server"]
    }
  }
}

Set PACP_STATE_DIR to choose where local session commitments and proof material are stored. Otherwise, the server uses the operating system's user data directory. Session filenames are derived from hashed identifiers, writes are atomic, and concurrent revisions use a lock plus compare-and-swap check.

Tool surface

• p_acp_get_capabilities
• p_acp_create_session
• p_acp_get_session
• p_acp_record_negotiation
• p_acp_prepare_settlement
• p_acp_record_settlement_observation
• p_acp_record_delivery
• p_acp_record_evaluation
• p_acp_create_receipt
• p_acp_verify_receipt
• p_acp_create_disclosure
• p_acp_verify_disclosure

All write tools apply P-ACP role, state, revision, expiry, and replay guards. Negotiation and delivery tools accept commitments, not private task text or deliverable plaintext.

Settlement boundary

The local server creates a Solana intent and instruction plan for external wallet review. It does not request private keys, sign transactions, broadcast transactions, contact an RPC endpoint, or move funds. A settlement observation is explicitly labelled caller-supplied rather than RPC-verified.

Development

From the repository root:

npm run build --workspace @p-acp/mcp-server
npm test -- tests/mcp
npm run packcheck --workspace @p-acp/mcp-server

The package requires Node.js 20 or newer and is licensed under Apache-2.0.