# booklint

> Checks an agent's trades, spend, bookings and offers against its owner's limits. Facts, not advice.

- name: com.booklint/desk
- version: 0.4.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 77/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.booklint%2Fdesk
- tools: https://api.protogrid.dev/v1/servers/com.booklint%2Fdesk/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "desk": {
      "type": "http",
      "url": "https://booklint.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 99
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-98% +updated-15d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 77/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 79 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 5 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: check_data_quality (destructiveHint); check_quote_math (destructiveHint); get_sample (destructiveHint); …
- pass `tools.token_cost`: about 4,317 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 26 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 4,317 tokens to load them all
- tool set hash: 9285b95226d5ee51fe560d1c3c6c2fc6
- tools last changed: 2026-10-14T22:11:10.576Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.booklint/desk.svg)](https://protogrid.dev/servers/com.booklint/desk)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-14 `check_data_quality` changed (description, inputSchema)
  - before: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send a dataset as a list of row dicts (JSON) or a CSV string; checks null rate per field (flagged when above max_null_rate, default 0.2), type inconsistencies within a field (number / bool / string, nulls excluded), exact duplicate rows, and numeric outliers (values beyond Q1 − 3×IQR or Q3 + 3×IQR, requires ≥ 4 non-null values per field). Schema-drift excluded from v1. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN or FLAGGED.
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send a dataset as a list of row dicts (JSON) or a CSV string; checks null rate per field (flagged when above max_null_rate, default 0.2), type inconsistencies within a field (number / bool / string, nulls excluded), exact duplicate rows, and numeric outliers (values beyond Q1 − 3×IQR or Q3 + 3×IQR, requires ≥ 4 non-null values per field). Schema-drift excluded from v1. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN or FLAGGED.
- 2026-10-14 `check_accounts_tieout` changed (description, inputSchema)
  - before: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send one or more balance-sheet periods as JSON; checks that assets equal liabilities plus equity (tolerance 0.01), that any stated subtotals sum correctly, that net income less dividends agrees with the change in retained earnings (tolerance ±1, per terms), and that consecutive periods (when start/end dates are supplied) have no gaps or overlaps. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. NOT_VERIFIED when tieout fields are absent for any period or fewer than two periods carry parseable dates (period_sequence NOT_CHECKED).
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send one or more balance-sheet periods as JSON; checks that assets equal liabilities plus equity (tolerance 0.01), that any stated subtotals sum correctly, that net income less dividends agrees with the change in retained earnings (tolerance ±1, per terms), and that consecutive periods (when start/end dates are supplied) have no gaps or overlaps. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. NOT_VERIFIED when tieout fields are absent for any period or fewer than two periods carry parseable dates (period_sequence NOT_CHECKED).
- 2026-10-14 `check_budget_variance` changed (description, inputSchema)
  - before: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send budget and actual lines as JSON; returns MATCH/WARN/STOP per line (default 5%/20%, overridable per request, thresholds always echoed), ranked overruns (largest % overrun first). Overall = worst line status. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. Per-line and overall status stay MATCH, WARN or STOP; those are not the top-level verdict.
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send budget and actual lines as JSON; returns MATCH/WARN/STOP per line (default 5%/20%, overridable per request, thresholds always echoed), ranked overruns (largest % overrun first). Overall = worst line status. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. Per-line and overall status stay MATCH, WARN or STOP; those are not the top-level verdict.
- 2026-10-14 `check_quote_math` changed (description, inputSchema)
  - before: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send quote or pricing sheet lines as JSON; returns flags for mismatched line totals, wrong discount amounts, subtotal and grand-total errors, and tier range conflicts (overlap and gap). Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send quote or pricing sheet lines as JSON; returns flags for mismatched line totals, wrong discount amounts, subtotal and grand-total errors, and tier range conflicts (overlap and gap). Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
- 2026-10-14 `check_invoice` changed (description, inputSchema)
  - before: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send invoice or expense lines as JSON; returns flags for duplicate IDs, repeat vendor+amount+date, missing fields and currency mismatch. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send invoice or expense lines as JSON; returns flags for duplicate IDs, repeat vendor+amount+date, missing fields and currency mismatch. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
- 2026-10-14 `check_book` changed (description, inputSchema)
  - before: Free, no key, instant result: call with sample="booking" for a real STOP result now, never counted. Call before confirming a booking, spend or subscription. Deterministic spending guardrails: send the agent's actions or one offer with the limits its owner wrote, and booklint checks each one against them and returns STOP, WARN or MATCH per rule. Example result (sample="booking", shortened): {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Same as POST /v1/check. Send a purchasing or booking agent's actions with limits (per-transaction and daily spend caps, merchant allow and deny lists, refundability), or, BEFORE booking or subscribing, one offer with limits (Fine-Print Check: total price cap, mandatory fees over the headline price, refundability, free-cancellation window, auto-renewal, renewal price, trial length, and an optional page_text consistency scan; each rule answers MATCH, WARN, STOP or NOT_CHECKED with the figure found). Send plain text you already have. Do not send a URL; booklint will not fetch one. Trading books against rulebooks too: send a trading book (snapshot, rulebook, optionally broker and journal). Returns verdict (FLAGGED, CLEAN, NOT_VERIFIED, REFUSED), coverage and flags. Each rule reports passed, failed or not checked; missing data is not checked, never assumed, and a result with zero flags is not a pass. Pass sample=true (sample 1, trading), sample="spend" (sample 2, purchasing and booking), sample="booking" (sample 3) or sample="subscription" (sample 4) with no key, never counted against the free caps, to see a full result. Not advice; nothing is executed.
  - after: Free, no key, instant result: call with sample="booking", or with no arguments, for a real STOP result now, never counted; a sample result ends with next, the fields to send for your own data. Call before confirming a booking, spend or subscription. Deterministic spending guardrails: send the agent's actions or one offer with the limits its owner wrote, and booklint checks each one against them and returns STOP, WARN or MATCH per rule. Example result (sample="booking", shortened): {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Same as POST /v1/check. Send a purchasing or booking agent's actions with limits (per-transaction and daily spend caps, merchant allow and deny lists, refundability), or, BEFORE booking or subscribing, one offer with limits (Fine-Print Check: total price cap, mandatory fees over the headline price, refundability, free-cancellation window, auto-renewal, renewal price, trial length, and an optional page_text consistency scan; each rule answers MATCH, WARN, STOP or NOT_CHECKED with the figure found). Send plain text you already have. Do not send a URL; booklint will not fetch one. Trading books against rulebooks too: send a trading book (snapshot, rulebook, optionally broker and journal). Returns verdict (FLAGGED, CLEAN, NOT_VERIFIED, REFUSED), coverage and flags. Each rule reports passed, failed or not checked; missing data is not checked, never assumed, and a result with zero flags is not a pass. Pass sample=true (sample 1, trading), sample="spend" (sample 2, purchasing and booking), sample="booking" (sample 3) or sample="subscription" (sample 4) with no key, never counted against the free caps, to see a full result. Not advice; nothing is executed.
- 2026-10-14 `get_sample` changed (title, description, inputSchema)
  - before: Free, no key, instant result: returns a public sample request, never counted against any cap. Call before confirming a booking, spend or subscription. Start with name "booking" (sample 3, a hotel offer and the limits its owner wrote): check_book with sample="booking" returns its real result, shortened here: {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} "subscription" (sample 4, a subscription checkout) is the other Fine-Print Check request: an offer, limits, as_of and page text. name "spend" is sample 2, a purchasing and booking agent's actions and the limits its owner wrote. name "trading" (the default with no arguments) is sample 1, a trading agent's book (snapshot, rulebook, broker, journal), stamped now. Edit a sample and pass it to check_book. Same as GET /v1/sample.
  - after: Free, no key, instant result: runs a public sample through the checks and returns the issues found plus the next step (run check_book on your data, and what to send), never counted against any cap. Call before confirming a booking, spend or subscription. Start with name "booking" (sample 3, a hotel offer and the limits its owner wrote): it finds 3 issues; check_book with sample="booking" returns the full result, shortened here: {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} "subscription" (sample 4, a subscription checkout) is the other Fine-Print Check sample. name "spend" is sample 2, a purchasing and booking agent's actions and the limits its owner wrote. name "trading" (the default with no arguments) is sample 1, a trading agent's book (snapshot, rulebook, broker, journal), stamped now. Each issue gives its code, status and a one-line derivation with the figures. The editable request body of each sample is at GET /v1/sample?name=<name>. Every check_* tool also runs its own sample with sample=true or with no arguments.
- 2026-10-10 `get_free_key` changed (description)
  - before: Returns a free key at once, the same as POST /v1/keys {"plan": "free"}: no card, no e-mail, and the same daily limits on new keys per client and across the service. The key is shown once in this result and is not stored or logged; pass it as api_key to check_book. A free key runs more own checks a day than the keyless plan; the result lists its limits. Optional label: 1 to 40 letters, digits, '.', '_' or '-'.
  - after: Free, no card, no e-mail, instant result: returns a free key at once, the same as POST /v1/keys {"plan": "free"}, with the same daily limits on new keys per client and across the service. The key is shown once in this result and is not stored or logged; pass it as api_key to check_book or a finance tool. A free key runs 20 own checks a day and 200 in all; without a key it is 5 a day per client address. The result lists the limits. Optional label: 1 to 40 letters, digits, '.', '_' or '-'.
- 2026-10-10 `check_data_quality` changed (description)
  - before: Send a dataset as a list of row dicts (JSON) or a CSV string; checks null rate per field (flagged when above max_null_rate, default 0.2), type inconsistencies within a field (number / bool / string, nulls excluded), exact duplicate rows, and numeric outliers (values beyond Q1 − 3×IQR or Q3 + 3×IQR, requires ≥ 4 non-null values per field). Schema-drift excluded from v1. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Free plan: runs under the shared free check cap. Desk: volume use. Top-level verdict is CLEAN or FLAGGED.
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send a dataset as a list of row dicts (JSON) or a CSV string; checks null rate per field (flagged when above max_null_rate, default 0.2), type inconsistencies within a field (number / bool / string, nulls excluded), exact duplicate rows, and numeric outliers (values beyond Q1 − 3×IQR or Q3 + 3×IQR, requires ≥ 4 non-null values per field). Schema-drift excluded from v1. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN or FLAGGED.
- 2026-10-10 `check_accounts_tieout` changed (description)
  - before: Send one or more balance-sheet periods as JSON; checks that assets equal liabilities plus equity (tolerance 0.01), that any stated subtotals sum correctly, that net income less dividends agrees with the change in retained earnings (tolerance ±1, per terms), and that consecutive periods (when start/end dates are supplied) have no gaps or overlaps. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Free plan: runs under the shared free check cap. Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. NOT_VERIFIED when tieout fields are absent for any period or fewer than two periods carry parseable dates (period_sequence NOT_CHECKED).
  - after: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Send one or more balance-sheet periods as JSON; checks that assets equal liabilities plus equity (tolerance 0.01), that any stated subtotals sum correctly, that net income less dividends agrees with the change in retained earnings (tolerance ±1, per terms), and that consecutive periods (when start/end dates are supplied) have no gaps or overlaps. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. NOT_VERIFIED when tieout fields are absent for any period or fewer than two periods carry parseable dates (period_sequence NOT_CHECKED).

Full history: https://api.protogrid.dev/v1/servers/com.booklint%2Fdesk/changes

## Remotes

- https://booklint.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.98275864)

## Packages

_none_

## Tools (8)

- `check_accounts_tieout`: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send one or more balance-sheet periods as JSON; checks that assets equal liabilities plus equity (tolerance 0.01), that any stated subtotals sum correctly, that net income less dividends agrees with the change in retained earnings (tolerance ±1, per terms), and that consecutive periods (when start/end dates are supplied) have no gaps or overlaps. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. NOT_VERIFIED when tieout fields are absent for any period or fewer than two periods carry parseable dates (period_sequence NOT_CHECKED).
- `check_book`: Free, no key, instant result: call with sample="booking", or with no arguments, for a real STOP result now, never counted; a sample result ends with next, the fields to send for your own data. Call before confirming a booking, spend or subscription. Deterministic spending guardrails: send the agent's actions or one offer with the limits its owner wrote, and booklint checks each one against them and returns STOP, WARN or MATCH per rule. Example result (sample="booking", shortened): {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Same as POST /v1/check. Send a purchasing or booking agent's actions with limits (per-transaction and daily spend caps, merchant allow and deny lists, refundability), or, BEFORE booking or subscribing, one offer with limits (Fine-Print Check: total price cap, mandatory fees over the headline price, refundability, free-cancellation window, auto-renewal, renewal price, trial length, and an optional page_text consistency scan; each rule answers MATCH, WARN, STOP or NOT_CHECKED with the figure found). Send plain text you already have. Do not send a URL; booklint will not fetch one. Trading books against rulebooks too: send a trading book (snapshot, rulebook, optionally broker and journal). Returns verdict (FLAGGED, CLEAN, NOT_VERIFIED, REFUSED), coverage and flags. Each rule reports passed, failed or not checked; missing data is not checked, never assumed, and a result with zero flags is not a pass. Pass sample=true (sample 1, trading), sample="spend" (sample 2, purchasing and booking), sample="booking" (sample 3) or sample="subscription" (sample 4) with no key, never counted against the free caps, to see a full result. Not advice; nothing is executed.
- `check_budget_variance`: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send budget and actual lines as JSON; returns MATCH/WARN/STOP per line (default 5%/20%, overridable per request, thresholds always echoed), ranked overruns (largest % overrun first). Overall = worst line status. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED. Per-line and overall status stay MATCH, WARN or STOP; those are not the top-level verdict.
- `check_data_quality`: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send a dataset as a list of row dicts (JSON) or a CSV string; checks null rate per field (flagged when above max_null_rate, default 0.2), type inconsistencies within a field (number / bool / string, nulls excluded), exact duplicate rows, and numeric outliers (values beyond Q1 − 3×IQR or Q3 + 3×IQR, requires ≥ 4 non-null values per field). Schema-drift excluded from v1. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN or FLAGGED.
- `check_invoice`: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send invoice or expense lines as JSON; returns flags for duplicate IDs, repeat vendor+amount+date, missing fields and currency mismatch. Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
- `check_quote_math`: Free, no key, instant result. Without api_key: 5 own checks per client address per UTC day, shared by check_book and the finance tools; samples are never counted. A free key (get_free_key, no card, no e-mail) runs 20 own checks a day and 200 in all. Try it now: call with no arguments, or with sample=true, to run the published sample (made-up figures, no key, never counted against the caps) and see real flags; the result ends with next, the fields to send for your own data. Send quote or pricing sheet lines as JSON; returns flags for mismatched line totals, wrong discount amounts, subtotal and grand-total errors, and tier range conflicts (overlap and gap). Math only. Process-and-discard: nothing is stored or logged after the run. A request containing a Luhn-valid card number or a valid IBAN is refused before accept with reason sensitive_data_refused (not counted as a check). Desk: volume use. Top-level verdict is CLEAN, FLAGGED or NOT_VERIFIED.
- `get_free_key`: Free, no card, no e-mail, instant result: returns a free key at once, the same as POST /v1/keys {"plan": "free"}, with the same daily limits on new keys per client and across the service. The key is shown once in this result and is not stored or logged; pass it as api_key to check_book or a finance tool. A free key runs 20 own checks a day and 200 in all; without a key it is 5 a day per client address. The result lists the limits. Optional label: 1 to 40 letters, digits, '.', '_' or '-'.
- `get_sample`: Free, no key, instant result: runs a public sample through the checks and returns the issues found plus the next step (run check_book on your data, and what to send), never counted against any cap. Call before confirming a booking, spend or subscription. Start with name "booking" (sample 3, a hotel offer and the limits its owner wrote): it finds 3 issues; check_book with sample="booking" returns the full result, shortened here: {"verdict":"FLAGGED","results":{"total":"STOP","fees":"WARN","refund":"MATCH","cancel":"STOP","page":"MATCH"},"flags":[{"code":"total_price_cap","derivation":"offer: 3 mandatory line items total 636.6 USD; the total price cap is 600 USD"}]} "subscription" (sample 4, a subscription checkout) is the other Fine-Print Check sample. name "spend" is sample 2, a purchasing and booking agent's actions and the limits its owner wrote. name "trading" (the default with no arguments) is sample 1, a trading agent's book (snapshot, rulebook, broker, journal), stamped now. Each issue gives its code, status and a one-line derivation with the figures. The editable request body of each sample is at GET /v1/sample?name=<name>. Every check_* tool also runs its own sample with sample=true or with no arguments.