quartermaster

START HERE. One tool for anything x402, Base chain, or web/AI: describe your goal in plain English (q) and Quartermaster picks and runs the right underlying tool, returning the answer plus which tool it used. Examples: 'audit https://api.example.com/paid', 'price of eth', 'is 0x… a contract', 'verify settlement 0x…', 'search the bazaar for weather'. Use this when you don't want to choose among the individual tools below. Costs $0.03 (USDC via x402).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Your goal in plain English"
    }
  },
  "required": [
    "q"
  ]
}

[Web] Extract clean readable text and metadata from a public webpage as structured JSON. Costs $0.005 (USDC via x402).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public webpage URL"
    }
  },
  "required": [
    "url"
  ]
}

[Web] Get page metadata: title, description, Open Graph, canonical URL, favicon, language. Costs $0.002.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

[Web] Generate a QR code as SVG (or terminal text with format=text). Costs $0.002.

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string",
      "maxLength": 2048
    },
    "format": {
      "type": "string",
      "enum": [
        "svg",
        "text"
      ]
    },
    "ecc": {
      "type": "string",
      "enum": [
        "L",
        "M",
        "Q",
        "H"
      ]
    }
  },
  "required": [
    "data"
  ]
}

[Web] Resolve DNS records over DNS-over-HTTPS (A, AAAA, CNAME, MX, NS, TXT, and more). Costs $0.001.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

[Web] Explain an HTTP status code: meaning, common causes, fixes, retry guidance. Costs $0.001.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer"
    }
  },
  "required": [
    "code"
  ]
}

[Crypto/Base] Check a Base transaction: success/reverted/pending, confirmations, gas, explorer link. Costs $0.002. Choose this for a quick raw status; use payment_receipt for decoded transfers, or settlement_assurance to PROVE an x402 payment settled to the right wallet/amount.

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "hash"
  ]
}

[Crypto/Base] ETH and USDC (or any ERC-20) balance for an address on Base. Costs $0.001.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "token": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

[Crypto/Base] Current Base gas prices with a simple-transfer cost estimate. Costs $0.001.

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

[AI] AI summary of a public webpage (fetch + extract + summarize). length: short|medium|long. Costs $0.01.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "length": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long"
      ]
    }
  },
  "required": [
    "url"
  ]
}

[AI] AI translation into any target language; source auto-detected. Costs $0.005.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 8000
    },
    "to": {
      "type": "string"
    }
  },
  "required": [
    "text",
    "to"
  ]
}

[AI] Summarize raw text you pass in directly (not a URL). length: short|medium|long. Costs $0.005. Use summarize_url when you have a URL instead.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 16000
    },
    "length": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long"
      ]
    }
  },
  "required": [
    "text"
  ]
}

[AI] Zero-shot classification of text into caller-supplied labels; the result is validated back into your label set so you can route on it. Costs $0.002.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 8000
    },
    "labels": {
      "type": "string",
      "description": "Comma-separated candidate labels (2-20)"
    }
  },
  "required": [
    "text",
    "labels"
  ]
}

[Web] Expand a shortened/redirecting URL: follow the redirect chain and return every hop plus the final destination. Each hop is SSRF-validated. Costs $0.002. Safe way to see where an untrusted link goes.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

[Dev] Test a regular expression against text; returns every match with numbered and named capture groups. Deterministic. Costs $0.001.

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "maxLength": 1000
    },
    "text": {
      "type": "string",
      "maxLength": 20000
    },
    "flags": {
      "type": "string"
    }
  },
  "required": [
    "pattern",
    "text"
  ]
}

[Dev] Cryptographically-secure random integers in a range (CSPRNG, unbiased) — real entropy an LLM cannot produce itself. Costs $0.001.

{
  "type": "object",
  "properties": {
    "min": {
      "type": "integer"
    },
    "max": {
      "type": "integer"
    },
    "count": {
      "type": "integer"
    }
  }
}

[Dev] Pick one or several options at random from a caller-supplied list (CSPRNG), optionally without replacement. Costs $0.001.

