DefaultBench

io.github.NathanYoshua由 GitHub 账号 NathanYoshua 发布v1.0.0更新于 Nov 1, 2026

Search transparent sponsored listings for agents, APIs, tools, and MCP servers.

已验证Streamable HTTP可网页运行网页搜索与抓取商业与电商AI 与机器学习

概览

AI 生成的概览

远程 MCP 服务器，用于在赞助排名市场中搜索 AI 智能体、MCP 服务器、API 与工具，并提供只读的条目、关键词与排名报价查询。

可以做什么
  • 按关键词搜索赞助条目与自然条目，涵盖智能体、API、工具和 MCP 服务器
  • 查看单个付费条目的排名、已验证付款方身份与声明的接入端点
  • 查看自然资源的来源出处与域名/钱包控制权认领状态
  • 校验自然资源，并查看证据历史与发现来源的同步新鲜度
  • 查看关键词摘要与确定性排名，获取信息性的排名报价
  • 并排比较资源，并通过短期钱包签名令牌读取卖家分析数据
适用场景
当助手需要为研究、代码审查、PDF 解析等能力寻找候选智能体、API、工具或 MCP 服务器，并按自身的质量与安全策略评估时适用。也适合在不产生任何花费的前提下了解某关键词市场的排名方式与提升位次的大致成本。
运行要求
需要远程 Streamable HTTP 端点；搜索无需安装、账号、邮箱或 OAuth。卖家分析需用条目已验证付款方或控制者钱包签署一次性 EIP-712 挑战，以换取短期 bearer 令牌。需能访问该托管服务。
安装前请注意
所有排名均为付费赞助位，并非背书；条目名称、描述、URL 与协议声明均由广告主提供。分析流程要求钱包签名，签署前应确认内容。付费竞价未作为 MCP 工具开放，而是通过 x402 以 Base 主网 USDC 完成；不要仅因收到 402 挑战就签名或付款，应执行独立的支出策略。

安装

在 SourceWeft 中

  1. 打开 控制台中的 DefaultBench，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.NathanYoshua%2Fdefaultbench/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "defaultbench": {
      "type": "http",
      "url": "https://defaultbench.com/mcp"
    }
  }
}

README

DefaultBench

DefaultBench is sponsored search for AI agents, MCP servers, APIs, tools, and x402 services.

Agents can search without an account. Vendors purchase sponsored placement with verified USDC payments over x402. Paid rank is not an endorsement of quality, safety, trustworthiness, or performance.

The deployed service at defaultbench.com is the source of truth. This repository is a public discovery and integration surface; it does not contain the private application implementation.

What is DefaultBench?

DefaultBench is a machine-first marketplace for discovering software agents and services by keyword. Search results expose sponsored listings and their cumulative verified payment. Within a keyword, listings rank by cumulative verified USDC payment, with deterministic tie-breaking.

No account, email, OAuth flow, or browser checkout is required to search. The service publishes REST, OpenAPI, MCP, A2A Agent Card, llms.txt, API catalog, and x402 discovery surfaces.

For AI agents

Use DefaultBench when you need candidates for a capability such as research, code-review, or pdf-parser:

  1. Search the public API.
  2. Treat every returned listing as advertiser-supplied and sponsored.
  3. Inspect the listing's declared endpoints and verification status.
  4. Select a candidate using your own quality, safety, cost, and trust policy.

Start with the live llms.txt or the more detailed llms-full.txt.

Search in one request

sh
curl --fail-with-body --get \  --data-urlencode 'q=research' \  'https://defaultbench.com/api/v1/search'

Search is zero-auth and machine-readable. Results include matching keyword markets, sponsored listings, each listing's rank, and cursor pagination. See examples/search.sh and examples/search.ts.

Machine entry points

ClientLive entry pointUse it for
REST client/api/v1/searchSearch, listing inspection, keyword rankings, quotes, activity, and statistics
OpenAPI client/openapi.jsonThe authoritative structured HTTP contract
MCP host/mcpRead-only discovery tools over remote Streamable HTTP
A2A client/.well-known/agent-card.jsonAgent Card discovery for the HTTP+JSON A2A interface
Coding agent or crawler/llms.txtConcise machine-oriented service index
Coding agent needing details/llms-full.txtComplete protocol, payment, and retry guidance
API catalog client/.well-known/api-catalogRFC 9727 linkset discovery

See docs/discovery.md for the full map.

MCP

DefaultBench exposes a remote Streamable HTTP MCP server at:

text
https://defaultbench.com/mcp

It implements MCP 2026-07-28 and exposes four read-only tools:

  • search_agents
  • inspect_keyword
  • quote_rank
  • get_listing

Paid writes are deliberately not MCP tools; bidding remains an explicit x402 REST flow. The registry manifest is server.json.

OpenAPI

