Ni Biashara Shelves — Africa FX, freight & compliance checks (x402)

Data shelves (default) with price in USD, params, job-tool name and x402 URL. Pass kind=service or kind=all to include owner-fulfilled work. Free to call.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "data",
        "service",
        "all"
      ],
      "description": "defaults to data"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a Coinbase checkout for any SKU — use this when no job-named tool exists. Returns x402_url (pay with any x402 client), pay_url (human) and claim_url. Does not move money itself.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Shelf SKU to buy (required) — any id from list_shelves, e.g. fx-official, load-vet-pack, nb-landing-page"
    },
    "pair": {
      "type": "string",
      "description": "e.g. USD-KES; required for pair shelves"
    },
    "brief": {
      "type": "string",
      "description": "service shelves: what you need"
    },
    "contact": {
      "type": "string",
      "description": "service shelves: delivery email"
    },
    "dot": {
      "type": "string",
      "description": "USDOT number — carrier-authority-check, carrier-safety-basics, load-vet-pack"
    },
    "mc": {
      "type": "string",
      "description": "MC/docket number — carrier-authority-check, broker-authority-check, load-vet-pack"
    },
    "broker_mc": {
      "type": "string",
      "description": "Broker MC/docket number — load-vet-pack (runs the broker-authority check)"
    },
    "name": {
      "type": "string",
      "description": "Legal name to screen — sanctions-screen (required there); optional OFAC screen on load-vet-pack"
    },
    "address": {
      "type": "string",
      "description": "Digital currency address to exact-match — sanctions-wallet-screen"
    },
    "license_line": {
      "type": "string",
      "description": "Texas insurance (TDI) license line — tx-insurance-ce-check: general_lines_life_accident_health_hmo | general_lines_property_casualty | personal_lines_property_casualty | limited_lines | public_adjuster | all_lines_adjuster"
    },
    "license_type": {
      "type": "string",
      "description": "Texas real-estate (TREC) license type — tx-realestate-ce-check: sales_agent | broker | broker_associate | inspector"
    },
    "years_licensed": {
      "type": "string",
      "description": "Years licensed, integer 0-40 — tx-insurance-ce-check (default 2)"
    },
    "first_time": {
      "type": "string",
      "description": "true|false — first renewal? tx-realestate-ce-check (default false)"
    },
    "source_url": {
      "type": "string",
      "description": "HTTPS URL of a billing export, CSV/JSON up to 10MB — cloud-spend-report"
    },
    "text": {
      "type": "string",
      "description": "Text to localize, up to 120 words — swahili-localization-instant"
    },
    "direction": {
      "type": "string",
      "description": "en-sw or sw-en — swahili-localization-instant (default en-sw)"
    }
  },
  "required": [
    "sku"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the order status; once Coinbase reports the payment COMPLETED the delivery is included.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string"
    }
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Pass the token from buy_shelf_pass /shelf/shelf-pass-100.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "pass_… token"
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

