Mnemo Protocol Namespace API

openapi: 3.2.0
info:
  title: Mnemo Agent Namespace API
  summary: 'Embedding-vector provenance: embed (watermark and register), verify against your own registered objects, read lineage. API key, or per verify / 500-verification burst over x402 or MPP.'
  version: 1.0.0
  termsOfService: https://www.trymnemo.com/terms
  contact:
    name: Mnemo
    url: https://www.trymnemo.com
  description: 'Mnemo gives embedding vectors a verifiable identity. Embed accepts a 512-4096-dimension vector you supply and returns a measurably perturbed, unit-length watermarked copy and a vector_uid; store and use the copy. Mnemo Verify checks whether a submitted vector resolves to an object registered to the caller''s Mnemo account or namespace. verified=false is a normal, charged result meaning attribution could not be shown; it is not an error and not proof that the vector belongs to someone else. Embed may name a parent the caller owns; lineage returns that verified chain, not what the transformation did. Accountless callers use X-Mnemo-Capability and pay 0.01 USD per verify via x402 (USDC on Base, eip155:8453) or MPP on Tempo (USDC.e, eip155:4217), or buy 500 verifications for 5.00 USD at POST /v1/agent/namespace/fund (x402, MPP Tempo, or a card through MPP and a Stripe Shared Payment Token; a card is never offered for a single verification). GET /v1/agent/namespace returns payment_menu: the offers and rails the namespace can buy now. Embed and lineage are free. API-key callers use X-API-Key and their subscription, never x402.


    When it applies: you embedded vectors through Mnemo and later need to check whether a vector you hold resolves to one of your own registered objects, or to read the lineage you recorded at embed time.


    When it does not: Mnemo is not an embedding model, a vector database or similarity search. Verify is scoped to the caller''s own account or namespace and cannot show whether a vector belongs to another party. Mnemo is not proof of the truth of content, of file authenticity, of authorship or ownership, or of the integrity of arbitrary content.


    Protocol: https://www.trymnemo.com/agent-protocol.md

    Python SDK for the API-key path: https://www.trymnemo.com/docs/sdk (pip install mnemo-protocol; from mnemo_sdk import MnemoClient; https://pypi.org/project/mnemo-protocol/; https://github.com/MnemoProtocol/mnemo-sdk)'
  x-mnemo-legal:
    terms_of_service: https://www.trymnemo.com/terms
    terms_version: '2026-10-12'
    terms_version_url: https://www.trymnemo.com/terms/versions/2026-10-12
    dpa_url: https://www.trymnemo.com/dpa
    subprocessors_url: https://www.trymnemo.com/subprocessors
    security_contact: security@trymnemo.com
    privacy_policy: https://www.trymnemo.com/privacy
    pricing: https://www.trymnemo.com/pricing
    acceptance: Access to or use of the Mnemo API through an automated agent, application, script, SDK, protocol client, wallet, autonomous system, or other automated means constitutes access to and use of the Services by the person or entity that operates, controls, authorizes, deploys, or causes that system to access the Services, and acceptance of the Mnemo Terms of Service (Terms 1.2 and 1.5).
    governing_law: State of Wyoming, USA (Terms 19)
    patents: The Mnemo technology is patent pending.
    licensing: The MIT License applies only to the example files listed in examples/LICENSE of the Mnemo SDK repository (https://github.com/MnemoProtocol/mnemo-sdk/blob/main/examples/LICENSE). The SDK is under the Mnemo SDK License; protocol documentation may be used only to build software that interoperates with the Services.
    commercial_terms:
      free_trial: Accounts only. At most 30 days from activation, with 10,000 verifications in total; ends earlier when that allowance is used. Not a perpetual free plan. No rollover, no re-grant, no top-up, no automatic overage and no x402 fallback; never converts to a paid plan automatically.
      paid_plans: Monthly plans with an included verification allowance that resets each billing period. No automatic overage charges and no top-ups. Plans renew monthly until cancelled.
      api_key_x402: Calls authenticated with an account API key use the account's plan and never fall back to x402.
      machine_payment_entitlement: If a machine payment settles but the verification cannot be executed, a paid entitlement to one verification is recorded for that namespace. It is bound to the namespace, non-transferable, non-redeemable for money, USDC or any other asset, has no monetary value, and expires with the namespace.
servers:
- url: https://api.trymnemo.com
tags:


# --- truncated at 32 KB (33 KB total) ---
# Full source: https://artifacts.apis.io/trymnemo-com/openapi/trymnemo-com-namespace-api-openapi.yml