Docs · AI agent signing
Plugin vs skill vs MCP connector
MCP connector (remote account link)
The connector is your live link to Liminal Keys. Production URL:
https://mcp.liminalkeys.com/mcp
In Claude, you add that URL and choose Connect. Sign-in uses URL-only OAuth with automatic client registration — you do not paste a client ID or client secret. You sign in with your Liminal Keys account (the same options as Console).
The connector exposes four remote tools: list_certificates,
get_certificate_chain, sign_hash (with optional human approval), and optional
timestamp. Response envelopes are cryptographically signed; the skill verifies them.
The private key never leaves Liminal Keys.
Skill — liminalkeys-sign 0.1.10 (local instructions + program)
A skill is agent instructions plus a small local program. The
liminalkeys-sign skill tells the agent the exact steps and ships offline Python wheels and
the liminal-sign helper.
- Hash locally — for PDFs,
liminal-sign preparedigests the file in the sandbox; only the 32-byte digest goes to MCP. - Call
sign_hashon the connector (one approval on your phone or in LK Approvals when policy requires it). - Finish locally —
liminal-sign finishembeds the signature, runs mandatory validation, and by default draws the branded visible stamp on the PDF.
Standalone zip (same bits as the plugin bundle): liminalkeys-sign-skill-0.1.10.zip (SHA-256).
Claude plugin — LiminalKeys/claude-plugin (install package)
The plugin is the installable package that wires everything up for Claude Code and claude.ai:
it registers the liminalkeys-sign skill and the MCP connector settings for
https://mcp.liminalkeys.com/mcp. Install or refresh from the public
LiminalKeys/claude-plugin marketplace — see
Claude setup on the main AI agents guide.
How they fit together
┌──────────────────────────── Claude (plugin installed) ────────────────────────────┐
│ │
│ SKILL (liminalkeys-sign) MCP CONNECTOR YOUR LK ACCOUNT │
│ ───────────────────── ─────────────── ───────────────── │
│ liminal-sign prepare ──hash──► sign_hash ────────────► Key Vault sign │
│ │ ▲ (private key │
│ │ previews │ never exported) │
│ ▼ │ approval (optional) │
│ liminal-sign finish ◄──signature────┘ │
│ embed + validate + stamp │
└───────────────────────────────────────────────────────────────────────────────────┘
What to configure where
| Piece | You configure | Runs where |
|---|---|---|
| MCP connector | MCP URL + Connect (OAuth) or optional lkag_… API key header | Claude → Liminal Keys cloud |
| Skill | Installed via plugin or skill zip upload | Agent sandbox (local CLI) |
| Plugin | Marketplace add + install / refresh on claude.ai | Claude product |
| Policy & approvals | Console → AI agents, policy rules, LK Approvals | Console + PWA |