@nibiashara/shelves

Pay-per-call APIs for AI agents — no API key, no signup, no subscription.

US freight checks (FMCSA carrier authority, safety BASICs, broker authority), OFAC sanctions screening, and African FX rates (official + street/parallel). Your agent pays per call in USDC on Base over the x402 protocol, or spends credits from a prepaid pass.

Full docs: https://agents.nibiashara.biz/docs

npm i @nibiashara/shelves

Use a pass (simplest — no wallet needed)

One $0.99 pass carries 100 credits, good on every shelf priced ≤ $0.10.

import { Shelves } from "@nibiashara/shelves";

const shelves = new Shelves({ pass: process.env.SHELF_PASS });

// Should we tender this load?
const carrier = await shelves.carrierAuthority({ dot: "44110" });
if (carrier.verdict !== "CLEAR") console.log("hold:", carrier.flags);

// Is this counterparty sanctioned?
const screen = await shelves.sanctionsScreen({ name: "Example Trading Co" });
// screen.verdict === "CLEAR" | "REVIEW" | "HIT"

console.log(await shelves.creditsRemaining()); // 98

Related MCP server: dyoe-agent-tools-mcp

Or pay per call with a wallet

Bring any x402-capable fetch (e.g. @x402/fetch + @x402/evm) and the client uses it — each call settles its own micro-payment.

import { wrapFetchWithPayment } from "@x402/fetch";
import { Shelves } from "@nibiashara/shelves";

const shelves = new Shelves({ fetch: wrapFetchWithPayment(fetch, signer) });
const rate = await shelves.fxParallel({ pair: "USD-NGN" });

Shelves

Verdicts are deterministic rules-engine output, never an LLM guess. Sanctions data is refreshed daily from the U.S. Treasury OFAC list service; FMCSA data is fetched live per call.

Also available as

• MCP server — https://agents.nibiashara.biz/mcp (registry id biz.nibiashara/shelves)

• Google A2A agent — card at /.well-known/agent-card.json, JSON-RPC at /a2a

• OpenAPI — /openapi.json, with x-payment-info on every route

Notes

Screening and authority checks are decision aids, not legal advice. Confirm identity (DOB, address, ID numbers) before acting on a sanctions match, and verify insurance and surety bonds before tendering freight.

MIT © Ni Biashara LLC