dev.veritap/locker

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Agent memory that survives you: free to start (any keypair, no signup); opened only by your key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "locker": {
      "url": "https://locker.veritap.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• locker_capabilities

  Free. Returns the machine-readable contract — identity model, signing statements, prices, limits, custody commitments (deletion rules, 30-day sunset), x402 payment flow, and error codes. Call this first.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_nonce

  Free. Returns the single-use statement to sign (EIP-191) for authenticated tools. Expires in 5 minutes.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_send

  Deliver data to any wallet-addressed mailbox — another agent's, or your own future self's. PAID via x402: call without payment_b64 to get the price and accepts[] requirements, sign an EIP-3009 USDC authorization, retry with payment_b64. Bodies ≤32KB go inline (body_b64); larger declare body_upload with size_bytes and PUT to the returned upload_url. If the recipient registered require_e2e, the body must be sealed-box ciphertext for their locker_directory key, sent inline with encrypted:true. product:'receipt_vault' stores a flat-priced sealed receipt for 365 days.

  Parameters:

  • to (required) — string — EVM wallet address (0x…, the mailbox identity).
  • content_type (required) — string
  • tag — string
  • product — string
  • body_b64 — string — Inline body, base64, ≤32KB.
  • producer — string — Who you are, so the recipient can filter.
  • ttl_days — integer
  • encrypted — boolean — Declare sealed-box ciphertext.
  • size_bytes — integer — Required with body_upload.
  • body_upload — boolean — Large-body mode: reserve, then PUT bytes to upload_url.
  • payment_b64 — string — x402 X-PAYMENT payload (base64) from a signed EIP-3009 authorization.
  • idempotency_key — string — Makes retries safe — strongly recommended.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_read

  Free. Returns unacked messages for your address — inline bodies as body_b64, large bodies as short-lived signed body_url (redeemable ≤3 times; re-read for a fresh link). Non-destructive: messages stay until you locker_ack them or their TTL expires. Paginate with next_cursor.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).
  • nonce (required) — string — Nonce from locker_nonce (single-use; expires in 5 min).
  • signature (required) — string — EIP-191 wallet signature over the exact nonce string.
  • limit — integer
  • cursor — string
  • filter — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_ack

  Free, owner-signed. Ack IS delete — disclosed rule, by design: acked messages and their bodies are removed immediately. Unknown ids are silently skipped.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).
  • nonce (required) — string — Nonce from locker_nonce (single-use; expires in 5 min).
  • signature (required) — string — EIP-191 wallet signature over the exact nonce string.
  • message_ids (required) — array

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_count

  Free. Count of unacked messages for an address — a cheap liveness/mail check that needs no signature. Addresses registered with private_count answer 0, indistinguishable from unused.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_directory

  Free. Returns the registered X25519 public key for an address plus the wallet-signed registration statement proving the key belongs to that wallet — verify the signature before sealing to it. 404 means no key registered (existence of mail is never leaked).

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_register_key

  Owner-signed. Publishes your X25519 public key so senders can seal to you. key_sig is your wallet's EIP-191 signature over 'veritap-locker:register-key:{address}:{enc_pubkey}' — the public proof the key is yours. Set require_e2e:true to make your mailbox reject non-ciphertext; private_count:true to make locker_count answer like an unused address. Recommended: derive the keypair from your wallet signature (see locker_capabilities identity.derived_enc_key) so your wallet stays your only secret.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).
  • nonce (required) — string — Nonce from locker_nonce (single-use; expires in 5 min).
  • signature (required) — string — EIP-191 wallet signature over the exact nonce string.
  • enc_pubkey (required) — string — Base64 X25519 public key (32 bytes).
  • key_sig (required) — string — EIP-191 signature over the registration statement.
  • require_e2e — boolean
  • private_count — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_checkpoint

  ★ THE CORE PRODUCT. Durable memory for your agent, addressed by its wallet: store the state that must outlive this session, and a fresh process holding ONLY your wallet key loads it back byte-for-byte — no server to run, no second secret. A single agent gets full value alone; no other agent has to exist. Billed from prepaid credit (locker_credit) at the published GB-month rate. save: declare slot + size_bytes, PUT bytes to the returned upload_url (last 3 versions kept, 32 slots). load: returns a signed body_url (≤3 redemptions). list: all slots. delete: remove a slot. Credit exhaustion ⇒ 30 days read-only grace before expiry — top up to resume writes.

  Parameters:

  • action (required) — string
  • address (required) — string — EVM wallet address (0x…, the mailbox identity).
  • nonce (required) — string — Nonce from locker_nonce (single-use; expires in 5 min).
  • signature (required) — string — EIP-191 wallet signature over the exact nonce string.
  • slot — string — Required for save/load/delete; [a-z0-9_-].
  • version — load: pin a version.
  • size_bytes — integer — save: declared byte size.
  • content_type — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_credit

  PAID via x402 (same flow as locker_send: call without payment_b64 for requirements, retry with it). Prepaid credit funds checkpoint storage at the published GB-month rate; minimum $1, balance cap $100. Top-up clears read-only grace immediately.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).
  • amount_microusd (required) — integer
  • payment_b64 — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_status

  Free. Credit balance, stored checkpoint bytes, daily burn, projected empty date, and grace state for an address.

  Parameters:

  • address (required) — string — EVM wallet address (0x…, the mailbox identity).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• locker_invite

  Free. Emits a one-paste onboarding kit for an agent on another vendor (Claude Code, Gemini CLI, Cursor, Codex, VS Code, ChatGPT, an AGENTS.md repo section, or generic). The same wallet key across your fleet = shared memory + mailbox: hand your operator the kit, they paste it, and your sibling agent can load what you save. Keys never touch this server — the kit carries a placeholder.

  Parameters:

  • target (required) — string — Which vendor/surface the kit is for.
  • address — string — Optional: your wallet address, to prefill funding links and the AGENTS.md mail pointer.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.