Agoranome seller tools
Get your x402 API found and bought: lint, Bazaar rank, buyer panel, demand gaps. Paid in USDC.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"agoranome": {
"url": "https://api.agoranome.com/mcp"
}
}
}Remote endpoints
https://api.agoranome.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (27)
🟢lint_listing(url)
Why isn't my x402 API in the Bazaar? Listing lint checks an x402 endpoint for Bazaar indexing: one unpaid call validates its 402 PAYMENT-REQUIRED header, discovery metadata, input and output schemas, description limits and service name against the indexing rules, with a fix for each problem and the fixed 402 ready to paste, graded as the weekly report card would grade it. Also lints A2A agent cards. Use when an agent needs to lint an x402 listing or A2A agent card before its first sale. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of the paid endpoint, or of an A2A agent card (/.well-known/agent-card.json)",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "lint_listingArguments"
}🟢conformance_check(url)
402 conformance and security check for an x402, MPP or A2A API: can buyer agents' SDKs pay it, and is it safe to pay? Checks the x402 requirements (amounts, addresses, EIP-712 domain, the same terms each time), that malformed and forged payments are refused, pay-to binding, MPP challenges, and the price against the Bazaar and openapi.json. Given an A2A agent card, it checks the a2a-x402 task flow. At 5 cents or less, one paid call also checks replay, mutation and no-store. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of the paid endpoint, or of an A2A agent card (/.well-known/agent-card.json)",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "conformance_checkArguments"
}🟢rank_check(task, resource, network)
Where does my x402 API rank in Bazaar search? Rank check runs the search a buyer agent would run for your task and returns your rank, the listings ahead of you, the signals where you trail them (payers, calls, description, example, schema, price), what the three winners' descriptions say that yours doesn't, and your share of voice across the buyer searches of your category. Search rank and competitor analysis for x402 listings. A three-result sample is free at /v1/seller/rank/sample. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"task": {
"description": "What a buyer agent is searching for",
"maxLength": 400,
"minLength": 3,
"title": "Task",
"type": "string"
},
"resource": {
"description": "Your listed resource URL",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
},
"network": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional CAIP-2 network filter",
"title": "Network"
}
},
"required": [
"task",
"resource"
],
"title": "rank_checkArguments"
}🟢buyer_panel(resource, tasks)
Will buyer agents choose my x402 API? The Machine Buyer Panel is an A/B conversion test: buyer-agent models choose between your offer and its real Bazaar rivals for up to three tasks, across buyer personas and list positions. Returns your win rate with confidence intervals (position-corrected too), why you lost, up to three truthful edits tested on the same trials, and the proof arm: whether a Fair Offer block or an attested sample lifts your pick rate. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"resource": {
"description": "Your resource URL",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
},
"tasks": {
"description": "One to three tasks, as a buyer agent would phrase them",
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"title": "Tasks",
"type": "array"
}
},
"required": [
"resource",
"tasks"
],
"title": "buyer_panelArguments"
}🟢buyer_panel_one(resource, task)
Will buyer agents pick my x402 API for one task? The single-task panel is the Machine Buyer Panel for buyers under a dollar cap: buyer-agent models choose between your offer and its real Bazaar rivals for one task, across personas and list positions. Returns your win rate with confidence intervals, why you lost, and the proof arm (does a Fair Offer block or an attested sample lift your pick rate). No drafted edits; the full panel tests those. Price: $0.25 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"resource": {
"description": "Your resource URL",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
},
"task": {
"description": "One task, as a buyer agent would phrase it",
"maxLength": 400,
"minLength": 3,
"title": "Task",
"type": "string"
}
},
"required": [
"resource",
"task"
],
"title": "buyer_panel_oneArguments"
}🟢signed_sample(sample, resource)
Trust proof for an x402 seller: a signed attestation of your API's sample output, so buyer agents can check it before paying. Agoranome fetches a free sample from your endpoint's host, checks that your paid route on the same host answers with an x402 offer, and signs an attestation of what it saw and when: the sample's SHA-256 and body, and the offer's price, network and pay-to. Buyers check it at a public URL. Price: $0.05 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"sample": {
"description": "Public https URL that returns a sample output without payment",
"maxLength": 2048,
"minLength": 10,
"title": "Sample",
"type": "string"
},
"resource": {
"description": "Your paid x402 endpoint, on the same host as the sample",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
}
},
"required": [
"sample",
"resource"
],
"title": "signed_sampleArguments"
}🟢demand_gaps(topic)
What x402 API should I build? The demand gap finder runs up to 150 Bazaar searches phrased the way buyer agents phrase tasks and ranks the unmet demand: tasks whose top results are weak (no listings, few payers, thin descriptions or a poor fit), with the evidence for each, a spec per gap (an OpenAPI skeleton, a Fair Offer block and a price from the category price index) and the gap's trend week over week. Public Bazaar data only, joined with measured repeat demand per category. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"topic": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "A topic or category to search around; every category if omitted",
"title": "Topic"
}
},
"title": "demand_gapsArguments"
}🟢payer_analytics(address, days)
Who pays my x402 API, and do they come back? Customer analytics for an x402 seller from USDC payments on Base: repeat buyers versus one-off and sweep-like payers, revenue per payer and weekly retention cohorts. Use when an agent needs payer analytics for a pay-to address. Agoranome pledges 15% of settled revenue to a cause, verifiable at /impact/ledger. Price: $0.05 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"address": {
"description": "Seller pay-to address on Base",
"pattern": "^0x[0-9a-fA-F]{40}$",
"title": "Address",
"type": "string"
},
"days": {
"default": 7,
"description": "Days to look back",
"maximum": 30,
"minimum": 1,
"title": "Days",
"type": "integer"
}
},
"required": [
"address"
],
"title": "payer_analyticsArguments"
}🟢weekly_insights(week)
What are agents buying on x402? A weekly x402 market data and demand report from Bazaar discovery and Base settlements: repeat-use demand by category, demand gaps, movers, price bands and GET vs POST traction, adjusted for sweeps, with cited sources. Use when an agent needs x402 demand by category before choosing what to build or how to price it. Price: $0.25 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"week": {
"anyOf": [
{
"pattern": "^\\d{4}-W\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO week; latest if omitted",
"title": "Week"
}
},
"title": "weekly_insightsArguments"
}🟢model_watch(resource, tasks, notify)
Will a new AI model stop buying my x402 API? The model-update watch tests your offer against its real Bazaar rivals with the Machine Buyer Panel now, then re-runs the same test whenever a panel model changes over the next 30 days and flags a drop in your win rate. One payment, no renewal. Status is free at the watch URL; an optional https webhook gets each result. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"resource": {
"description": "Your resource URL",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
},
"tasks": {
"description": "One to three tasks, as a buyer agent would phrase them",
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"title": "Tasks",
"type": "array"
},
"notify": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional https webhook for each result",
"title": "Notify"
}
},
"required": [
"resource",
"tasks"
],
"title": "model_watchArguments"
}🟢rank_watch(task, resource, network, notify)
Is my x402 API losing rank in Bazaar search? The rank watch runs the rank check for your task now, then again every week for 30 days, and alerts you when your rank drops, you fall out of the results, or your share of voice across your category's buyer searches shrinks. One payment, no renewal. Status is free at the watch URL; an optional https webhook gets each drop. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"task": {
"description": "What a buyer agent is searching for",
"maxLength": 400,
"minLength": 3,
"title": "Task",
"type": "string"
},
"resource": {
"description": "Your listed resource URL",
"maxLength": 2048,
"minLength": 10,
"title": "Resource",
"type": "string"
},
"network": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional CAIP-2 network filter",
"title": "Network"
},
"notify": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional https webhook for each drop",
"title": "Notify"
}
},
"required": [
"task",
"resource"
],
"title": "rank_watchArguments"
}🟢certify_offer(url)
Fair Offer certification for an x402 API: every claim in your 402's fair-offer block checked against live behaviour. Your public receipts are reconciled against Base, your free sample is attested, the block is checked against the 0.2 schema and across two requests, and the listing price against the Bazaar; priced at 5 cents or less, your route is also paid once to check that failed calls are free and results carry signed receipts. Pass or fail, the signed result is published at a public URL. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of your paid endpoint",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "certify_offerArguments"
}🟢certify_continuous(url, notify)
Continuous Fair Offer certification for an x402 API: the full certification now (priced at 5 cents or less, your route is paid once to check that failed calls are free and receipts are signed), then re-run about once a day for 30 days. The public status and badge show the latest check, so a pass is withdrawn the day a check fails, and every check's signed result is published. One payment, no renewal; a seller pays for the checking, never for the outcome. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of your paid endpoint",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
},
"notify": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional https webhook, POSTed the day a check changes the verdict or finds drift",
"title": "Notify"
}
},
"required": [
"url"
],
"title": "certify_continuousArguments"
}🟢buyer_drill(client, publish)
Buyer drill: red-team an x402 client with one token and nine trap routes on Agoranome's own host, each a $0.001 seller: a correct offer and eight attacks (price switch, lookalike asset, pay-to swap, network switch, instructions in the paid body, slow responder, unsettled 200, ambiguous error). Nothing signed at a trap is settled. Within 24 hours, a signed report: traps refused, traps paid, cents at risk, one certificate line. Use before a client or policy goes live. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"client": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional: the client library and version under test",
"title": "Client"
},
"publish": {
"default": false,
"description": "Let the Machine Buyer Safety report name that client library",
"title": "Publish",
"type": "boolean"
}
},
"title": "buyer_drillArguments"
}🟢buyer_check(url, tx, accept_proof, max_price, expected_price, ...)
Buyer check before paying an x402 seller: a signed verdict on one offer from what Agoranome holds: the Fair Offer block and certification, the pay-to seen for this host and since when, OFAC sanctions on it, Google Web Risk on the URL, price against listing and quote, verified deliveries, and which policy tiers it meets. With tx=, settlement proof after paying: the USDC transfer on Base, whether it matched the quote, and a buyer-side receipt for the commons. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "The x402 offer's URL",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
},
"tx": {
"anyOf": [
{
"pattern": "^0x[0-9a-fA-F]{64}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Settlement mode: the payment's transaction hash on Base",
"title": "Tx"
},
"accept_proof": {
"anyOf": [
{
"maxLength": 512,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Your requirements, as an Accept-Proof value",
"title": "Accept Proof"
},
"max_price": {
"default": 1,
"description": "Your per-call cap in USD",
"exclusiveMinimum": 0,
"maximum": 1000,
"title": "Max Price",
"type": "number"
},
"expected_price": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "The quoted price in USD",
"title": "Expected Price"
},
"pay_to": {
"anyOf": [
{
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The quoted pay-to address",
"title": "Pay To"
},
"share": {
"default": false,
"description": "Settlement mode: publish the buyer-side receipt in the evidence commons",
"title": "Share",
"type": "boolean"
}
},
"required": [
"url"
],
"title": "buyer_checkArguments"
}🟢spend_audit(wallet, days)
Wallet statement for an x402 buyer wallet on Base: every USDC payment checked against the payee's listed Bazaar price (above listed, oversize 10x or more, unlisted), spend and calls per seller, duplicate payments within a minute, payments made after a seller's listing vanished or its pay-to changed, sellers whose certification failed since, whether the wallet itself looks sweep-like, and a CSV of every payment. Use when an agent or its operator needs to account for an x402 wallet's spending. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"wallet": {
"description": "Buyer wallet address on Base",
"pattern": "^0x[0-9a-fA-F]{40}$",
"title": "Wallet",
"type": "string"
},
"days": {
"default": 7,
"description": "Days to look back",
"maximum": 30,
"minimum": 1,
"title": "Days",
"type": "integer"
}
},
"required": [
"wallet"
],
"title": "spend_auditArguments"
}🟢vendor_watch(sellers, wallet, notify)
Vendor watch for x402 buyers: name up to ten seller URLs, or a wallet whose sellers are read from its payments, and for 30 days each is checked daily: price, pay-to, Fair Offer block, Bazaar listing, certification state and latency. A signed diff waits at a free status URL and a pay-to or price change, a lost block, a vanished listing or a failed certification is posted to your webhook. Use when an agent pays the same sellers again and again. No renewal. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"sellers": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "The x402 offer URLs to watch (up to 10)",
"title": "Sellers"
},
"wallet": {
"anyOf": [
{
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Or: a buyer wallet on Base whose payees' listings are watched",
"title": "Wallet"
},
"notify": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional https webhook, POSTed on each alert",
"title": "Notify"
}
},
"title": "vendor_watchArguments"
}🟢response_scan(seller, body, spans, share)
Response safety scan for x402 buyers: post a paid response body, or passages of it, with the seller's URL and get back instruction-like passages aimed at an agent, hidden characters, exfiltration links, a mismatch against the seller's declared output example, and whether the seller's "data, never instructions" claim held. Nothing posted is stored; with share=true a contradicted claim becomes evidence on the seller's record, as hashes. Use before an agent acts on a paid result. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"seller": {
"description": "The x402 offer's URL the response came from",
"maxLength": 2048,
"minLength": 12,
"title": "Seller",
"type": "string"
},
"body": {
"anyOf": [
{
"maxLength": 65536,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The paid response body",
"title": "Body"
},
"spans": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Or: passages of the body",
"title": "Spans"
},
"share": {
"default": false,
"description": "Let a contradicted claim count as evidence on the seller's record (hashes only)",
"title": "Share",
"type": "boolean"
}
},
"required": [
"seller"
],
"title": "response_scanArguments"
}🟢plan_quote(plan, caps)
Pre-flight plan quote for x402 buyers: post a plan of seller URLs and call counts and get the total cost, each seller's listing and certification state, its expected failure share from reconciled receipts, the fit against your caps (per call, per seller, total, policy tier), and every certified seller in the same category sorted by price with the sort key stated. Use before a planner agent starts a batch of paid calls. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"plan": {
"description": "Lines of {seller: URL, calls: n}",
"items": {
"additionalProperties": true,
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"title": "Plan",
"type": "array"
},
"caps": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "max_price_usd, max_per_seller_usd, max_total_usd, tier",
"title": "Caps"
}
},
"required": [
"plan"
],
"title": "plan_quoteArguments"
}🟢dispute_pack(tx, seller, offer, response, expected_price_usd, ...)
Dispute evidence pack for x402 buyers: given a payment's transaction hash, the seller URL, the accepted 402 and the response, get the settlement on Base, the Fair Offer terms at quote time (failed calls free, receipts, refunds), what Agoranome observed of that seller in that hour, the seller's published contact and a draft claim addressed to it, all signed. Use when an agent was charged and not served. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {
"tx": {
"description": "The payment's transaction hash on Base",
"pattern": "^0x[0-9a-fA-F]{64}$",
"title": "Tx",
"type": "string"
},
"seller": {
"description": "The x402 offer's URL",
"maxLength": 2048,
"minLength": 12,
"title": "Seller",
"type": "string"
},
"offer": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "The accepted 402 as received",
"title": "Offer"
},
"response": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "status, body or body_sha256, headers, received_at",
"title": "Response"
},
"expected_price_usd": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Expected Price Usd"
},
"pay_to": {
"anyOf": [
{
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pay To"
},
"claim": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What went wrong, in your words",
"title": "Claim"
}
},
"required": [
"tx",
"seller"
],
"title": "dispute_packArguments"
}🟢fund_commons
Fund the x402 evidence commons: a $0.10 contribution that keeps Agoranome's evidence lookups, Fair Offer checker and buyer policy pack free. Returns a signed receipt; 15% goes to the cause Agoranome pledges to, verifiable at /impact/ledger. Nothing else is delivered, and a contribution never changes a result, a rank or a certification. Price: $0.10 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {},
"title": "fund_commonsArguments"
}🟢ping
x402 ping and test payment: can my wallet pay an x402 API? Pay a fraction of a cent in USDC on Base and get a signed receipt back, proof that your wallet and x402 client complete a real paid call end to end, plus what the Lab knows about your wallet and which tool to try next. Use when an agent needs a cheap test payment endpoint before buying anything bigger. Price: $0.001 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.
Input Schema
{
"type": "object",
"properties": {},
"title": "pingArguments"
}🟢rank_sample(task, resource)
Free: the top three Bazaar results a buyer agent would see for a task, and your rank if you pass resource. The paid rank_check adds the signals where you trail the listings ahead of you.
Input Schema
{
"type": "object",
"properties": {
"task": {
"description": "What a buyer agent is searching for",
"maxLength": 400,
"minLength": 3,
"title": "Task",
"type": "string"
},
"resource": {
"default": "",
"description": "Your listed resource URL",
"maxLength": 2048,
"title": "Resource",
"type": "string"
}
},
"required": [
"task"
],
"title": "rank_sampleArguments"
}🟢check_fair_offer(url, accept_proof)
Free: check any x402 offer's Fair Offer block from outside, without paying. Each of the seven Fair Offer rules comes back verified, declared, contradicted or not claimed. Pass accept_proof (e.g. "sample=attested; price<=listing") to learn whether the offer meets a buyer's requirements.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of the paid endpoint",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
},
"accept_proof": {
"anyOf": [
{
"maxLength": 512,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional Accept-Proof value",
"title": "Accept Proof"
}
},
"required": [
"url"
],
"title": "check_fair_offerArguments"
}🟢check_offer(url, tier, max_price_usd, expected_price_usd)
Free: would a buyer's policy pay this x402 offer? Applies Agoranome's open buyer policy (a price cap, the listing price, no instructions in the listing, and a proof tier: any, sampled or delivered) and returns allowed or refused with the reasons. Nothing is paid or signed.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Public https URL of the paid endpoint",
"maxLength": 2048,
"minLength": 10,
"title": "Url",
"type": "string"
},
"tier": {
"default": "sampled",
"description": "Proof tier: any, sampled or delivered",
"enum": [
"any",
"sampled",
"delivered"
],
"title": "Tier",
"type": "string"
},
"max_price_usd": {
"default": 1,
"description": "The buyer's price cap",
"exclusiveMinimum": 0,
"maximum": 1000,
"title": "Max Price Usd",
"type": "number"
},
"expected_price_usd": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "A quoted price, if any",
"title": "Expected Price Usd"
}
},
"required": [
"url"
],
"title": "check_offerArguments"
}🟢agent_payments_weekly(week)
Free: Agoranome Weekly's edition for a week (the newest if week is left out): real demand on Base (payments into the busiest Bazaar sellers with catalog sweeps and self-payments taken out), the Bazaar's sellers, new sellers, price index and Fair Offer share, and x402 SDK downloads, with the method version and how to cite it. CC BY 4.0.
Input Schema
{
"type": "object",
"properties": {
"week": {
"anyOf": [
{
"pattern": "^\\d{4}-W\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO week, e.g. 2026-W44",
"title": "Week"
}
},
"title": "agent_payments_weeklyArguments"
}🟢registered_agent_card(agent_id)
Free: check an ERC-8004 agent on Base from outside, by its id in the Identity Registry: whether its registration file is valid and points back to it, whether its https endpoints answer and their domains list it, whether its x402 offer or A2A agent card passes the lint, and how concentrated its Reputation Registry feedback is. Nothing is paid or written.
Input Schema
{
"type": "object",
"properties": {
"agent_id": {
"description": "The agent's id on Base",
"exclusiveMaximum": 1000000000000,
"minimum": 0,
"title": "Agent Id",
"type": "integer"
}
},
"required": [
"agent_id"
],
"title": "registered_agent_cardArguments"
}Community
Evidence