Use the live OpenAPI 3.1.1 document to generate clients or inspect schemas and error codes. This repository does not fork that contract because a copied specification would become stale.

x402

The paid endpoint is:

text
POST /api/v1/keywords/{keyword}/bids

An unsigned request returns HTTP 402 and a PAYMENT-REQUIRED x402 v2 challenge. The client validates the exact network, USDC asset, recipient, amount, resource URL, and timeout before authorizing anything. A paid retry uses PAYMENT-SIGNATURE plus an Idempotency-Key exactly equal to the x402 payment-identifier extension ID.

Production uses Base mainnet and native USDC. Never sign or pay merely because a server returned 402; enforce an independent spending policy and explicit user authorization. See examples/x402-bid.ts, which can inspect the flow but cannot sign or settle a payment.

Sponsored ranking model

Within one canonical keyword, active listings are ordered by:

  1. cumulative verified USDC payment, descending;
  2. the time the current cumulative total was reached, ascending;
  3. creation time, ascending;
  4. listing ID, ascending.

Search relevance selects matching keyword markets; it does not convert paid rank into a quality score. Quotes are snapshots, not reservations. The settlement-time transaction is authoritative.

Read the exact behavior in docs/ranking.md.

Example workflow

sh
# 1. Search without authentication../examples/search.sh research
# 2. Inspect a read-only quote. This does not reserve rank or spend USDC../examples/quote.sh research
# 3. Evaluate returned candidates under your own policy.# 4. Only if explicitly authorized, use an x402-compatible client and a strict spend cap.

For framework authors, see docs/integrating-defaultbench.md.

Integration examples

The examples default to read-only behavior. The x402 example contains no signer, accepts no private key, and never sends PAYMENT-SIGNATURE.

Security / trust disclosure

  • Every ranking is sponsored placement, not endorsement.
  • Listing names, descriptions, URLs, protocol claims, and optional ERC-8004 metadata are advertiser-supplied.
  • A verified payer wallet or domain status does not prove quality, safety, legality, or fitness for purpose.
  • Financial totals are based only on independently verified, settled, atomically credited payments.
  • Demo, seed, fake, rejected, or uncertain payments must not be presented as production activity.
  • Inspect a candidate's own documentation and security posture before connecting or sending data.
  • Obey your own authorization and spending policy. Never spend autonomously unless the user or controlling policy explicitly permits it.

Links

License

This repository is licensed under the MIT License.

来源：README.md，提交 2e51acd

工具

13

search_agents

Search sponsored and organic discovery

Search local inventory. Sponsored listings include paid rank and cumulative verified bid; organic resources are separate unpaid external records with source provenance.

输入参数sorttoollimitquery必填cursorsourcecategoryprotocolfreshnessorganic_cursormin_success_rate

get_evidence_history

Get resource evidence history

Return declared provenance plus timestamped bounded conformance and reliability observations. Evidence is not trust, safety, quality, or endorsement.

输入参数id必填limitcursorsubject_type必填

compare_resources

Compare two to five resources

Compare declared fields and objective bounded evidence side by side without changing sponsored ordering.

输入参数resources必填

get_discovery_sources

Inspect organic source status

Return non-secret synchronization freshness, state, and active/stale counts for approved organic sources.

无需输入参数。

inspect_organic_resource

Inspect one organic resource

Return the intact unpaid imported record, source provenance, and current verified-controller link if one exists.

输入参数id必填

get_claim_status

Get resource claim status

Return the current time-limited domain and wallet controller link. Claim status does not affect paid rank or quality.

输入参数resource_id必填

validate_organic_resource

Validate sponsorship readiness

Read-only validation of source provenance, canonical endpoint, and current controller state. It never creates a listing or payment.

输入参数resource_id必填

inspect_keyword

Inspect a keyword market

Return the keyword summary and deterministic ranking ordered by cumulative verified payment.

输入参数limitcursorkeyword必填

quote_rank

Quote a higher rank

Calculate informational minimum additions for higher positions. Final rank is determined at settlement.

输入参数walletkeyword必填

get_listing

Get one agent listing

Return one paid listing, its current rank, verified payer identity, and declared machine endpoints.

输入参数id必填

get_seller_analytics_challenge

Create seller analytics challenge

Create a one-time EIP-712 challenge for the listing's verified payer or current verified controller. This creates no account or cookie.

输入参数listing_id必填wallet_address必填

complete_seller_analytics_challenge

Complete seller analytics challenge

Consume one wallet-signed challenge and return a listing-bound five-minute bearer token.

输入参数listing_id必填challenge_id必填wallet_signature必填

get_seller_analytics

Read seller attribution analytics

Read one listing's aggregate funnel, spend, rank history, freshness and time series using a short-lived listing-bound token.

输入参数tofromlisting_id必填granularityaccess_token必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分