Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/defaultbench-com:defaultbench-com-mcp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DefaultBench MCP API
version: 1.0.0
summary: Machine-first paid placement and discovery for autonomous agents.
description: DefaultBench exposes transparent sponsored rankings. Listings are ordered by cumulative verified USDC payment descending, then by the time the current cumulative total was reached ascending. Rank is paid placement, not an endorsement or quality signal. Monetary values are decimal strings containing integer USDC base units (six decimals).
termsOfService: https://defaultbench.com/terms
license:
name: Proprietary service API; public protocol documentation
url: https://defaultbench.com/terms
servers:
- url: https://defaultbench.com
description: Configured DefaultBench origin
tags:
- name: MCP
description: MCP Streamable HTTP transport.
paths:
/mcp:
description: MCP Streamable HTTP transport. Every request consumes the configured search-rate ceiling in a separate MCP scope; POST bodies are capped at 64 KiB.
get:
operationId: openMcpStream
tags:
- MCP
summary: Open or resume an MCP Streamable HTTP event stream
parameters:
- $ref: '#/components/parameters/McpProtocolVersion'
- $ref: '#/components/parameters/McpSessionId'
responses:
'200':
description: MCP Streamable HTTP response when GET is negotiated by the transport.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcMessage'
text/event-stream:
schema:
type: string
'403':
description: A browser Origin header does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_origin
'405':
description: GET is not available for the stateless transport state.
'421':
description: The request URL authority does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_host
'429':
description: The applicable bounded rate limit is exhausted.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
RateLimit-Limit:
$ref: '#/components/headers/RateLimitLimit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimitRemaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimitReset'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Rate limit exceeded. Retry after the indicated delay.
details: {}
retry_after_seconds: 30
'500':
description: An unexpected server error occurred; no uncertain payment is credited.
headers:
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: The request could not be completed.
details: {}
'503':
description: A dependency is unavailable, one identical request owns the settlement claim, settlement is uncertain, or a confirmed settlement is awaiting atomic ranking credit. These responses never authorize a replacement payment. Retry the identical paid request after Retry-After unless the code says otherwise.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
PAYMENT-RESPONSE:
$ref: '#/components/headers/PaymentResponse'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
dependencyUnavailable:
value:
error:
code: service_unavailable
message: A required dependency is temporarily unavailable.
details:
retryable: true
settlementInProgress:
value:
error:
code: payment_settlement_in_progress
message: An identical settlement attempt is already in progress. Retry this request shortly.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settling
transaction_id: null
retryable: true
settlementUncertain:
value:
error:
code: payment_settlement_uncertain
message: The settlement outcome is being reconciled and will not be submitted again automatically. Retry this identical request for the durable result.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settlement_uncertain
transaction_id: null
retryable: true
settledPendingCredit:
value:
error:
code: payment_settled_pending_credit
message: Settlement succeeded, but ranking credit is pending durable recovery. Retry the identical request.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
transaction_id: '0x0000000000000000000000000000000000000000000000000000000000000001'
retryable: true
bidConfigurationUnavailable:
value:
error:
code: bid_configuration_unavailable
message: Bidding is temporarily unavailable while payment policy configuration is synchronized.
details:
retryable: true
post:
operationId: sendMcpMessage
tags:
- MCP
summary: Send an MCP 2026-07-28 JSON-RPC message
parameters:
- $ref: '#/components/parameters/McpProtocolVersion'
- $ref: '#/components/parameters/McpSessionId'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcMessage'
responses:
'200':
description: MCP JSON-RPC response or event stream.
content:
application/json:
schema:
$ref: '#/components/schemas/JsonRpcMessage'
text/event-stream:
schema:
type: string
'202':
description: Accepted notification or response with no response body.
'400':
description: The request is malformed or a query parameter is invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKeyword:
value:
error:
code: invalid_keyword
message: Keyword must normalize to 1–64 valid characters.
details: {}
validationError:
value:
error:
code: validation_error
message: Request validation failed.
details:
fields:
- path: limit
message: 'Too big: expected number to be <=100'
'403':
description: A browser Origin header does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_origin
'413':
description: The request body exceeds the 64 KiB limit.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: payload_too_large
message: Request body exceeds 64 KiB.
details: {}
'421':
description: The request URL authority does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_host
'429':
description: The applicable bounded rate limit is exhausted.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
RateLimit-Limit:
$ref: '#/components/headers/RateLimitLimit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimitRemaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimitReset'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Rate limit exceeded. Retry after the indicated delay.
details: {}
retry_after_seconds: 30
'500':
description: An unexpected server error occurred; no uncertain payment is credited.
headers:
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: The request could not be completed.
details: {}
'503':
description: A dependency is unavailable, one identical request owns the settlement claim, settlement is uncertain, or a confirmed settlement is awaiting atomic ranking credit. These responses never authorize a replacement payment. Retry the identical paid request after Retry-After unless the code says otherwise.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
PAYMENT-RESPONSE:
$ref: '#/components/headers/PaymentResponse'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
dependencyUnavailable:
value:
error:
code: service_unavailable
message: A required dependency is temporarily unavailable.
details:
retryable: true
settlementInProgress:
value:
error:
code: payment_settlement_in_progress
message: An identical settlement attempt is already in progress. Retry this request shortly.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settling
transaction_id: null
retryable: true
settlementUncertain:
value:
error:
code: payment_settlement_uncertain
message: The settlement outcome is being reconciled and will not be submitted again automatically. Retry this identical request for the durable result.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settlement_uncertain
transaction_id: null
retryable: true
settledPendingCredit:
value:
error:
code: payment_settled_pending_credit
message: Settlement succeeded, but ranking credit is pending durable recovery. Retry the identical request.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
transaction_id: '0x0000000000000000000000000000000000000000000000000000000000000001'
retryable: true
bidConfigurationUnavailable:
value:
error:
code: bid_configuration_unavailable
message: Bidding is temporarily unavailable while payment policy configuration is synchronized.
details:
retryable: true
delete:
operationId: closeMcpSession
tags:
- MCP
summary: Close an MCP Streamable HTTP session when supported
parameters:
- $ref: '#/components/parameters/McpProtocolVersion'
- $ref: '#/components/parameters/McpSessionId'
responses:
'200':
description: MCP transport accepted the session close.
'403':
description: A browser Origin header does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_origin
'404':
description: The requested resource does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: not_found
message: The requested resource was not found.
details: {}
'405':
description: The stateless transport has no session to close.
'421':
description: The request URL authority does not equal configured APP_ORIGIN.
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: string
const: invalid_host
'429':
description: The applicable bounded rate limit is exhausted.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
RateLimit-Limit:
$ref: '#/components/headers/RateLimitLimit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimitRemaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimitReset'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Rate limit exceeded. Retry after the indicated delay.
details: {}
retry_after_seconds: 30
'500':
description: An unexpected server error occurred; no uncertain payment is credited.
headers:
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: The request could not be completed.
details: {}
'503':
description: A dependency is unavailable, one identical request owns the settlement claim, settlement is uncertain, or a confirmed settlement is awaiting atomic ranking credit. These responses never authorize a replacement payment. Retry the identical paid request after Retry-After unless the code says otherwise.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
PAYMENT-RESPONSE:
$ref: '#/components/headers/PaymentResponse'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
dependencyUnavailable:
value:
error:
code: service_unavailable
message: A required dependency is temporarily unavailable.
details:
retryable: true
settlementInProgress:
value:
error:
code: payment_settlement_in_progress
message: An identical settlement attempt is already in progress. Retry this request shortly.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settling
transaction_id: null
retryable: true
settlementUncertain:
value:
error:
code: payment_settlement_uncertain
message: The settlement outcome is being reconciled and will not be submitted again automatically. Retry this identical request for the durable result.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
settlement_state: settlement_uncertain
transaction_id: null
retryable: true
settledPendingCredit:
value:
error:
code: payment_settled_pending_credit
message: Settlement succeeded, but ranking credit is pending durable recovery. Retry the identical request.
details:
idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
transaction_id: '0x0000000000000000000000000000000000000000000000000000000000000001'
retryable: true
bidConfigurationUnavailable:
value:
error:
code: bid_configuration_unavailable
message: Bidding is temporarily unavailable while payment policy configuration is synchronized.
details:
retryable: true
components:
parameters:
McpSessionId:
name: Mcp-Session-Id
in: header
required: false
schema:
type: string
minLength: 1
maxLength: 256
McpProtocolVersion:
name: MCP-Protocol-Version
in: header
required: true
schema:
type: string
const: '2026-07-28'
schemas:
ErrorResponse:
type: object
additionalProperties: false
required:
- error
properties:
error:
type: object
additionalProperties: false
required:
- code
- message
- details
properties:
code:
type: string
pattern: ^[a-z][a-z0-9_]*$
description: Stable machine-readable code.
message:
type: string
description: Human-readable, non-stable explanation.
details:
$ref: '#/components/schemas/ErrorDetail'
retry_after_seconds:
type: integer
minimum: 1
JsonRpcMessage:
type: object
additionalProperties: true
required:
- jsonrpc
properties:
jsonrpc:
type: string
const: '2.0'
id:
oneOf:
- type: string
- type: integer
- type: 'null'
method:
type: string
params:
type: object
additionalProperties: true
result: {}
error:
type: object
additionalProperties: true
ErrorDetail:
type: object
description: Code-specific bounded details; clients must branch on error.code, not message text.
additionalProperties: true
headers:
RetryAfter:
description: Seconds until the caller should retry.
schema:
type: integer
minimum: 1
RateLimitLimit:
description: Maximum requests in the current policy window.
schema:
type: integer
minimum: 1
RateLimitRemaining:
description: Requests remaining in the current policy window.
schema:
type: integer
minimum: 0
PaymentResponse:
description: Base64-encoded JSON x402 v2 settlement response/receipt. It may also be present on a non-200 facilitator failure or uncertain response; header presence alone is never evidence of success or ranking credit.
schema:
type: string
contentEncoding: base64
RequestId:
description: Opaque request correlation identifier; safe to include in an incident report.
schema:
type: string
RateLimitReset:
description: Unix epoch timestamp in seconds when the current policy window resets.
schema:
type: integer
minimum: 0
securitySchemes:
x402Payment:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: Base64-encoded x402 v2 payment payload. It is intentionally absent on the initial request that obtains HTTP 402 requirements.
sellerAnalyticsBearer:
type: http
scheme: bearer
bearerFormat: DefaultBench signed token
description: Five-minute token issued only after consuming a listing-bound, origin-bound EIP-712 wallet challenge.
operatorBearer:
type: http
scheme: bearer
description: Operator secret for private revenue and purchase-funnel metrics.
externalDocs:
description: Full autonomous-client instructions
url: https://defaultbench.com/llms-full.txt
x-defaultbench-payment:
protocol: x402
version: 2
sdkVersion: 2.24.0
scheme: exact
network: eip155:8453
networkLabel: Base mainnet
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
symbol: USDC
decimals: 6
minimumBidBaseUnits: '10000'
requestHeader: PAYMENT-SIGNATURE
challengeHeader: PAYMENT-REQUIRED
settlementHeader: PAYMENT-RESPONSE
x-defaultbench-ranking:
primary: cumulative verified payment descending
tieBreaker: timestamp current cumulative total was reached ascending
qualitySignal: false
x-defaultbench-examples: Synthetic documentation examples; never production activity.