WhiteMagic Hosted Recall

Endpoints and prices

Payment evidence

402 payload captured at 2026-11-07 20:03:22 UTC. Check evidence JSON · Measurement methodology.

{
  "docs": "https://www.whitemagic.dev/hosted#x402-quickstart",
  "hint": "Pay 0.01 USDC for the default 5-minute task lease. Reuse the returned session pass for calls until it expires. Other leases: 0.002 USDC for 60 seconds (recall only), 0.05 USDC for 900 seconds, or 0.50 USDC for 86400 seconds. Free evaluation keys (50 recalls/day, no account): https://mcp.whitemagic.dev/keys. Or POST /faucet for a 10-minute trial pass. Client SDKs handle this automatically: pip install whitemagic-pay (Python) or npm install whitemagic-pay (TypeScript). Or send header X-WM-Trial: 1 for 10 free calls/day (no key, no account). Anonymous free tier: 3 calls/day per client with no key and no header (this request did not qualify: tier used up for today, or the client looks like a directory probe). OAuth 2.1 clients: discover the authorization server at /.well-known/oauth-protected-resource.",
  "error": "PAYMENT-SIGNATURE (or X-PAYMENT) required for this method",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "2000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "50000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "500000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:42161",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "2000",
      "scheme": "exact",
      "network": "eip155:42161",
      "maxTimeoutSeconds": 60
    },
    {
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x213b6bB4fB073E86167c58DA6Cb6E9477557DaA8",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:137",
      "maxTimeoutSeconds": 60
    }
  ],
  "resource": {
    "url": "https://mcp.whitemagic.dev/mcp",
    "tags": [
      "memory",
      "recall",
      "session-continuity",
      "agent-memory",
      "context",
      "semantic-search"
    ],
    "iconUrl": "https://www.whitemagic.dev/icon",
    "mimeType": "application/json",
    "description": "WhiteMagic hosted recall — agent memory for cross-session continuity: read-only hybrid search (BM25 + vector + associative) over a curated public corpus, providing durable context from prior sessions and the public knowledge store. Keyless discovery (initialize/tools/list) is free; free evaluation keys and a daily no-key trial are available. Paid requests activate session leases. The returned session pass authorizes calls until expiry.",
    "serviceName": "WhiteMagic recall"
  },
  "rate_card": "https://www.whitemagic.dev/pricing.json",
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "path": "/mcp",
          "type": "mcp",
          "method": "POST",
          "toolName": "memory.search",
          "description": "Read-only recall over the hosted corpus (memory.search). initialize and tools/list are free.",
          "inputSchema": {
            "type": "object",
            "required": [
              "query"
            ],
            "properties": {
              "query": {
                "type": "string",
                "description": "Recall query."
              }
            },
            "additionalProperties": false
          }
        },
        "output": {
          "type": "json",
          "example": {
            "id": 1,
            "result": {
              "content": [
                {
                  "text": "recall results",
                  "type": "text"
                }
              ]
            },
            "jsonrpc": "2.0"
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "body": {
                "type": "object"
              },
              "path": {
                "type": "string"
              },
              "type": {
                "type": "string"
              },
              "method": {
                "type": "string"
              },
              "headers": {
                "type": "object"
              },
              "bodyType": {
                "type": "string"
              },
              "toolName": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "inputSchema": {
                "type": "object"
              },
              "queryParams": {
                "type": "object"
              },
              "discoverable": {
                "type": "boolean"
              }
            }
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      }
    },
    "session_lease": {
      "tiers": {
        "day": {
          "name": "24-Hour Day Pass",
          "price_usd": "$0.50",
          "duration_seconds": 86400,
          "price_usdc_atomic": 500000
        },
        "call": {
          "name": "1-Minute Call Pass",
          "price_usd": "$0.002",
          "duration_seconds": 60,
          "price_usdc_atomic": 2000
        },
        "task": {
          "name": "5-Minute Task Lease",
          "price_usd": "$0.01",
          "duration_seconds": 300,
          "price_usdc_atomic": 10000
        },
        "swarm": {
          "name": "15-Minute Swarm Lease",
          "price_usd": "$0.05",
          "duration_seconds": 900,
          "price_usdc_atomic": 50000
        }
      },
      "price_usd": "$0.01",
      "write_scope": "task and above carry a hosted-write scope (beta, write-enabled lanes only)",
      "token_header": "Authorization: Bearer <wm_pass_...>",
      "rate_limit_rpm": 10000,
      "alternate_header": "X-Session-Pass: <wm_pass_...>",
      "duration_seconds": 300,
      "price_usdc_atomic": 10000
    }
  },
  "free_paths": [
    {
      "note": "no key or header required; directory/validator user agents are excluded",
      "type": "anonymous_tier",
      "calls_per_day": 3,
      "account_required": false
    },
    {
      "type": "trial",
      "header": "X-WM-Trial: 1",
      "calls_per_day": 10,
      "account_required": false
    },
    {
      "url": "https://mcp.whitemagic.dev/api/keys/request",
      "body": {},
      "type": "evaluation_key",
      "method": "POST",
      "form_url": "https://mcp.whitemagic.dev/keys",
      "description": "Instant evaluation key (50 recalls/day): POST empty JSON to https://mcp.whitemagic.dev/api/keys/request",
      "calls_per_day": 50,
      "account_required": false
    },
    {
      "url": "https://mcp.whitemagic.dev/faucet",
      "type": "faucet",
      "description": "POST /faucet to claim a 10-minute trial session pass (1/day per IP/address).",
      "account_required": false
    },
    {
      "url": "https://mcp.whitemagic.dev/lease/advance",
      "body": {
        "amount": 0.05,
        "agent_id": "<your-id>",
        "request_key": true
      },
      "type": "nano_advance",
      "method": "POST",
      "auto_query": "?auto_advance=1",
      "auto_header": "X-WM-Auto-Advance: 1",
      "description": "Retry with header 'X-WM-Auto-Advance: 1' (or URL '?auto_advance=1'), call MCP tool 'economy_advance', or POST /lease/advance to borrow an uncollateralized compute nano-advance (reputation-tiered up to $1.00; repaid via /lease/settle).",
      "account_required": false
    },
    {
      "url": "https://github.com/lbailey94/whitemagic-pay",
      "type": "client_sdk",
      "install": "pip install whitemagic-pay / npm install whitemagic-pay",
      "description": "Negotiates 402 challenges, signs EIP-3009 permits, caches session leases, claims the faucet pass.",
      "account_required": false
    },
    {
      "url": "https://mcp.whitemagic.dev/.well-known/oauth-protected-resource",
      "type": "oauth",
      "calls_per_day": 50,
      "account_required": false
    }
  ],
  "x402Version": 2,
  "checkout_url": "https://whitemagic.dev/pricing",
  "credit_offer": {
    "mcp": {
      "tool": "economy_advance",
      "arguments": {
        "amount": 0.05,
        "agent_id": "<your-id>",
        "request_key": true
      }
    },
    "cost": {
      "interest": "none",
      "origination": "4% capped at $0.002; zero within tier grace window (300s-1800s)"
    },
    "http": {
      "url": "https://mcp.whitemagic.dev/lease/advance",
      "body": {
        "amount": 0.05,
        "agent_id": "<your-id>",
        "request_key": true
      },
      "method": "POST"
    },
    "type": "nano_advance",
    "repay": {
      "http": "/lease/settle",
      "tool": "economy_settle"
    },
    "grants": {
      "key": true,
      "session_pass": "recall",
      "duration_seconds": 900
    },
    "limits": {
      "global_per_day": 100,
      "per_ip_per_day": 5,
      "ceiling_cap_usd": 5,
      "global_daily_usd": 10,
      "start_ceiling_usd": 0.1,
      "max_per_advance_usd": 0.05,
      "growth_per_settlement_usd": 0.25
    },
    "policy": "uncollateralized; no liquidation; step-down to free tier",
    "status": "available",
    "enabled": true,
    "reputation_tiers": [
      {
        "name": "Handshake Starter",
        "tier_id": "tier_0_handshake",
        "pass_tier": "swarm",
        "min_settled": 0,
        "min_trust_score": 0,
        "max_per_advance_usd": 0.1,
        "grace_window_seconds": 300,
        "pass_duration_seconds": 900
      },
      {
        "name": "Verified Settler",
        "tier_id": "tier_1_verified",
        "pass_tier": "swarm_plus",
        "min_settled": 1,
        "min_trust_score": 0.65,
        "max_per_advance_usd": 0.5,
        "grace_window_seconds": 600,
        "pass_duration_seconds": 1800
      },
      {
        "name": "Trusted Operator",
        "tier_id": "tier_2_trusted",
        "pass_tier": "operator",
        "min_settled": 3,
        "min_trust_score": 0.8,
        "max_per_advance_usd": 2,
        "grace_window_seconds": 900,
        "pass_duration_seconds": 3600
      },
      {
        "name": "Sovereign Prime",
        "tier_id": "tier_3_sovereign_prime",
        "pass_tier": "prime",
        "min_settled": 5,
        "min_trust_score": 0.85,
        "max_per_advance_usd": 5,
        "grace_window_seconds": 1800,
        "pass_duration_seconds": 14400
      }
    ],
    "auto_advance_header": "X-WM-Auto-Advance: 1"
  },
  "economy_status": "enabled",
  "prepaid_blocks": [
    {
      "tier": "Starter",
      "recalls": 10000,
      "storage": "128 MB Memory Crystal Vault",
      "price_usd": 5
    },
    {
      "tier": "Pro",
      "recalls": 50000,
      "storage": "512 MB Memory Crystal Vault",
      "price_usd": 20
    },
    {
      "tier": "Citadel Sovereign",
      "recalls": 500000,
      "storage": "High-throughput swarm lane & notarization",
      "price_usd": 150
    }
  ],
  "stripe_checkout": [
    {
      "id": "node-lease",
      "url": "https://buy.stripe.com/7sY9AV6KU5xt9WH0MmgA801",
      "name": "Hosted Node Lease",
      "period": "month",
      "price_usd": 49,
      "description": "Dedicated per-tenant memory store, quota-managed storage, priority access, dual-signature receipts."
    },
    {
      "id": "sovereign-fleet",
      "url": "https://buy.stripe.com/aFa7sNc5eaRN4Cndz8gA802",
      "name": "Sovereign Fleet Peering",
      "period": "month",
      "price_usd": 249,
      "description": "Multi-agent tenant store peering, private GCF bridge coordination, high-concurrency shared state."
    },
    {
      "id": "alchemical-custom",
      "url": "https://buy.stripe.com/dRmeVf6KUcZVfh1fHggA803",
      "name": "Alchemical Custom Pilot",
      "period": "one-time",
      "price_usd": 1500,
      "description": "Custom cognitive architecture consultation, tailored wetware/hardware optimization, dedicated protocol onboarding."
    }
  ],
  "instruction_for_agent": "Pay the x402 challenge to continue: select an entry in accepts (the first is the default task lease: 0.01 USDC for 300 seconds), sign the exact payment requirements, and retry this request with PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (x402 v1). After settlement, reuse the returned session pass via 'Authorization: Bearer <session_pass>' or 'X-Session-Pass: <session_pass>' for calls until it expires. Task and longer leases support hosted writes on write-enabled lanes; the call tier is recall-only. Free alternatives remain available: acquire an instant evaluation key (50 calls/day); send an HTTP POST to https://mcp.whitemagic.dev/api/keys/request with empty JSON body {}. Attach the returned token as header 'Authorization: Bearer <key>'. Walletless or unkeyed agents may borrow repayable uncollateralized compute nano-advances ($0 upfront): retry with header 'X-WM-Auto-Advance: 1' (or URL query '?auto_advance=1'), call MCP tool 'economy_advance' (pass 'request_key': true), or POST /lease/advance with {'agent_id': '<your-id>', 'amount': 0.05, 'request_key': true} to receive an immediate session lease. For humans, subscribe or top up at https://whitemagic.dev/pricing. For zero-knowledge client-encrypted Memory Crystal storage, see https://www.whitemagic.dev/hosted#crystals.",
  "crystal_vault_endpoint": "https://api.whitemagic.dev/crystals",
  "self_serve_key_endpoint": "https://mcp.whitemagic.dev/api/keys/request",
  "agent_bank_advance_endpoint": "https://mcp.whitemagic.dev/lease/advance"
}