Agoranome seller tools

io.github.Agoranome由 GitHub 帳號 Agoranome 發布v1.0.3更新於 Nov 2, 2026

Get your x402 API found and bought: lint, Bazaar rank, buyer panel, demand gaps. Paid in USDC.

已驗證Streamable HTTP可網頁執行金融開發者工具商業與電商

概覽

AI 產生的概覽

針對 x402 API 的託管 MCP 伺服器,提供賣家與買家工具:檢查上架資訊、Bazaar 排名、買家代理偏好、付款稽核與報價認證。

可以做什麼
  • 在首次販售前對 x402 或 MPP 端點做上架檢查與 402 一致性檢查,包含付款標頭與輸入輸出 schema
  • 查詢 Bazaar 搜尋排名,查看買家代理會看到的前幾名結果,以及落後對手的訊號
  • 執行買家代理 A/B 面板、模型變更監測,並依公開 Bazaar 資料找出需求缺口
  • 為免費樣本出具證明,並依實際行為核驗 Fair Offer 聲明,公開簽章結果
  • 依買家政策檢查報價、取得付款前的簽章結論、對 x402 用戶端做紅隊測試,並稽核錢包在 Base 上的 USDC 付款
  • 向證據公共池捐款,並做一筆小額測試付款以確認錢包能完成支付
適用情境
適合販售 x402 API、希望被買家代理找到並選用的賣家,也適合持有代理錢包、想在付款前審查賣家並核對支出的買家。多數工具面向賣家調整上架資訊、定價與信任訊號。
執行需求
遠端 streamable HTTP 端點,不需安裝套件,未宣告環境變數或請求標頭。付費工具在工具呼叫內以 Base 上的 USDC 透過 x402 付款,需要已儲值的錢包與支援 x402 的用戶端;rank_sample、check_fair_offer、check_offer 等免費工具不需付款。
安裝前請注意
多個工具按次收取 USDC,包括 buyer_check、buyer_drill、model_watch、certify_continuous 與 fund_commons,代理可能在沒有另行確認的情況下花錢。部分工具會抓取你的端點或讀取錢包的鏈上付款紀錄;回傳結果是第三方上架資料,不應當成指令執行。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Agoranome seller tools,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Agoranome%2Fagoranome/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agoranome-seller-tools": {
      "type": "http",
      "url": "https://api.agoranome.com/mcp"
    }
  }
}

README

The Fair Offer Standard

Seven open rules for selling to AI agents honestly, and a machine-readable way to prove them inside the x402 payment handshake. Version 0.2 (draft).

Human-readable page: https://agoranome.com/standard · JSON: standard.json · Schema: schema/fair-offer-0.2.schema.json

The seven rules

IDRuleWhat it meansHow to check
FO-1Price before paymentAn unpaid call returns an x402 offer (HTTP 402) that states the price, asset, network and pay-to address. Nothing is charged before the buyer has signed that exact offer.check
FO-2Failure is freeA call that fails, times out or returns no result is not settled. The buyer is told so.self-declared
FO-3Receipts are signedEvery paid result carries a receipt signed by the seller's key: what was bought, for how much, and when.check
FO-4Sample before you buyA free sample shows what the paid route returns, and a third party can attest that the sample and the paid offer come from the same host.check
FO-5Honest listingThe listing's description, input schema and output example match what the route really returns. Edits made to win buyers must stay true.check
FO-6Data, never instructionsResponses carry data for the buying agent to use, never instructions aimed at it. A buyer can treat any instruction in a response as an attack.self-declared
FO-7Promises are verifiableAny claim about where revenue goes (a pledge, a split, a donation) comes with a public ledger that a buyer can check per receipt, with on-chain proof of what was given.check

Declaring it (0.2)

A seller's HTTP 402 carries an x402 extension, extensions["fair-offer"], whose info states which rules the offer keeps and where a buyer can check each one:

json
{  "version": "0.2",  "standard": "https://agoranome.com/standard",  "settlement": {    "failed_calls": "not_charged",    "enforced_by": "seller"  },  "receipts": {    "signed": true,    "verify": "https://api.example.com/receipts/verify"  },  "sample": {    "url": "https://api.example.com/v1/search/sample"  },  "listing_price_matches_offer": true,  "data_not_instructions": true,  "pledge": {    "share": 0.15,    "basis": "settled_revenue",    "ledger": "https://api.example.com/impact/ledger"  }}
  • Keep it stable. Keep the info identical in the unpaid 402 and on the paid retry: x402 clients echo it, and servers reject a payment whose echo drops or changes a field. Put live numbers behind a URL, never in the block.
  • URLs. Each URL is https, or a path relative to the resource URL.
  • Put the fair-offer block in your 402's extensions (see handshake), and link this URL from your llms.txt or agent manifest as "conforms_to": {"fair_offer": "0.2"}.

Asking for proof: Accept-Proof

A buyer says what proof it needs before it pays, in an Accept-Proof request header (or an accept_proof field in the block it echoes in the payment payload):

