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

> Africa FX, US carrier/broker checks, OFAC name and wallet screens, load-vet pack. Paid via x402.

- name: biz.nibiashara/shelves
- version: 1.7.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 66/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/biz.nibiashara%2Fshelves
- tools: https://api.protogrid.dev/v1/servers/biz.nibiashara%2Fshelves/tools

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

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "shelves": {
      "type": "http",
      "url": "https://agents.nibiashara.biz/mcp"
    }
  }
}
```


## Trust

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

## Quality 66/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 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
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- warn `tools.annotations`: only 15 of 19 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_order (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); check_tx_insurance_ce (idempotentHint); estimate_us_nigeria_shipping (idempotentHint); …
- pass `tools.token_cost`: about 5,118 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 31 tool changes in 30 days
- fail `stability.rug_pull`: 3 tools kept their name but changed most of their description in 30 days; review before trusting them

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

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

- tools: 19, about 5,118 tokens to load them all
- tool set hash: 6962bfb3e54dc9e6812d09a858229cf8
- tools last changed: 2026-10-19T12:25:13.095Z
- badge: [![protogrid quality](https://protogrid.dev/badge/biz.nibiashara/shelves.svg)](https://protogrid.dev/servers/biz.nibiashara/shelves)
- 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-19 `prepare_us_nigeria_shipment_handoff` added
  - 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.
- 2026-10-19 `estimate_us_nigeria_shipping` added
  - 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.
- 2026-10-19 `vet_load` changed (description)
  - before: Load vet pack — authority + BASICs + broker + OFAC name. Pre-tender check: FMCSA authority and SMS BASICs (monthly snapshot) for the carrier, broker authority for broker_mc, OFAC name screen if a name is given. TENDER, HOLD or REJECT from public fields only, no fraud score. Freight carriers flag only on acute/critical violations (percentiles not public); a stale-data HOLD is labelled data-quality. Cites sources and as_of. $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.
  - after: 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.
- 2026-10-19 `vet_load` changed (description)
  - before: Load vet pack — authority + BASICs + broker + OFAC name. Single pre-tender check: FMCSA authority and SMS BASICs for the carrier (USDOT or MC), FMCSA broker authority for the broker on the load (broker_mc), plus an OFAC name screen when a legal name is passed. Verdict is TENDER, HOLD or REJECT from those public fields only — no invented fraud score. Cites FMCSA QCMobile and OFAC as_of. $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.
  - after: Load vet pack — authority + BASICs + broker + OFAC name. Pre-tender check: FMCSA authority and SMS BASICs (monthly snapshot) for the carrier, broker authority for broker_mc, OFAC name screen if a name is given. TENDER, HOLD or REJECT from public fields only, no fraud score. Freight carriers flag only on acute/critical violations (percentiles not public); a stale-data HOLD is labelled data-quality. Cites sources and as_of. $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.
- 2026-10-19 `check_carrier_basics` changed (description)
  - before: US carrier safety BASICs (FMCSA SMS). The carrier's Behavior Analysis & Safety Improvement Category (BASIC) measures from FMCSA's Safety Measurement System — unsafe driving, hours-of-service, vehicle maintenance and the rest — with intervention-threshold flags. The depth check that 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.
  - after: 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.
- 2026-10-15 `get_fx_africa_brief` changed (description)
  - before: Africa FX daily brief. Every Frankfurter official pair 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.
  - after: 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.
- 2026-10-15 `get_fx_parallel` changed (description)
  - before: Street (parallel-market) rate — USD-NGN or USD-GHS. Street rate for USD-NGN or USD-GHS: 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.
  - after: 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.
- 2026-10-15 `get_fx_official` changed (description)
  - before: Official FX rate — one African pair. Official reference rate vs USD for one of KES, NGN, GHS, 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.
  - after: 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.
- 2026-10-14 `buy_shelf_pass` changed (description)
  - before: Shelf Pass — 110 prepaid credits. One payment, 110 credits ($1.10 of calls for $0.99). 1 credit = $0.01 of list price, so a $0.10 carrier check costs 10 credits and a $0.02 sanctions screen costs 2. Valid on every data shelf priced ≤ $0.25 — FX, carrier/broker/sanctions checks, Texas CE, the load-vet pack and instant Swahili localization. Redeem with the X-SHELF-PASS header — no wallet and no payment round-trip per call, which is the point for agents that check every load or counterparty. $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.
  - after: 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.
- 2026-10-14 `localize_text` changed (description)
  - before: English ↔ Swahili localization — instant machine pass, up to 120 words. Machine localization (open translation model, run in-process) delivered in the paid response — no ticket, no email, no wait. Right for UI strings, alt text, short product copy an agent needs localized mid-run. Machine-grade output, honestly labeled: for native-quality human-reviewed copy up to 500 words, buy 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.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/biz.nibiashara%2Fshelves/changes

## Remotes

- https://agents.nibiashara.biz/mcp (streamable-http, auth none, reachable true, uptime30d 0.9745763)

## Packages

_none_

## Tools (19)

- `buy_shelf`: 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.
- `buy_shelf_pass`: 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.
- `check_broker_authority`: 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.
- `check_carrier_authority`: 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.
- `check_carrier_basics`: 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.
- `check_tx_insurance_ce`: 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.
- `check_tx_realestate_ce`: 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.
- `estimate_us_nigeria_shipping`: 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.
- `get_fx_africa_brief`: 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.
- `get_fx_official`: 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.
- `get_fx_parallel`: 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.
- `get_order`: Returns the order status; once Coinbase reports the payment COMPLETED the delivery is included.
- `get_pass_balance`: Free. Pass the token from buy_shelf_pass /shelf/shelf-pass-100.
- `list_shelves`: 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.
- `localize_text`: 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.
- `prepare_us_nigeria_shipment_handoff`: 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.
- `screen_sanctions_name`: 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.
- `screen_sanctions_wallet`: 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.
- `vet_load`: 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.