US carrier authority & safety check (FMCSA). Live federal FMCSA record for a US motor carrier: legal name, operating status (allowed to operate), authority, safety rating, fleet size, crash and inspection summary — with plain risk flags. The check a freight-broker or dispatch agent runs before tendering a load. $0.1 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "description": "USDOT number (this or mc required)"
    },
    "mc": {
      "type": "string",
      "description": "MC/docket number (this or dot required)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

US carrier safety BASICs (FMCSA SMS). The carrier's BASIC measures from FMCSA's Safety Measurement System (unsafe driving, hours-of-service, vehicle maintenance and more) from the monthly public snapshot. All carriers get measures and acute/critical flags; percentiles and threshold alerts are public only for passenger carriers, null for freight carriers. Complements carrier-authority-check. $0.1 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "description": "USDOT number (required)"
    }
  },
  "required": [
    "dot"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

US freight broker authority check (FMCSA). Is this broker real and allowed to arrange freight? Live FMCSA record by MC/docket number with broker-authority status and plain flags. The check a carrier or factoring agent runs before accepting a load from an unknown broker. $0.1 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "mc": {
      "type": "string",
      "description": "MC/docket number (required)"
    }
  },
  "required": [
    "mc"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Load vet pack — authority + BASICs + broker + OFAC name. Pre-tender check: FMCSA authority and SMS BASICs (monthly) for the carrier, broker authority for broker_mc, optional OFAC name screen. TENDER/HOLD/REJECT from public fields only, no fraud score. A section that times out returns status "timeout" with partial:true and a HOLD verdict; full price applies when carrier authority (broker, for a broker-only pack) is delivered. $0.25 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "dot": {
      "type": "string",
      "description": "carrier USDOT number (optional; give dot, mc or broker_mc)"
    },
    "mc": {
      "type": "string",
      "description": "carrier MC/docket number (optional; give dot, mc or broker_mc)"
    },
    "broker_mc": {
      "type": "string",
      "description": "broker MC/docket number — runs the FMCSA broker-authority check (optional)"
    },
    "name": {
      "type": "string",
      "description": "legal name to OFAC-screen (optional)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sanctions name screen — OFAC SDN + Consolidated (US). Screens a company or entity name against the U.S. Treasury OFAC Specially Designated Nationals and Consolidated lists (~40k names + aliases; every result carries as_of and checked_at). Deterministic normalized-name and token matching with a CLEAR / REVIEW / HIT verdict. $0.02 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "person or entity name to screen (required)"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sanctions wallet screen — OFAC Digital Currency Address. Exact-match a blockchain address against Digital Currency Address identifiers published in the OFAC SDN XML (the same Treasury list we ingest for name screens). CLEAR or HIT. No third-party chain intel, no clustering, no risk score. $0.01 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "digital currency address to exact-match (required)"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Official FX rate — one African pair. Official forex reference rate vs USD for one African currency: KES (Kenyan shilling), NGN (naira), GHS (cedi), TZS, UGX, ZAR, EGP, RWF, via Frankfurter (frankfurter.dev). Frankfurter blends published central-bank reference rates; the number is that blend, not a single central-bank fixing. Each response names the source and carries as_of (Frankfurter's rate date) and fetched_at. Price $0.01 USDC on Base (the /shelf/fx-official price). With a valid Shelf Pass (pass_token or X-SHELF-PASS) on a shelf priced ≤ $0.25, this returns the data. Otherwise it returns payment_required with the x402 v2 URL and header name. It does not return the rate as a bare payment link.

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "description": "e.g. USD-KES (required)"
    },
    "pass_token": {
      "type": "string",
      "description": "Shelf Pass token (pass_…). On an eligible shelf the tool returns the data and spends credits. Above the pass ceiling the token is not spent."
    }
  },
  "required": [
    "pair"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Street (parallel-market) rate — USD-NGN or USD-GHS. Parallel/street exchange rate for USD-NGN (naira) or USD-GHS (cedi): the median VWAP of Bybit's public USDT/fiat P2P order book, divided by a USDT/USD spot basis, plus the Frankfurter official reference rate and the spread. OKX is archived and does not set the price. Not a central-bank rate and not a bureau de change quote. Price $0.05 USDC on Base (the /shelf/fx-parallel price). With a valid Shelf Pass (pass_token or X-SHELF-PASS) on a shelf priced ≤ $0.25, this returns the data. Otherwise it returns payment_required with the x402 v2 URL and header name. It does not return the rate as a bare payment link.

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "description": "USD-NGN or USD-GHS (required)"
    },
    "pass_token": {
      "type": "string",
      "description": "Shelf Pass token (pass_…). On an eligible shelf the tool returns the data and spends credits. Above the pass ceiling the token is not spent."
    }
  },
  "required": [
    "pair"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Africa FX daily brief. Every Frankfurter official African forex pair (shilling, naira, cedi, rand and more) plus both Bybit-derived street quotes (USD-NGN and USD-GHS) and their spreads, each row carrying its source and time. One call for a morning pricing check. Price $0.5 USDC on Base (the /shelf/fx-africa-daily-brief price). With a valid Shelf Pass (pass_token or X-SHELF-PASS) on a shelf priced ≤ $0.25, this returns the data. Otherwise it returns payment_required with the x402 v2 URL and header name. It does not return the rate as a bare payment link.

{
  "type": "object",
  "properties": {
    "pass_token": {
      "type": "string",
      "description": "Shelf Pass token (pass_…). On an eligible shelf the tool returns the data and spends credits. Above the pass ceiling the token is not spent."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

English ↔ Swahili localization — instant machine pass, up to 120 words. Machine localization (open translation model, run in-process), returned in the paid response with no ticket or wait. Suited to UI strings, alt text and short product copy. Machine-grade output, labeled as such. Human-reviewed copy up to 500 words is a separate shelf, swahili-localization-500w. $0.25 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "the text to localize, up to 120 words (required)"
    },
    "direction": {
      "type": "string",
      "description": "en-sw or sw-en (optional, default en-sw)"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Texas insurance license CE & renewal check (TDI). Deterministic TDI rules: exactly what a Texas insurance licensee needs to stay compliant — CE hours, classroom/ethics requirements, renewal fees — by license line and years licensed. Rules-engine output, not an LLM guess. $0.25 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "license_line": {
      "type": "string",
      "description": "one of general_lines_life_accident_health_hmo | general_lines_property_casualty | personal_lines_property_casualty | limited_lines | public_adjuster | all_lines_adjuster (required)"
    },
    "years_licensed": {
      "type": "string",
      "description": "integer 0-40 (default 2)"
    }
  },
  "required": [
    "license_line",
    "years_licensed"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Texas real-estate license CE & renewal check (TREC). Deterministic TREC rules: continuing-education hours, renewal fees and active-license requirements for Texas real-estate licensees, by license type. Rules-engine output, not an LLM guess. $0.25 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {
    "license_type": {
      "type": "string",
      "description": "one of sales_agent | broker | broker_associate | inspector (required)"
    },
    "first_time": {
      "type": "string",
      "description": "true|false (default false)"
    }
  },
  "required": [
    "license_type",
    "first_time"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Shelf Pass — 110 prepaid credits. 110 prepaid credits for $0.99 ($1.10 of calls). 1 credit = $0.01 of list price: a $0.10 carrier check uses 10 credits, a $0.02 sanctions screen uses 2. Valid on data shelves priced at $0.25 or less (FX, carrier, broker and sanctions checks, Texas CE, the load-vet pack, instant Swahili localization). The pass token travels in the X-SHELF-PASS header, so a call needs no separate wallet payment. $0.99 USDC on Base. Returns the x402 URL to GET (402 → PAYMENT-SIGNATURE → delivery). Free to call this tool; payment happens on the URL.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. Floor estimate for an air shipment from Doos Logistics' Fort Worth, TX hub to Lagos, built only from Doos's published rates; unpublished charges are listed, never guessed. Prohibited and restricted items (liquid, perishable, hazmat) get no price: the result is estimate_available:false with a reason (prohibited_item or restricted_item). Ocean not offered. Links to book and pay Doos directly for priced items. Independent estimate from Ni Biashara LLC. Not affiliated with Doos Logistics. You book and pay Doos Logistics directly. Estimates from Doos's public rates retrieved 2026-10-19. No payment: this tool returns the estimate itself.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "maxLength": 120,
      "description": "US (required)"
    },
    "destination": {
      "type": "string",
      "maxLength": 120,
      "description": "NG (required)"
    },
    "mode": {
      "type": "string",
      "maxLength": 120,
      "description": "air (required; ocean is not offered yet)"
    },
    "weight": {
      "type": "string",
      "maxLength": 120,
      "description": "number > 0 and ≤ 2000 (required)"
    },
    "weight_unit": {
      "type": "string",
      "maxLength": 120,
      "description": "lb or kg (optional, default lb)"
    },
    "length": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional; any side over 24 in triggers Doos's unpublished volume charge)"
    },
    "width": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional)"
    },
    "height": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional)"
    },
    "item_category": {
      "type": "string",
      "maxLength": 120,
      "description": "general | phone_used | phone_new | laptop_used | laptop_new | fragile | battery | liquid | perishable | hazmat | nicotine | ammunition (required)"
    },
    "device_count": {
      "type": "string",
      "maxLength": 120,
      "description": "integer 1-99 for phones/laptops (optional, default 1)"
    },
    "declared_value_usd": {
      "type": "string",
      "maxLength": 120,
      "description": "number (optional; used for the insurance note and EEI flag)"
    },
    "delivery": {
      "type": "string",
      "maxLength": 120,
      "description": "lagos_office | lagos_home | other_state_home (optional, default lagos_office)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free. POST the shipment and both names. We run an OFAC name screen and refuse prohibited items and hazmat (400). Restricted items (liquid, perishable) need Doos's approval first: they get 200 with status ask_doos_first, a restricted notice, no price and no booking links. Otherwise we return the estimate, Doos's proof-of-purchase checklist, a summary to give Doos and Doos's booking links (status ready_for_doos). You book and pay Doos directly; we never book or take payment. Independent estimate from Ni Biashara LLC. Not affiliated with Doos Logistics. You book and pay Doos Logistics directly. Estimates from Doos's public rates retrieved 2026-10-19. No payment: this tool returns the handoff itself.

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "maxLength": 120,
      "description": "US (required)"
    },
    "destination": {
      "type": "string",
      "maxLength": 120,
      "description": "NG (required)"
    },
    "mode": {
      "type": "string",
      "maxLength": 120,
      "description": "air (required; ocean is not offered yet)"
    },
    "weight": {
      "type": "string",
      "maxLength": 120,
      "description": "number > 0 and ≤ 2000 (required)"
    },
    "weight_unit": {
      "type": "string",
      "maxLength": 120,
      "description": "lb or kg (optional, default lb)"
    },
    "length": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional; any side over 24 in triggers Doos's unpublished volume charge)"
    },
    "width": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional)"
    },
    "height": {
      "type": "string",
      "maxLength": 120,
      "description": "inches (optional)"
    },
    "item_category": {
      "type": "string",
      "maxLength": 120,
      "description": "general | phone_used | phone_new | laptop_used | laptop_new | fragile | battery | liquid | perishable | hazmat | nicotine | ammunition (required)"
    },
    "device_count": {
      "type": "string",
      "maxLength": 120,
      "description": "integer 1-99 for phones/laptops (optional, default 1)"
    },
    "declared_value_usd": {
      "type": "string",
      "maxLength": 120,
      "description": "number (optional; used for the insurance note and EEI flag)"
    },
    "delivery": {
      "type": "string",
      "maxLength": 120,
      "description": "lagos_office | lagos_home | other_state_home (optional, default lagos_office)"
    },
    "sender_name": {
      "type": "string",
      "maxLength": 120,
      "description": "sender's full name, 2-120 characters, OFAC-screened, POST body only (required)"
    },
    "receiver_name": {
      "type": "string",
      "maxLength": 120,
      "description": "receiver's full name, 2-120 characters, OFAC-screened, POST body only (required)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}