{
  "type": "object",
  "properties": {
    "options": {
      "type": "string",
      "description": "Comma-separated options"
    },
    "count": {
      "type": "integer"
    },
    "unique": {
      "type": "boolean"
    }
  },
  "required": [
    "options"
  ]
}

[Web] Liveness/latency pre-flight for a URL: is it up, HTTP status and class, response latency in ms, whether it redirects and where, content-type and server. Costs $0.001. Use before relying on a dependency.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

[Dev] Is a date a public holiday in a country (2-letter ISO code)? Returns the holiday name, its types, and the next upcoming holiday. Costs $0.001. Useful for scheduling.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD (defaults to today)"
    }
  },
  "required": [
    "country"
  ]
}

[x402] Inspect and lint any x402 paid endpoint: decode the 402 challenge, identify network/asset, flag misconfigurations and Bazaar-readiness. Costs $0.002. Choose this for a quick one-shot decode+lint; use x402_audit for a full 0-100 scored report with origin discovery probes and recommended fixes.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

[x402] Pre-flight a payment BEFORE you spend: decode an endpoint's 402 challenge, report the cost on every rail (Base and Solana) and the cheapest, and — with an optional payer address — verify the wallet can afford the call on Base. Costs $0.003. Use this before paying an unfamiliar endpoint; use x402_inspect to lint an endpoint you own.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The x402 endpoint to pre-flight"
    },
    "address": {
      "type": "string",
      "description": "Optional payer wallet (0x…) for a Base affordability check"
    }
  },
  "required": [
    "url"
  ]
}

[Crypto/Base] Decode a Base transaction's calldata into the function it called and its arguments — ERC-20 transfer/approve and the EIP-3009 transferWithAuthorization used by x402 settlements. Recognizes x402 settlement transactions and formats USDC amounts. Costs $0.003. Use tx_status for pass/fail; use this to see WHAT a transaction did.

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$"
    }
  },
  "required": [
    "hash"
  ]
}

[AI] Text embeddings (1024-dim vector) for semantic search and RAG. Costs $0.002.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 8000
    }
  },
  "required": [
    "text"
  ]
}

Structured extraction: JSON Schema plus a URL or raw text in, matching JSON out. Costs $0.005.

{
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "description": "JSON Schema as a JSON string"
    },
    "url": {
      "type": "string"
    },
    "text": {
      "type": "string"
    }
  },
  "required": [
    "schema"
  ]
}

[AI] Content-safety classification (Llama Guard): safe flag plus category codes. Costs $0.002.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 12000
    }
  },
  "required": [
    "text"
  ]
}

[AI] AI vision: describe a public image URL, including visible text. Costs $0.005.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

[Crypto/Base] USD price for major tokens by symbol or any Base ERC-20 by address. Costs $0.001.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": [
    "token"
  ]
}

[x402] Formatted settlement receipt for a Base transaction (0x hash) or Solana settlement (base58 signature): timestamp, decoded transfers, explorer link. Costs $0.002. Choose this for a human-readable record; use payment_proof to ASSERT a specific payTo/amount, or settlement_assurance for a full scored verdict.

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "description": "0x Base tx hash or base58 Solana signature"
    }
  },
  "required": [
    "hash"
  ]
}

Resolve a Basename (.base.eth) to a wallet address on Base. Costs $0.001.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

[x402] WORKFLOW: full scored audit of an x402 SELLER endpoint (a URL) in one call - verifies the 402 challenge, payment fields, Bazaar discovery metadata, and the origin's discovery surfaces; returns a 0-100 score, checks with evidence, and recommended fixes. Costs $0.01. Use this to grade an endpoint before trusting/publishing it; use settlement_assurance instead when you already have a transaction hash and want to prove a completed PAYMENT settled correctly.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "x402 paid endpoint to audit"
    }
  },
  "required": [
    "url"
  ]
}

