Skip to main content
Version: v0.16.4

IDE Plugins

The PEAC Plugin Pack provides skills and rules for AI-assisted development environments. It enables receipt verification, inspection, and issuance directly from your IDE through the MCP server.


Claude Code​

Add the PEAC skill to Claude Code for receipt operations during development.

Setup​

Add to your project's .mcp.json:

.mcp.json
{
"mcpServers": {
"peac": {
"command": "npx",
"args": ["@peac/mcp-server"],
"env": {
"PEAC_MCP_PRIVILEGED": "false"
}
}
}
}

Once configured, Claude Code can verify any PEAC receipt you paste into the conversation, inspect receipt claims, and decode raw JWS tokens.

Available operations​

  • Verify -- paste a receipt JWS and ask Claude to verify it
  • Inspect -- examine decoded header, payload, and signature metadata
  • Decode -- view raw base64url-decoded parts of a JWS

Cursor​

Add PEAC MCP tools to Cursor for receipt operations.

Setup​

Add to your project's .mcp.json (Cursor reads this automatically):

.mcp.json
{
"mcpServers": {
"peac": {
"command": "npx",
"args": ["@peac/mcp-server"],
"env": {
"PEAC_MCP_PRIVILEGED": "false"
}
}
}
}

Cursor will discover the MCP server and make PEAC tools available in the AI assistant.


Other MCP clients​

Any MCP client that supports stdio transport can use the PEAC MCP server:

  • Windsurf -- add to MCP server configuration
  • VS Code Copilot -- configure via MCP settings
  • Custom agents -- connect via stdio or Streamable HTTP

The MCP server exposes the same 5 tools regardless of client:

ToolDescriptionPrivileged
peac_verifyVerify a receipt against an issuer's JWKSNo
peac_inspectDecode and display receipt claimsNo
peac_decodeRaw base64url decode of JWS partsNo
peac_issueIssue a new signed receiptYes
peac_create_bundleCreate an evidence bundleYes

Security model​

The Plugin Pack follows a default-deny security model:

  • Pure tools only by default -- peac_verify, peac_inspect, and peac_decode require no secrets
  • Privileged tools require opt-in -- set PEAC_MCP_PRIVILEGED=true and provide signing keys to enable peac_issue and peac_create_bundle
  • No ambient key discovery -- keys must be explicitly configured via environment variables
  • No outbound network from tools -- SSRF prevention by design
  • Static policy -- policy loaded at startup, not fetched at runtime
warning

Only enable privileged tools (PEAC_MCP_PRIVILEGED=true) in trusted environments where you control the signing keys. In shared or CI environments, use pure tools only.


Plugin Pack distribution​

The Plugin Pack is distributed as part of the @peac/mcp-server package in surfaces/plugin-pack/. It contains:

  • Claude Code skill definition
  • Cursor rules file
  • MCP client configuration templates
  • Usage documentation

The Plugin Pack has zero runtime dependencies -- it configures the MCP server binary, which handles all protocol operations.


Next steps​