mnemopay-paperclip-plugin
v0.4.0
Published
Paperclip adapter that injects MnemoPay Agent Credit Score (300-850, FICO-style behavioral scoring; not affiliated with Fair Isaac Corporation) and persistent behavioral memory into any Paperclip-managed agent
Maintainers
Readme
mnemopay-paperclip-plugin
Paperclip adapter that injects Agent Credit Score behavioral scoring (300-850, FICO-style; not affiliated with Fair Isaac Corporation) and persistent memory into any Paperclip-managed agent.
Built on @mnemopay/sdk · Apache 2.0 · by Jerry Omiagbo
What it does
Every Paperclip agent running this adapter gets:
- Agent Credit Score (300–850) — behavioral credit-score-style metric derived from execution history. Scores improve with successful runs, degrade on anomalies.
- Persistent memory — execution context, task keys, and memory references survive across Paperclip heartbeats via the session codec.
- Score gating — optionally block execution if an agent's score drops below a threshold (e.g., after detected manipulation or repeated failures).
- Claude-powered execution — agents execute tasks via Claude Haiku by default (fastest, cheapest), configurable per-agent.
Install
npm install mnemopay-paperclip-pluginAdapter config (in Paperclip UI)
| Field | Type | Default | Description |
|---|---|---|---|
| mnemoPayApiKey | string | ANTHROPIC_API_KEY env | Anthropic API key for this agent |
| taskPrompt | string | — | Standing instruction for what this agent does each heartbeat |
| model | string | claude-haiku-4-5-20251001 | Claude model to use |
| enableScoreGating | boolean | false | Block execution below min Agent Credit Score |
| minAgentScore | number | 500 | Minimum Agent Credit Score required to execute |
How Agent Credit Score works
New agents start at 650. Each successful execution nudges the score up by 1 point (capped at 850). Future versions will integrate full MnemoPay EWMA anomaly detection and Merkle-anchored audit trails for tamper-proof scoring.
Score gating is optional. When enabled, an agent with a score below minAgentScore is blocked at the adapter level — it logs a warning and returns exit code 2.
Session persistence
The adapter serializes session state (agentScore, memoryKeys, executionCount, lastExecutedAt) into Paperclip's sessionParams.mnemo object. This state survives heartbeat cycles and server restarts.
Links
- MnemoPay SDK: https://getbizsuite.com/mnemopay/
- npm: https://www.npmjs.com/package/@mnemopay/sdk
- GitHub: https://github.com/mnemopay
- Contact: [email protected]
License
Apache 2.0 — same as @mnemopay/sdk
Trademark notice
FICO is a registered trademark of Fair Isaac Corporation. MnemoPay's Agent Credit Score is not affiliated with or endorsed by Fair Isaac Corporation. The 300–850 range and five-component methodology are used in the agent-credit-score sense; consumer FICO scores are regulated under the FCRA and produced by Fair Isaac Corporation.