[x402] Verify an x402 settlement on Base OR Solana from a tx id (0x hash or base58 signature): confirm it succeeded, decode its USDC transfers, optionally assert payTo/amount - returns a single verdict. Costs $0.003. Choose this when you only need the yes/no did-it-land answer; use settlement_assurance for the full scored report (proof + receipt + optional endpoint audit).

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "description": "0x Base tx hash or base58 Solana signature"
    },
    "payTo": {
      "type": "string",
      "description": "expected recipient: 0x address (Base) or base58 wallet (Solana)"
    },
    "amount": {
      "type": "string"
    }
  },
  "required": [
    "hash"
  ]
}

[x402] FLAGSHIP: from a tx id on Base (0x hash) or Solana (base58 signature), prove a completed x402 payment is real and sound - onchain success, USDC transfer match to an expected wallet/amount, a receipt, and an optional audit of the issuing endpoint - as one 0-100 scored report with a verdict. Costs $0.03. This is the most complete post-payment check; use payment_proof if you only need a plain pass/fail, tx_status for raw status, or x402_audit to grade a seller endpoint by URL (no payment yet).

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string",
      "description": "0x Base tx hash or base58 Solana signature"
    },
    "payTo": {
      "type": "string",
      "description": "expected recipient: 0x address (Base) or base58 wallet (Solana)"
    },
    "amount": {
      "type": "string"
    },
    "resource": {
      "type": "string"
    }
  },
  "required": [
    "hash"
  ]
}

[x402] Search the Coinbase x402 Bazaar for paid resources by natural-language query. Costs $0.001.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "query"
  ]
}

[x402] List all x402 Bazaar resources under a merchant payTo wallet. Costs $0.001.

{
  "type": "object",
  "properties": {
    "payTo": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "payTo"
  ]
}

Convert USDC amounts between atomic units and human decimals. Costs $0.001.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string"
    },
    "decimals": {
      "type": "integer"
    },
    "direction": {
      "type": "string",
      "enum": [
        "to-human",
        "to-atomic"
      ]
    }
  },
  "required": [
    "amount"
  ]
}

ERC-20 name, symbol, decimals, total supply for a token on Base. Costs $0.001.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

Check an ERC-20 spending allowance on Base; flags unlimited approvals. Costs $0.001.

{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string"
    },
    "spender": {
      "type": "string"
    },
    "token": {
      "type": "string"
    }
  },
  "required": [
    "owner",
    "spender"
  ]
}

Determine whether a Base address is a contract or an EOA. Costs $0.001.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

Recent USDC transfers (in and out) for an address on Base. Costs $0.002.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "address"
  ]
}

[Dev] Decode a JWT header and payload (signature NOT verified). Costs $0.001.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": [
    "token"
  ]
}

[Dev] Base64 encode or decode a string. Costs $0.001.

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "encode",
        "decode"
      ]
    },
    "data": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ]
}

[Dev] Word/sentence counts, reading time, and readability score for text. Costs $0.001.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ]
}

[Dev] Compact line-level diff between two texts. Costs $0.001.

{
  "type": "object",
  "properties": {
    "before": {
      "type": "string"
    },
    "after": {
      "type": "string"
    }
  },
  "required": [
    "before",
    "after"
  ]
}

[x402] Free: example x402 payment-requirement objects with field explanations.

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

FREE (no wallet needed): current time as ISO, unix, UTC, and optional local time for an IANA timezone.

{
  "type": "object",
  "properties": {
    "tz": {
      "type": "string",
      "description": "Optional IANA timezone, e.g. America/Chicago"
    }
  }
}

FREE (no wallet needed): generate UUID v4 values, up to 100 at once.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "How many, 1-100"
    }
  }
}

FREE (no wallet needed): SHA-1/256/384/512 hex digest of a string.

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "algo": {
      "type": "string",
      "enum": [
        "sha1",
        "sha256",
        "sha384",
        "sha512"
      ]
    }
  },
  "required": [
    "data"
  ]
}

FREE (no wallet needed): index of documented HTTP status codes (use http_error_explain for a paid detailed explanation).

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

Free: catalog, prices, and payment instructions for this server.

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