--- name: quartermaster.surewhynot.app description: quartermaster.surewhynot.app exposes four independent utility skills: HTTP endpoint liveness checking, cryptographically-secure random integer generation, regex pattern matching, and current USD token price lookup. Each skill is a single-purpose tool callable via x402 micropayments on Base. There is no shared domain — the host is a general-purpose utility collection. host: quartermaster.surewhynot.app --- # quartermaster.surewhynot.app Quartermaster is a small multi-tool host serving agents that need lightweight, stateless utility operations without standing up dedicated infrastructure. It covers four distinct problem spaces: network reachability probing, secure randomness, text pattern extraction, and crypto spot pricing. It is not specialized in any single domain and does not offer streaming, historical data, or stateful workflows. ## When to use this host Use this host when an agent needs a quick, stateless HTTP liveness probe, a one-off CSPRNG integer, a regex match execution, or a current USD crypto spot price — all without provisioning dedicated services. Do not use it for continuous uptime monitoring (use a dedicated monitoring platform like UptimeRobot or Pingdom instead), historical price data or multi-chain price feeds beyond Base ERC-20 (use CoinGecko, CoinMarketCap, or DefiLlama's full API directly), random floats, UUIDs, or strings (use a general-purpose randomness API), or regex generation from natural language descriptions (use an LLM or regex-builder tool). The four skills are unrelated to each other; there is no compound domain advantage to using this host over fetching each capability from a more specialized provider. ## Capabilities ### Network Reachability Checks whether a public HTTP/HTTPS endpoint is reachable, returns its status code, latency, redirect target, and content metadata in a single call. - **`check-http-liveness`** — Performs a single GET against a public URL and returns reachability, HTTP status, status class, latency in milliseconds, redirect target, content-type, and server header. ### Cryptographic Randomness Generates one or more cryptographically-secure random integers within a caller-defined inclusive range, suitable for lotteries, sampling, or any CSPRNG-dependent decision. - **`fetch-random-integers`** — Returns one or more cryptographically-secure random integers within a caller-specified inclusive range, paid per request via x402 USDC on Base. ### Text Pattern Matching Executes a caller-supplied regular expression against a text string and returns all matches with their character positions and count. - **`test-regex-pattern`** — Tests a regular expression against a text string and returns all matches with their character indices. ### Crypto Spot Pricing Fetches the current USD spot price of a token by symbol or Base ERC-20 contract address, sourced from DefiLlama with a confidence score. - **`fetch-token-price-usd`** — Returns the current USD price of a token by symbol or Base ERC-20 contract address, sourced from DefiLlama with a confidence score. ## Workflows ### Validate Token Price Feed Endpoint *Use when an agent needs to confirm that a third-party token price API is reachable and healthy before relying on its data, then cross-check the returned price against Quartermaster's own price feed.* 1. **`check-http-liveness`** — Probe the third-party price API URL to confirm it is reachable, measure latency, and verify it returns a 2xx status before making a data request. 2. **`fetch-token-price-usd`** — Fetch the current USD price of the target token from DefiLlama via Quartermaster to use as a reference value for comparison or fallback. ### Random Sample with Regex Validation *Use when an agent needs to generate random integer values and then validate that their string representations match a required format or constraint pattern.* 1. **`fetch-random-integers`** — Generate one or more random integers within the required range. 2. **`test-regex-pattern`** — Apply a regex pattern to the string representation of the generated integers to confirm they satisfy a format constraint (e.g. digit count, range prefix). ## Skill reference ### `check-http-liveness` **HTTP Check** — Performs a single GET against a public URL and returns reachability, HTTP status, status class, latency in milliseconds, redirect target, content-type, and server header. *Use when:* Use when an agent needs to verify whether a public HTTP or HTTPS endpoint is reachable and healthy, measure its response latency, or inspect its HTTP status code and content metadata before making downstream calls. *Not for:* Do not use for monitoring continuous uptime over time or for non-HTTP protocols; use a dedicated monitoring service instead. Not suitable for URLs requiring authentication or private network access. **Inputs:** - `url` (string, required) — Public http(s) URL to check. Must be a valid URI accessible from the internet. **Returns:** Returns a JSON object with reachable, healthy, HTTP status code and class, latency_ms, redirect info, content-type, server header, and the ISO 8601 timestamp of the check. **Example:** `GET https://quartermaster.surewhynot.app/v1/http-check?url=https://example.com` --- ### `fetch-random-integers` **Random Pulse** — Returns one or more cryptographically-secure random integers within a caller-specified inclusive range, paid per request via x402 USDC on Base. *Use when:* Use when an agent needs verifiable, cryptographically-secure random integers for lotteries, sampling, dice rolls, or any randomness-dependent decision where CSPRNG provenance matters. *Not for:* Do not use for random floating-point numbers, UUIDs, or random strings; this endpoint returns integers only. Not suitable for high-frequency streaming randomness due to per-call payment overhead. **Inputs:** - `min` (integer) — Lower bound, inclusive. Defaults to 0. - `max` (integer) — Upper bound, inclusive. Defaults to 100. - `count` (integer) — Number of random integers to return, between 1 and 1000. Defaults to 1. **Returns:** Returns an object with echoed min/max/count, the CSPRNG source label, and a values array of the requested number of random integers within the specified range. **Example:** `GET https://quartermaster.surewhynot.app/v1/random?min=1&max=6&count=2` --- ### `test-regex-pattern` **Regex Forge** — Tests a regular expression against a text string and returns all matches with their character indices. *Use when:* Use when an agent needs to extract or validate substrings from text using a regex pattern and requires the exact match positions and count. *Not for:* Do not use for generating or suggesting regex patterns from a description; this endpoint only executes a pattern you already have against a given text. **Inputs:** - `pattern` (string, required) — Regular expression source to test (max 1000 chars). - `text` (string, required) — Text to match against (max 20000 chars). - `flags` (string) — Any combination of g i m s u y flags; g is always applied regardless. **Returns:** Returns matched=true, match_count=2, and a matches array with each hit's string value and character index, plus a truncated flag. **Example:** `GET https://quartermaster.surewhynot.app/v1/regex?pattern=%5Cb%5Cw%2B%40%5Cw%2B%5C.%5Cw%2B%5Cb&text=ping%20a%40b.com%20and%20c%40d.org&flags=g` --- ### `fetch-token-price-usd` **QuickPrice Token USD Price** — Returns the current USD price of a token by symbol or Base ERC-20 contract address, sourced from DefiLlama with a confidence score. *Use when:* Use when an agent needs the current USD spot price of a crypto asset (e.g. ETH, BTC, USDC, or any Base ERC-20 token) for display, calculation, or decision-making. *Not for:* Do not use for historical price data or price feeds across chains other than Base ERC-20 tokens; use a dedicated historical or multi-chain price API instead. **Inputs:** - `token` (string, required) — Token symbol (e.g. eth, btc, usdc) or Base ERC-20 contract address to look up the USD price for. **Returns:** Returns a JSON object with token symbol, price_usd as a float, as_of ISO timestamp, source (defillama), and a confidence score (0–1). **Example:** `GET https://quartermaster.surewhynot.app/v1/price?token=eth` ---