Machine-readable tool names and argument schemas.
Docs · MCP
MCP server
15 tools
Tools
MCP tool reference
MCP tool groups
The hosted MCP server exposes payment setup, file operations, verification and freshness checks, and receipt-attached memory. Tools that touch protected locker state require client-signed envelopes.
Payment signatures are recorded after local execution.
Locker reads, writes, deletion, and provisioning bind to client proof.
Tool table
Hosted tool surface
| Group | Tool | Description |
|---|---|---|
| Payment and setup | nukez_quote | Quote storage and return payment_options for units, provider, network, and payment asset selection. |
nukez_pay | Record an externally executed transaction signature. The hosted MCP server does not move funds. | |
nukez_provision | First confirms payment and returns the provision envelope spec; then activates the locker with a client-signed envelope. | |
nukez_setup | Rehydrate an existing receipt-backed locker. New storage setup uses quote, external transfer, pay, and provision. | |
| Files | nukez_create_file | Create a file entry and return upload_url, download_url, and confirm_url for direct signed-URL flows. |
nukez_store | Store files through signed inline data_b64; large files use nukez_create_file with a direct PUT instead. | |
nukez_confirm | Confirm bytes after a direct signed-URL upload so size and content_hash enter the manifest. | |
nukez_upload_chunk | Advanced fallback for constrained runtimes where a direct PUT to the upload_url is impossible. | |
nukez_retrieve | List visible files with a locker:list envelope, or retrieve file content with a locker:read envelope. | |
nukez_delete | Delete files from a locker. Deletion invalidates prior attestations until the file set is re-attested. | |
| Proof and verification | nukez_status | Pre-setup status, or returning-session bootstrap with a signed locker:list envelope. |
nukez_verify | Verify with push=false, anchor on-chain with push=true (two-phase: sign the returned locker:attest envelope spec), or return a per-file Merkle inclusion proof. | |
nukez_recompute_verify | Byte-level audit: re-downloads every file, recomputes hashes, rebuilds the Merkle tree, and compares against the persisted attestation. | |
| Memory | nukez_remember | Write structured memory records through the two-phase plan/execute flow: the plan returns record and index files to store with signed envelopes. |
nukez_recall | Read memory records by key, namespace, tags, query, prefix, or include_archived. |
Resources
MCP resources and prompt
| URI / prompt | Purpose |
|---|---|
nukez://instructions | Full operational instructions |
nukez://config | Server configuration summary |
nukez://wallet | Wallet and lifecycle state summary |
nukez://sandbox-upload-playbook | Upload guidance for constrained sandboxes |
nukez://locker/{receipt_id}/manifest | Manifest with visible files |
nukez://locker/{receipt_id}/file/{filename} | File content resource |
Canonical flow
Notebook-backed sequence
| Step | Method / tool | Purpose |
|---|---|---|
| 0 | initialize, tools/list | Handshake and tool discovery |
| 1 | nukez_status | Pre-setup status |
| 2 | nukez_quote | Quote storage and payment options |
| 3 | solana_transfer / send_spl, nukez_pay | Execute external payment and record it (pass pay_asset for SPL) |
| 4 | nukez_provision | Confirm payment, sign provision envelope, activate locker |
| 5 | nukez_store | Store small inline data_b64 files with envelope |
| 6 | nukez_create_file, PUT, nukez_confirm | Canonical large-file direct upload |
| 7-8 | nukez_retrieve | List files, download, and byte-match verify |
| 9 | gateway receipt proxy | Public receipt file URL |
| 10 | nukez_status | Returning-session bootstrap with locker:list envelope |
| 11-13 | nukez_verify | Structural check, two-phase on-chain attest, and Merkle inclusion proof |
| 14 | nukez_recompute_verify | Byte-level audit against the persisted attestation |
| 15-16 | gateway verification | Receipt hash check and verification bundle |
| 17 | nukez_delete | Delete file and invalidate prior attestation |
| 18 | nukez_remember, nukez_recall | Memory write/read and session persistence via supersedes |
Rules
Operational constraints
| Rule |
|---|
| Save receipt_id permanently after payment confirmation. |
| Quotes expire in about 5 minutes — transfer and confirm promptly, or re-quote. |
| For SPL payments (BETA/USDC/USDT/WETH), always pass pay_asset to nukez_pay and nukez_provision, and send the transfer to the quote's token account directly — never derive an ATA from pay_to_address. |
| Production post-provisioning operations require signed envelopes. |
| Use locker:write for create/delete/write flows, locker:list for listings, locker:read for per-file reads, locker:provision for provisioning, and locker:attest (with the query field) for attestation. |
| Build envelope bodies with canonical JSON: compact separators and sorted keys. |
| Use nukez_create_file with a direct PUT for large files; reserve nukez_upload_chunk for runtimes where a direct PUT is impossible. |
| Re-run the two-phase attest after storing or deleting files. |