Gloam

What Gloam is, what this hosted server can do, and where to go to sign or spend. Call this first. This server only reads and plans: it never holds funds and never takes a private key, recovery phrase or note secret.

{
  "type": "object",
  "properties": {}
}

The networks Gloam runs on, with each vault (pool) address, the assets you can deposit (OUSD and PathUSD on Tempo, USDG and ETH on Robinhood Chain), explorers, RPCs and faucets.

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "enum": [
        "tempo",
        "robinhood"
      ],
      "description": "Gloam network: \"tempo\" (Tempo Moderato testnet, private stablecoin payments) or \"robinhood\" (Robinhood Chain testnet). Leave out for both."
    }
  }
}

Public totals for each Gloam vault, read from the chain: what it holds, and counts of deposits, private transfers, cash outs and payment messages. Totals only, no wallets. Cached about a minute.

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "enum": [
        "tempo",
        "robinhood"
      ],
      "description": "Gloam network: \"tempo\" (Tempo Moderato testnet, private stablecoin payments) or \"robinhood\" (Robinhood Chain testnet). Leave out for both."
    }
  }
}

Make a link that asks someone to pay your Gloam address privately. It opens Pay in the Gloam app with the address, amount, asset and note filled in; the payer checks and sends. The details ride after the # of the link, so the payer's browser never sends them to a server. Needs your public Gloam address (gloamr1.…), never a key.

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Your Gloam address to be paid at, gloamr1.… (public; find it in the app under Receive)."
    },
    "network": {
      "type": "string",
      "enum": [
        "tempo",
        "robinhood"
      ],
      "description": "Gloam network: \"tempo\" (Tempo Moderato testnet, private stablecoin payments) or \"robinhood\" (Robinhood Chain testnet).",
      "default": "robinhood"
    },
    "asset": {
      "type": "string",
      "description": "Token symbol or address, e.g. USDG on Robinhood Chain, OUSD or PathUSD on Tempo. Default: the network's main stablecoin."
    },
    "amount": {
      "type": "string",
      "description": "Amount in whole units, e.g. \"12.50\". Leave out to let the payer choose."
    },
    "note": {
      "type": "string",
      "description": "A reference the payer sees, e.g. \"Invoice 042\" (up to 80 characters)."
    },
    "name": {
      "type": "string",
      "description": "Your name as the payer should see it (up to 40 characters)."
    }
  },
  "required": [
    "to"
  ]
}

Check a Gloam proof someone shared with you: proof of funds (gloamfunds1:), proof of payment (gloampay1:), payroll total (gloamroll1:) or balance disclosure (gloamdisc1:). Runs the same checks as gloam.trade/verify on the server: the zero-knowledge proof, that it was made on Gloam's vault, who it is for, expiry, and the live vault state. Proofs are meant to be shared; they hold no secrets.

{
  "type": "object",
  "properties": {
    "proof": {
      "type": "string",
      "description": "The full proof text, starting gloamfunds1:, gloampay1:, gloamroll1: or gloamdisc1:."
    }
  },
  "required": [
    "proof"
  ]
}

Plan a deposit into a private Gloam balance (a shield): the steps, what becomes public and what stays private, and the app link to do it. Does not sign or send anything; you sign in your own wallet in the app.

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "enum": [
        "tempo",
        "robinhood"
      ],
      "description": "Gloam network: \"tempo\" (Tempo Moderato testnet, private stablecoin payments) or \"robinhood\" (Robinhood Chain testnet).",
      "default": "tempo"
    },
    "asset": {
      "type": "string",
      "description": "Token symbol or address. Default: the network's main stablecoin (OUSD on Tempo, USDG on Robinhood Chain)."
    },
    "amount": {
      "type": "string",
      "description": "Amount in whole units, e.g. \"25\"."
    }
  }
}

How to pay or charge privately over MPP (the Machine Payments Protocol, HTTP 402) with the gloam method from @gloamtrade/mppx-gloam, with code. A charge settles as a private transfer in a Gloam vault: the chain sees no amount, asset, payer or payee.

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "pay",
        "charge",
        "both"
      ],
      "default": "both",
      "description": "\"charge\" to get paid for an API or tool, \"pay\" for an agent or app paying one, \"both\" for both."
    },
    "network": {
      "type": "string",
      "enum": [
        "tempo",
        "robinhood"
      ],
      "description": "Gloam network: \"tempo\" (Tempo Moderato testnet, private stablecoin payments) or \"robinhood\" (Robinhood Chain testnet).",
      "default": "tempo"
    }
  }
}

Commands to install the local Gloam MCP server, which can sign and pay (shield, private pay, x402 and MPP, spending limits) with keys kept on your machine: Claude Code, Codex, Cursor, VS Code, Claude Desktop and any MCP client, plus the plugin marketplace cryptoduke01/gloam-plugins.

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "claude-code",
        "codex",
        "cursor",
        "vscode",
        "claude-desktop",
        "gemini",
        "all"
      ],
      "default": "all",
      "description": "Which app to show commands for."
    }
  }
}