Claim a diaspora business listing — agent-first
Claim a Ni Biashara registry listing for its owner in one call: the settled $0.10 payment and payer wallet are the proof — no email, no human click. The listing stands at the CLAIMED tier; delivery returns the page URL, the agent-readiness report, and the shelves config block. Idempotent by listing + wallet; first claim wins. A human owner can override anytime via hello@nibiashara.biz.
$0.10 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.
Parameters
| param | description |
|---|---|
id | registry listing id (required) |
Call it (any x402 client)
# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://agents.nibiashara.biz/shelf/diaspora-business-claim?id="
# 2. Sign the payment (EIP-3009 transferWithAuthorization, gasless) and retry
# with the PAYMENT-SIGNATURE header → response body is the delivery.
With the official JS client the whole flow is one wrapped fetch:
import { wrapFetchWithPayment } from "@x402/fetch"; // npm i @x402/fetch @x402/evm
const fetchPaid = wrapFetchWithPayment(fetch, { /* your EVM signer */ });
const res = await fetchPaid("https://agents.nibiashara.biz/shelf/diaspora-business-claim?id=");
const data = await res.json();
Or install the MCP server (https://agents.nibiashara.biz/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.
Example response (illustrative shape, not a live rate)
{
"shelf": "diaspora-business-claim",
"listing_id": "metro-food-hyattsville",
"business_name": "Metro Food",
"claim": {
"state": "CLAIMED",
"tier": "claimed",
"verified": false,
"source": "agent",
"payer_wallet": "0x0000000000000000000000000000000000000000",
"tx": "0x0000000000000000000000000000000000000000000000000000000000000000",
"claimed_at": "2026-11-20T12:00:00.000Z",
"already_claimed": false
},
"page_url": "https://nibiashara.com/b/metro-food-hyattsville/",
"api_url": "https://nibiashara.com/api/v1/businesses/metro-food-hyattsville.json",
"readiness_report": {
"verdict": "VERIFIED",
"verification": {
"verified": true,
"website_status": "verified",
"basis": "Ni Biashara verification pass — business confirmed open and reachable; status 'verified_business' recorded in the platform's business status store on 2026-11-17.",
"checked_at": "2026-11-17"
},
"channels": {
"website": true,
"phone": true,
"instagram": false,
"facebook": false
},
"claim_open": false,
"gaps": [
"no instagram on file",
"no facebook on file"
]
},
"shelves_config": {
"mcpServers": {
"ni-biashara-shelves": {
"type": "streamable-http",
"url": "https://agents.nibiashara.biz/mcp"
}
},
"catalog_url": "https://agents.nibiashara.biz/catalog",
"server_card": "https://agents.nibiashara.biz/.well-known/mcp/server-card.json"
},
"disputes": "A human owner can override this claim at any time via hello@nibiashara.biz. A human-confirmed claim supersedes an agent claim.",
"source": "Ni Biashara diaspora business registry (nibiashara.com directory data) — public business listing data, human-reviewed at intake",
"as_of": "2026-11-20",
"illustrative": true
}
Delivers
JSON { claim { state, tier, source, payer_wallet, claimed_at, already_claimed }, page_url, api_url, readiness_report, shelves_config, disputes, source, as_of }