Nukez

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.

Raw schema/v1/tools.json

Machine-readable tool names and argument schemas.

Payment boundaryNo hosted custody

Payment signatures are recorded after local execution.

Protected accessSigned envelopes

Locker reads, writes, deletion, and provisioning bind to client proof.

Tool table

Hosted tool surface

GroupToolDescription
Payment and setupnukez_quoteQuote storage and return payment_options for units, provider, network, and payment asset selection.
nukez_payRecord an externally executed transaction signature. The hosted MCP server does not move funds.
nukez_provisionFirst confirms payment and returns the provision envelope spec; then activates the locker with a client-signed envelope.
nukez_setupRehydrate an existing receipt-backed locker. New storage setup uses quote, external transfer, pay, and provision.
Filesnukez_create_fileCreate a file entry and return upload_url, download_url, and confirm_url for direct signed-URL flows.
nukez_storeStore files through signed inline data_b64, source_url, or host-byte staging with data_token.
nukez_confirmConfirm bytes after a direct signed-URL upload so size and content_hash enter the manifest.
nukez_upload_chunkAdvanced fallback for constrained runtimes when source_url and host byte staging are unavailable.
nukez_retrieveList visible files, retrieve file content, or fall through to the memory index for unresolved names.
nukez_deleteDelete files from a locker. Deletion invalidates prior attestations until the file set is re-attested.
Proof and freshnessnukez_statusPre-setup status, active session bootstrap, manifest_hash and memory.version freshness checks.
nukez_verifyVerify storage with push=false, anchor with push=true, or return a per-file Merkle inclusion proof.
nukez_diffCompare current signed-list manifest state against cached_manifest_hash without downloading file bytes.
Memorynukez_rememberWrite structured memory records through the production two-phase sign_envelopes plan/execute flow.
nukez_recallRead memory records by key, namespace, tags, query, prefix, or include_archived.

Resources

MCP resources and prompt

URI / promptPurpose
nukez://instructionsFull operational instructions
nukez://instructions/minimalAbbreviated instructions for returning sessions
nukez://tools/compactCompact name, summary, and category list
nukez://locker/{receipt_id}/manifestVisible files, manifest_hash, and memory summary
nukez://locker/{receipt_id}/file/{filename}File content resource
session_bootstrapPrompt for trust check, context load, and cache refresh

Canonical flow

Notebook-backed sequence

StepMethod / toolPurpose
0initialize, tools/listHandshake and tool discovery
1nukez_statusPre-setup status
2nukez_quoteQuote storage and payment options
3solana_transfer, nukez_payExecute external payment and record transaction
4nukez_provisionConfirm payment, sign provision envelope, activate locker
5-6nukez_storeStore small or moderate data_b64 files with envelope
7/blob/*, nukez_store(data_token=...)Canonical large-file host byte staging
8-9nukez_retrieveList files, download, and byte-match verify
10gateway receipt proxyPublic receipt file URL
11-12nukez_statusActive bootstrap and returning-session freshness
13-15nukez_verifyPre-attest check, on-chain attest, and Merkle inclusion proof
16-17gateway verificationReceipt hash check and verification bundle
18nukez_deleteDelete file and invalidate prior attestation
19-20nukez_remember, nukez_recallMemory write/read and session persistence via supersedes
21nukez_store, nukez_rememberProvenance tracking
22nukez_retrieveUnified file/memory retrieval
23nukez_diffZero-download freshness check

Rules

Operational constraints

Rule
Save receipt_id permanently after payment confirmation.
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, and locker:provision for provisioning.
Build envelope bodies with canonical JSON: compact separators and sorted keys.
Use MCP host byte staging for large local files; reserve nukez_upload_chunk for advanced fallback cases.
Re-run nukez_verify(push=True) after storing or deleting files.
Cache manifest_hash and memory.version between sessions.

§ next