{"uid":"cap_jqPyFJTu37HHPPwk8OTxA","slug":"innovalyxx-sovereign-edge-memory-read-b627b7bf","name":"Innovalyxx Sovereign Edge – memory.read","description":"Verified cyber-physical AI tools for autonomous agents. Pay per call via x402 (USDC on Base). 26 tools covering MRV verification, biodiversity, skip twin, site certification, agent trust, transaction evidence, protocol bridging, GEO audit, IATP reputation, ABV maturity, NIST TEVV alignment, and encrypted memory write/read/query/grant/revoke/tool_context/pricing_hint/subscription_quote/attest/verify_attestation.","url":"https://edge.innovalyxx.com/mcp/tools/memory.read","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum entries to return (1–500, default 100)."},"category":{"enum":["verification","preference","context","history"],"type":"string","description":"Optional category filter. Omit to return every category the caller may read."},"actor_did":{"type":"string","description":"Optional DID of the caller."},"entity_id":{"type":"string","minLength":1,"description":"Stable identifier of the entity whose encrypted memory should be returned."},"owner_wallet":{"type":"string","maxLength":42,"minLength":42,"description":"Optional owner address. Required (and must match signer) for owner self-read."},"signer_wallet":{"type":"string","maxLength":42,"minLength":42,"description":"0x-prefixed address of the caller. Owner path when it matches owner_wallet."},"wallet_signature":{"type":"string","description":"EIP-191 signature over the deterministic read message (owner or grantee role)."}}},"responseSchema":{"type":"json","example":{"ok":true,"tool":"memory.read","count":1,"entries":[],"payment":{},"read_at":"read_at","category":"category","entity_id":"entity_id","accessed_as":"accessed_as"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hV-SKB6Vu0JIVGis3uiuE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads encrypted memory entries for a given entity, returning stored verification, preference, context, or history records to authorized callers via wallet-signed authentication.","exampleAgentPrompt":"Fetch up to 50 encrypted memory entries in the 'verification' category for entity 'site-001-AU' — my signer wallet is 0xABCDEF1234567890ABCDEF1234567890ABCDEF12 and here's my EIP-191 signature over the read message.","exampleUseCases":[{"title":"Agent retrieves its own context history","prompt":"Pull all 'context' category memory entries for entity 'agent-node-42' — my wallet is 0x1111111111111111111111111111111111111111 and I'm the owner, here's my EIP-191 signature."},{"title":"Auditor reads site verification records","prompt":"Read up to 200 verification-category memory entries for entity 'solar-site-BR-07' using my grantee wallet 0x2222222222222222222222222222222222222222 and this signature so I can audit past MRV records."},{"title":"Preference recall for personalized agent behavior","prompt":"Retrieve the stored preference entries for entity 'user-profile-99X', limit to 25 results, signed by wallet 0x3333333333333333333333333333333333333333 with this EIP-191 signature."}],"resultDescription":"Returns a JSON object with ok status, the tool name, count of returned entries, a list of memory entry objects, the category filtered on, the entity_id queried, the role the caller accessed as (owner or grantee), a read timestamp, and a payment receipt object confirming the $0.01 USDC per-call charge.","failureModes":["Missing or invalid wallet_signature causes authentication failure","entity_id not found returns empty entries array or 404-equivalent","owner_wallet mismatch with signer_wallet on owner path causes authorization rejection","limit out of range (below 1 or above 500) causes validation error","Insufficient USDC balance or x402 payment failure blocks the call","Caller not granted read access to the entity returns permission denied","Malformed 0x address (not exactly 42 chars) fails schema validation"],"whenToPreferThis":"Use this endpoint when an autonomous agent or authorized grantee needs to retrieve encrypted, categorized memory entries for a specific entity within the Innovalyxx Sovereign Edge trust infrastructure. Prefer this over generic key-value stores when wallet-based ownership and EIP-191 signed access control are required, or when the memory is linked to MRV verification, biodiversity, site certification, or agent trust workflows on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T12:54:47.621Z","isFirstParty":false}