Accept-Proof: sample=attested; price<=listing; payers_30d>=20
RequirementMet when
sample=anythe offer declares a free sample on its own host
sample=attestedthe sample has an attestation on record
settlement=sellerfailed calls are not charged (the seller's promise)
settlement=railthe payment is captured only on success (auth-capture)
price<=listingthe live price was checked against the Bazaar listing
receipts=signedpaid results carry signed receipts
pledge=ledgera pledge with a public ledger that answers
instructions=nonedeclared data-not-instructions, and no instruction-like text found
payers_30d>=Nat least N distinct payers in 30 days (Bazaar's count)
calls_30d>=Nat least N paid calls in 30 days (Bazaar's count)
deliveries_30d>=Nat least N deliveries in 30 days: receipts confirmed on chain, paid by buyers (evidence commons)

Checking an offer

  • Validate a block: POST https://api.agoranome.com/v1/fair-offer/validate (free)
  • Check a live offer's claims from outside: GET https://api.agoranome.com/v1/fair-offer/check?url=... (free)

Implementations

  • Agoranome (https://agoranome.com): every paid x402 route at api.agoranome.com sends the block, and the hosted MCP server (https://api.agoranome.com/mcp, listed in the official MCP Registry) offers a check_offer tool. That service's source isn't public; this repository holds the open standard.
  • Using it in your 402s? Open an issue with your host and it can be listed here.

Agent skill for buyers

skills/x402-pay-safely/SKILL.md is an Agent Skill for any agent with a wallet. It tells the agent when to check an x402 seller before paying it and how to prove a payment after, using Agoranome's paid Buyer check ($0.01 a call, up to 20 offers at once) and the free checks above. Skill installers that read a GitHub repository can install it from here. The copy served at https://api.agoranome.com/skills/x402-pay-safely/SKILL.md is always current.

Proposing changes

Open an issue or a pull request. Changes to the block's fields go into a new version, so a buyer's policy written for 0.2 keeps working. Corrections, data questions and replication requests can also go to [email protected].

Versions

  • 0.1: The seven rules, declared in an agent manifest or llms.txt.
  • 0.2: The same seven rules, plus the machine-readable fair-offer block in the x402 402 and the buyer's Accept-Proof header.

License

The standard text, schema, examples and the buyer skill are licensed under CC BY 4.0. Implement it freely; credit "The Fair Offer Standard, Agoranome".

來源:README.md,提交 43f8562

工具

19

lint_listing

Listing lint

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. Use when an agent needs to lint an x402 listing before its first settled payment. Price: $0.005 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數url必填

conformance_check

402 conformance run

402 conformance check for an x402 or MPP API: can buyer agents' SDKs pay it? Checks the x402 v2 requirements (whole-unit amounts, addresses, the token's EIP-712 domain, the same terms on every request), that a malformed payment is refused, any MPP challenge against the paymentauth.org draft, and the live price against the Bazaar and the host's openapi.json. Unpaid requests only; nothing is signed or paid. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數url必填

rank_check

Rank check

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 competitor listings ahead of you, and the signals where you trail them (payers, calls, description, output example, schema, price). Search rank, SEO 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.

輸入參數task必填networkresource必填

buyer_panel

Machine Buyer Panel

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, why you lost, and up to three truthful edits tested on the same trials. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數tasks必填resource必填

signed_sample

Signed sample

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.

輸入參數sample必填resource必填

demand_gaps

Demand gap finder

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. 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.

輸入參數topic

payer_analytics

Real-customer analytics

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.

輸入參數daysaddress必填

weekly_insights

Weekly x402 demand insights

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.

輸入參數week

model_watch

Model-update watch

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.

輸入參數tasks必填notifyresource必填

certify_offer

Fair Offer certification

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. 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.

輸入參數url必填

certify_continuous

Continuous certification

Continuous Fair Offer certification for an x402 API: the full certification now, 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.

輸入參數url必填

buyer_drill

Buyer drill

Buyer drill: red-team an x402 client. Pay once and get a 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 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數clientpublish

buyer_check

Buyer check

Buyer check before paying an x402 seller: a signed verdict on one offer from what Agoranome already holds. Fair Offer block valid and certified, the pay-to seen for this host and since when, price against listing and quote, verified deliveries, and which policy tiers the offer 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. Use when an agent needs seller evidence at the moment of payment. Price: $0.01 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數txurl必填sharepay_tomax_priceaccept_proofexpected_price

spend_audit

Wallet overspend audit

Did my agent overpay for x402 APIs? The wallet overspend audit reads a buyer wallet's USDC payments on Base and checks each against the payee's listed Bazaar price: payments above the listed price, oversize settlements of 10x or more, and payments to addresses with no listing, totalled per seller. Use when an agent or its operator needs a spend audit of an x402 buyer wallet. Price: $1.00 in USDC per call, paid with x402 inside the tool call. Failed calls aren't charged.

輸入參數dayswallet必填

fund_commons

Fund the evidence 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.

無需輸入參數。

ping

Payment test

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. 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.

無需輸入參數。

rank_sample

Rank sample (free)

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.

輸入參數task必填resource

check_fair_offer

Fair Offer check (free)

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.

輸入參數url必填accept_proof

check_offer

Buyer policy check (free)

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.

輸入參數url必填tiermax_price_usdexpected_price_usd

版本歷史

1
  1. v1.0.3最新Oct 26, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。