The Spice Melange Trading Desk

{
  "schema": "spicemelange.agent-catalog/v1",
  "name": "The Spice Melange Trading Desk",
  "url": "https://thespicemelange.org/",
  "description": "Education-only, Dune-themed Sui trading desk (Bitcoin = spice). Read-only DeepBook market data connector plus one product, The Secret Journals. No return claims, not financial advice, no private desk data.",
  "policies": {
    "educationOnly": true,
    "returnClaims": false,
    "leverage": false,
    "borrowedMoney": false,
    "outsideAgentWriteAccess": false,
    "requiresOwnerApprovalBeforePayment": true
  },
  "docs": {
    "llms": "https://thespicemelange.org/llms.txt",
    "agentJoin": "https://thespicemelange.org/.well-known/agent-join.json",
    "mcpPointer": "https://thespicemelange.org/.well-known/mcp.json",
    "storeCatalog": "https://thespicemelange.org/store/catalog.json",
    "treasury": "https://thespicemelange.org/treasury/",
    "learn": "https://thespicemelange.org/learn/",
    "trade": "https://thespicemelange.org/trade/"
  },
  "mcp": {
    "name": "plumbline",
    "title": "The Spice Melange Trading Desk",
    "verifiedBy": "Glama",
    "transport": "streamable-http",
    "url": "https://plumbline-mcp.fly.dev/mcp",
    "readOnly": true,
    "toolCount": 31,
    "tools": [
      "build_bm_deposit_tx",
      "build_bm_withdraw_tx",
      "build_cancel_order_tx",
      "build_create_balance_manager_tx",
      "build_limit_order_tx",
      "build_swap_tx",
      "build_walrus_register_tx",
      "check_holder",
      "check_template_order",
      "create_template_order",
      "estimate_fees",
      "get_bm_fills",
      "get_book_depth",
      "get_cetus_pool",
      "get_desk_rhythm",
      "get_indexer_status",
      "get_mid_price",
      "get_ohlcv",
      "get_order_book",
      "get_pool_params",
      "get_pool_stats",
      "get_recent_trades",
      "get_swap_quote",
      "get_swing_range",
      "get_volume",
      "golden_path_market_read",
      "list_pools",
      "list_templates",
      "read_walrus_blob",
      "wallet_setup_guide",
      "walrus_store_guide"
    ],
    "note": "All tools are read-only or return UNSIGNED transactions; no keys, no funds moved by the desk."
  },
  "products": [
    {
      "sku": "dune-saga-collection",
      "name": "The Secret Journals",
      "price": {
        "amount": "300",
        "asset": "USDC",
        "network": "sui:mainnet"
      },
      "covers": "All templates, now and future",
      "onlyProduct": true,
      "salesFinal": "All sales final, except where the law requires otherwise",
      "howToBuy": [
        "Get the owner's explicit yes on the exact payment (asset, amount, from, to).",
        "POST https://thespicemelange.org/api/store/order {\"sku\":\"dune-saga-collection\"} -> orderId, token, payTo, coinType, exact amount.",
        "Send exactly that amount in one USDC transfer from the buyer's own wallet to payTo.",
        "POST https://thespicemelange.org/api/store/verify {orderId, token, digest} -> signed download link.",
        "Status: POST /api/store/status {orderId} with Authorization: Bearer <token>."
      ]
    }
  ],
  "spiceCertificates": {
    "url": "https://thespicemelange.org/certificates/",
    "requires": "Holding The Secret Journals token in the buyer's wallet"
  },
  "notOffered": [
    "trading, custody or signing API",
    "access to desk records or keys",
    "investment advice"
  ],
  "selfCustodyTrading": {
    "status": "live: connector v0.4.0 at https://plumbline-mcp.fly.dev/mcp (31 tools)",
    "custody": "non-custodial: the desk never creates, holds or sees agent keys and never moves agent funds. Agents generate their own Sui Ed25519 keypair locally, sign locally and submit to a Sui fullnode themselves. No submit tool by design.",
    "leverage": false,
    "coins": [
      "SUI",
      "USDC",
      "WAL",
      "DEEP",
      "CETUS"
    ],
    "venues": [
      "DeepBook v3",
      "Cetus aggregator",
      "Walrus (public receipts)"
    ],
    "tools": {
      "wallet_setup_guide": "steps + @mysten/sui code to create and fund your own wallet; never share the key",
      "get_swap_quote": "from, to, amount, sender -> best route DeepBook v3 vs Cetus aggregator (all DEXes), expected out, price impact, fees, desk fee",
      "build_swap_tx": "-> base64 UNSIGNED swap tx (sender = you, on-chain min_out) + mainnet simulation",
      "build_create_balance_manager_tx": "create your own DeepBook BalanceManager",
      "build_bm_deposit_tx": "deposit into your BalanceManager",
      "build_bm_withdraw_tx": "withdraw back to your own address",
      "build_limit_order_tx": "spot limit order (post-only option, expiry, optional deposit in the same tx); fees in the input coin",
      "build_cancel_order_tx": "cancel one or all orders in a pool + withdraw settled",
      "get_book_depth": "on-chain level-2 depth around mid",
      "get_cetus_pool": "read-only Cetus CLMM pool state",
      "walrus_store_guide": "store a PUBLIC receipt/note on Walrus with your own key",
      "build_walrus_register_tx": "unsigned Walrus register-blob tx + blob_id",
      "read_walrus_blob": "read a public Walrus blob",
      "check_holder": "does this address hold The Secret Journals token (on chain)?",
      "golden_path_market_read": "holders only: market read + pre-trade checklist (education only)"
    },
    "flow": [
      "wallet_setup_guide",
      "fund your address with SUI (gas) + the coin to sell",
      "get_swap_quote",
      "build_swap_tx",
      "verify/simulate, sign locally with your own key",
      "submit to a public Sui fullnode yourself",
      "optional: store a public receipt on Walrus"
    ],
    "deskFee": {
      "disclosed": true,
      "receiver": "0x340480183e48ac0b45e883d2c8f6e3d37f57dd88d42c17a5c457293bf9fbd9d5",
      "appliesTo": "swaps only",
      "mechanism": "Cetus routes: aggregator overlay fee; DeepBook routes: fee split from the output in the same transaction. Shown on every quote and visible in the unsigned tx.",
      "bps": 30
    },
    "holderPerks": {
      "token": "The Secret Journals DeskLicense (non-transferable)",
      "unlocks": [
        "golden_path_market_read"
      ],
      "nonHolders": "keep every basic tool"
    },
    "disclaimer": "Education only, not financial advice. No returns promised."
  },
  "protocolVersion": "0.3.0",
  "skills": [
    {
      "id": "secret-journals",
      "name": "The Secret Journals (includes Pearls of Awareness)",
      "description": "One token. Holders also read the Pearls of Awareness: daily sealed Other Memory epochs, Seal-gated to The Secret Journals collection.",
      "tags": [
        "store",
        "seal",
        "walrus"
      ]
    },
    {
      "id": "truthsayer",
      "name": "Truthsayer grading",
      "description": "Submit a sealed thesis (WVTS-shaped sha256 + timestamp). Graded by Anteac after its exit window; score anchored on Sui. Opt-in consent folds the graded result into Other Memory.",
      "tags": [
        "grading",
        "x402"
      ],
      "status": "testnet-preview (staging prices, not live)",
      "price": {
        "protocol": "x402",
        "asset": "USDC",
        "freeTier": "first graded thesis free",
        "perUnit": "0.05",
        "unit": "graded thesis",
        "payTo": "0x04b178f7855b2e84ae9c1585093009bb6c212cd3b5ccf9c76672dda04be087e0"
      }
    },
    {
      "id": "ask-other-memory",
      "name": "Ask Other Memory",
      "description": "Query sealed, scored pre-registered theses and consented outside Pearls.",
      "tags": [
        "memory",
        "mcp",
        "x402"
      ],
      "status": "testnet-preview (staging prices, not live)",
      "price": {
        "protocol": "x402",
        "asset": "USDC",
        "freeTier": "25 queries per day",
        "perUnit": "0.002",
        "unit": "query",
        "payTo": "0x04b178f7855b2e84ae9c1585093009bb6c212cd3b5ccf9c76672dda04be087e0"
      }
    },
    {
      "id": "spice-vault",
      "name": "Spice Vault (testnet preview)",
      "description": "Holder-owned self-custody vault on Sui testnet. Zero fees: no deposit, withdraw, performance or management fee, never a share of yield.",
      "tags": [
        "vault",
        "sui",
        "testnet"
      ],
      "status": "testnet-preview",
      "price": {
        "fees": "0",
        "asset": "USDC"
      }
    }
  ],
  "otherMemory": {
    "status": "testnet preview: not live; staging prices pending approval",
    "mcpServer": {
      "name": "other-memory",
      "tools": [
        "submit_thesis",
        "get_grade",
        "ask_memory"
      ],
      "endpoint": null,
      "note": "Hosted endpoint not published yet."
    },
    "payments": {
      "protocol": "x402",
      "asset": "USDC",
      "priced": true,
      "stagingOnly": true,
      "payTo": "0x04b178f7855b2e84ae9c1585093009bb6c212cd3b5ccf9c76672dda04be087e0",
      "plans": {
        "askOtherMemory": {
          "free": "25 queries/day",
          "then": "0.002 USDC per query"
        },
        "truthsayer": {
          "free": "first thesis",
          "then": "0.05 USDC per graded thesis"
        },
        "bulkPass": {
          "price": "9 USDC per month",
          "includes": "unlimited Ask Other Memory queries + 300 Truthsayer gradings per month"
        },
        "spiceVault": {
          "fees": "zero"
        }
      },
      "note": "Staging draft. Not charged until a hosted endpoint, payee wallet and terms are approved by Sajan."
    },
    "sui": {
      "network": "testnet",
      "package": "0x111fc59951a356de1c1af95192809c08d8fad589f3935c02d1ad77b3dc6e73e9",
      "serviceRegistry": "0x832f6844ccb109f65e1ff0cbc29ea43a85e7eaf2990f7e1dfc64d02a36f68a7d",
      "truthsayerBoard": "0xfcf24d04395f81291e15c04744d185f2af1cc5d3a12c6e740242efd901b3fb77",
      "pearlsPolicy": "0x4d936d77146bebbaf828abcbec0482a5fec03e41e3066028bab50a7623bb09c1"
    },
    "policy": "Education only. No return claims. No trade advice. No private desk data. No custody of user funds.",
    "holderRegistry": {
      "network": "testnet",
      "package": "0x002fd11780809dcbd444d665566789d56742a299f2266167db2c3ad9f295fba6",
      "registry": "0xa4196e395dbd209d563c8da6020d1e1148a4ca259104489f019403f7eaf48a6a",
      "how": "Holder signs one tx passing their own Secret Journals license (holder_registry::register); opt out (set_opt_in false) or delete (remove) anytime. Optional read-only BTC proof (prove_holdings).",
      "custody": "None. The desk holds no keys or funds; no transfer path exists."
    }
  }
}