AgentPay .well Known API

The .well Known API from AgentPay — 8 operation(s) for .well known.

Operations 8

GET /.well-known/agentpay.json Well Known Agentpay #
GET /.well-known/agent.json Well Known Agent #
GET /.well-known/l402-services Well Known L402 Services #
GET /.well-known/x402 Well Known X402 #
GET /.well-known/402index-verify.txt Well Known 402Index Verify #
GET /.well-known/x402-trust.txt Well Known X402 Trust #
GET /.well-known/api-catalog Api Catalog #
GET /.well-known/mcp/server-card.json Mcp Server Card #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentpay-tools:agentpay-tools-well-known-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

agentpay-tools-well-known-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AgentPay Gateway .well Known API
  description: Buyer-side trust layer for x402 agents. verified_route ranks providers on paid delivery evidence and sybil-collapsed payer counts; pre_trade_check returns an ok/caution/avoid verdict before a trade; session_create opens a spend cap the gateway enforces for the paying wallet on Stacks and Base, with chain-verified receipts on a public ledger. USDC on Base and Stellar, sBTC or STX on Stacks (any Stacks x402 client).
  contact:
    name: AgentPay
    url: https://agentpay.tools/
    email: romudille@gmail.com
  version: 0.1.0
tags:
- name: .well Known
paths:
  /.well-known/agentpay.json:
    get:
      summary: Well Known Agentpay
      description: AgentPay manifest — discoverable by x402-aware agents.
      operationId: well_known_agentpay__well_known_agentpay_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known
  /.well-known/agent.json:
    get:
      summary: Well Known Agent
      description: A2A protocol card — agent-to-agent discovery.
      operationId: well_known_agent__well_known_agent_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known
  /.well-known/l402-services:
    get:
      summary: Well Known L402 Services
      description: 402index.io discovery document — lists all paid endpoints with pricing and request schemas.
      operationId: well_known_l402_services__well_known_l402_services_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known
  /.well-known/x402:
    get:
      summary: Well Known X402
      description: 'x402 protocol discovery manifest.

        Scanners and agents probing /.well-known/x402 find supported networks,

        assets, pricing range, and facilitator info here.'
      operationId: well_known_x402__well_known_x402_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known
  /.well-known/402index-verify.txt:
    get:
      summary: Well Known 402Index Verify
      description: 'Domain-verification file for 402index.io.


        Serves the SHA-256 hash from INDEX402_VERIFY_HASH as plain text. Returns

        404 when the env var is empty so the endpoint is harmless until claimed.'
      operationId: well_known_402index_verify__well_known_402index_verify_txt_get
      responses:
        '200':
          description: Successful Response
      security: []
      tags:
      - .well Known
  /.well-known/x402-trust.txt:
    get:
      summary: Well Known X402 Trust
      description: 'Domain-proof file for the x402-trust.com provider claim.


        One line, `x402-trust-verification=v1:`, re-checked by them

        on a schedule; the verified badge lapses if the file is missing for a

        week. Putting `x402-trust-remove` in the same file delists the whole

        host, so the content is fixed here and not composed from request input.'
      operationId: well_known_x402_trust__well_known_x402_trust_txt_get
      responses:
        '200':
          description: Successful Response
      security: []
      tags:
      - .well Known
  /.well-known/api-catalog:
    get:
      summary: Api Catalog
      description: RFC 9727 API catalog (linkset+json).
      operationId: api_catalog__well_known_api_catalog_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known
  /.well-known/mcp/server-card.json:
    get:
      summary: Mcp Server Card
      description: 'MCP Server Card (SEP-1649, schema still stabilizing) for the AgentPay

        MCP server: the remote Streamable-HTTP endpoint (keyless) and the local

        npm stdio server (wallet mode). `transport` stays for older readers.'
      operationId: mcp_server_card__well_known_mcp_server_card_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security: []
      tags:
      - .well Known