AllMCPs Boost API
The Boost API from AllMCPs — 3 operation(s) for boost.
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/allmcps:allmcps-boost-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: AllMCPs Directory Boost API
description: 'Public API for querying and managing Model Context Protocol (MCP) servers listed on AllMCPs. Designed for AI agents, LLM tool callers, and developer integrations.
**Versioning & deprecation policy**: this spec is URL-versioned (`/api/v1/...`). Endpoints are additive within v1 — existing fields are not removed or repurposed without a version bump. If an endpoint is ever deprecated, responses will carry a `Deprecation: true` header (and, once a removal date is set, a `Sunset: ` header) for at least 90 days before removal, and the change will be announced at https://allmcps.com/blog. There is currently no deprecated surface in v1.
**Auth**: most endpoints are public/unauthenticated (see each operation). Listing-mutating agent actions require a scoped Bearer token — see `components.securitySchemes.agentBearerAuth` and https://allmcps.com/auth.md.'
version: 1.0.0
contact:
name: AllMCPs Team
url: https://allmcps.com/contact
email: contact@allmcps.com
servers:
- url: https://allmcps.com
description: Production Edge Server
tags:
- name: Boost
paths:
/api/v1/boost/pricing:
get:
summary: Boost tiers, prices, and accepted payment methods
description: Every paid tier with list and agent price, weekly volume tiers, and whether x402 is currently enabled (`agent_commerce_support.x402.enabled`).
operationId: getBoostPricing
responses:
'200':
description: Pricing.
headers:
Deprecation:
$ref: '#/components/headers/Deprecation'
Sunset:
$ref: '#/components/headers/Sunset'
content:
application/json:
schema:
type: object
tags:
- Boost
/api/v1/boost/checkout:
post:
summary: Create a Stripe checkout link for a boost
description: Returns a Stripe checkout URL for a human to pay by card. `amount_due` is read back from the Stripe session. The AGENTREADY agent promo is applied by default.
operationId: createBoostCheckout
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- serverId
properties:
serverId:
type: string
sku:
type: string
enum:
- priority_review
- featured_7d
- category_sponsor_7d
- premium_monthly
default: featured_7d
weeks:
type: integer
minimum: 1
maximum: 8
email:
type: string
format: email
coupon:
type: string
default: AGENTREADY
responses:
'200':
description: Checkout session created.
headers:
Deprecation:
$ref: '#/components/headers/Deprecation'
Sunset:
$ref: '#/components/headers/Sunset'
content:
application/json:
schema:
type: object
properties:
checkout_url:
type: string
format: uri
amount_due:
type:
- string
- 'null'
coupon_applied:
type: boolean
'400':
description: Invalid sku or listing not eligible.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Listing not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Category already sponsored.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Boost
/api/v1/boost/x402:
post:
summary: Buy a boost autonomously with x402 (USDC)
description: x402 v2, `exact` scheme, USDC on Base. Without a `PAYMENT-SIGNATURE` header this returns 402 with a base64 `PAYMENT-REQUIRED` header (and the same JSON body). Retry with `PAYMENT-SIGNATURE` to pay; the boost activates once payment settles and a `PAYMENT-RESPONSE` header carries the receipt. The price includes the 50% agent discount. Returns 503 while x402 is not enabled.
operationId: buyBoostX402
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- serverId
properties:
serverId:
type: string
sku:
type: string
enum:
- priority_review
- featured_7d
- category_sponsor_7d
default: featured_7d
weeks:
type: integer
minimum: 1
maximum: 8
email:
type: string
format: email
responses:
'200':
description: Paid and activated.
headers:
Deprecation:
$ref: '#/components/headers/Deprecation'
Sunset:
$ref: '#/components/headers/Sunset'
content:
application/json:
schema:
type: object
'400':
description: Invalid sku or listing not eligible.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Payment required, or the supplied payment was invalid (see `error`).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Listing not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Category already sponsored.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: x402 is not enabled.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Boost
components:
schemas:
Error:
type: object
required:
- error
- message
properties:
error:
type: string
description: Machine-readable error code, e.g. "not_found", "unauthorized", "insufficient_scope", "invalid_scope".
message:
type: string
description: Human-readable explanation suitable for surfacing to a user or logging.
details:
type: array
items: {}
description: Optional field-level validation issues (present on 400 responses to malformed request bodies).
status:
type: integer
description: Optional echo of the HTTP status code.
docs:
type: string
format: uri
description: Optional link to the relevant documentation for resolving this error.
headers:
Deprecation:
description: RFC 8594 style. Present (value "true") only once this specific operation is deprecated; absent otherwise. Not present on any current v1 operation.
schema:
type: string
enum:
- 'true'
Sunset:
description: RFC 8594 style. Present only once a removal date has been set for a deprecated operation, at least 90 days out. Absent otherwise.
schema:
type: string
format: date-time
securitySchemes:
agentBearerAuth:
type: oauth2
description: 'Bearer token minted via POST /api/v1/agent/register + /api/v1/agent/register/confirm (email-verified, no OAuth redirect flow). Send as `Authorization: Bearer amcp_...`. Also documented at /.well-known/oauth-protected-resource and /auth.md.'
flows:
clientCredentials:
tokenUrl: https://allmcps.com/api/v1/agent/register/confirm
scopes:
listings:claim: 'Claim ownership of an existing MCP server listing via DNS TXT record, site verification badge, or GitHub README badge proof. Grants no other write access. Required by: POST /api/v1/agent/claim, MCP tool: verify_mcp_claim (with an agentToken).'
checkout:write: 'Create, update, complete and cancel Agentic Commerce Protocol checkout sessions to buy listing boosts. Payment still needs a Stripe shared payment token the buyer granted; this scope alone cannot spend money. Required by: ACP: /api/acp/checkout_sessions (all endpoints).'