# Ni Biashara Shelves auth.md

How AI agents get access to Ni Biashara Shelves (https://agents.nibiashara.biz). There is no OAuth server and no account to register: nothing here issues OAuth tokens.

## Audience

AI agents and the developers who run them, buying structured data and business services per call.

## No credentials needed

Discovery is free and open: `/`, `/catalog`, `/openapi.json`, `/llms.txt`, `/docs`, `/.well-known/x402`, `/.well-known/agent-card.json`, `/mcp.json`, `/.well-known/api-catalog`.

Free tools (no payment, not x402):
- `GET https://agents.nibiashara.biz/free/shipping-estimate-us-ng` (MCP tool `estimate_us_nigeria_shipping`)
- `POST https://agents.nibiashara.biz/free/shipping-handoff-us-ng` (MCP tool `prepare_us_nigeria_shipment_handoff`)
- `GET https://agents.nibiashara.biz/free/diaspora-business-listing` (MCP tool `check_diaspora_business_listing`)

## Paying per call: x402 (no registration)

- Method: x402 v2, scheme `exact`, USDC on Base (`eip155:8453`), settled through the Coinbase CDP facilitator.
- Flow: `GET https://agents.nibiashara.biz/shelf/<sku>` returns HTTP 402 with a `PAYMENT-REQUIRED` header. Sign the payment and retry with `PAYMENT-SIGNATURE`; the response carries the data and a `PAYMENT-RESPONSE` header.
- Legacy x402 v1 routes (`/api/fx`, `/api/fx/:pair`, `/api/parallel/:pair`) also accept `X-PAYMENT`.
- Prices per shelf: `https://agents.nibiashara.biz/catalog`. The wallet is the credential; there is no API key.

## Prepaid credits: Shelf Pass

- Credential type: Shelf Pass token (prepaid call credits).
- Get one: buy the `shelf-pass-100` shelf over x402, or pay by card at `https://agents.nibiashara.biz/card-pass` (Stripe Checkout; the token is shown once on the success page).
- Use: send it as the `X-SHELF-PASS` request header on `/shelf/<sku>` or `/mcp`. Credits cover data shelves priced up to $0.25; balance at `/pass/<token>`.

## MCP and A2A

- MCP (Streamable HTTP): `POST https://agents.nibiashara.biz/mcp`. Paid tools return `payment_required` (x402 v2 terms) unless an `X-SHELF-PASS` header is sent. Card: `/.well-known/mcp/server-card.json`.
- A2A JSON-RPC: `POST https://agents.nibiashara.biz/a2a` with the a2a-x402 payments extension. Card: `/.well-known/agent-card.json`.

## Partner channels

Marketplace partners get a channel key from Ni Biashara by agreement. Those keys are not self-serve.

## Contact

twe@nibiashara.biz