Anchor Terminal Verify API

openapi: 3.2.0
info:
  title: Anchorterminal Verify API
  version: 1.0.0
  contact:
    email: agents@anchorterminal.com
    name: Anchor Terminal
    url: https://www.anchorterminal.com/agents/
  license:
    name: CC-BY-4.0
    url: https://creativecommons.org/licenses/by/4.0/
  termsOfService: https://www.anchorterminal.com/terms/
  description: 'Operations tagged Verify across 2 of this provider''s published API definitions: anchorterminal-openapi.json, anchorterminal-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.anchorterminal.com
tags:
- name: Verify
paths:
  /api/v1/verify:
    post:
      description: 'A vendor proves a listing is theirs, and that they know it''s here, with the Anchor badge (/badges/{slug}.svg) or a plain link to the listing (/tools/{slug}) on a page they control. The server fetches url once: public addresses only, no credentials, at most 2 MB, at most three redirects and all on the same registrable domain, 15 seconds. It accepts the page when it''s on the listing''s provenance domain, the host of its vendorUrl or its company domain (or a subdomain), or is the README of the listing''s own repository on github.com (the repository page or its raw README), and when it has a link whose href is the listing URL (with or without www., http or https, trailing slash or not) or an image whose src is the badge URL. The page is re-checked weekly; two failed checks in a row and the verification lapses, and a later pass restores it. It never changes a grade, rank or review. JSON or a form post (a form gets a small page back); ten an hour per address and twenty a day per listing. The verify_listing tool on /mcp takes the same fields. A GET answers 405 with the field list.'
      operationId: verifyListing
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/VerifyRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyResult'
          description: Verified
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyError'
          description: A field is missing or wrong, or the address isn't on the public internet
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyError'
          description: No such listing
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifyError'
          description: 'A check failed: error is wrong_domain, no_link or fetch_failed (with status when the page answered with one), and detail says what to change'
        '429':
          description: Ten an hour per address or twenty a day per listing; Retry-After says when
      summary: Verify a listing as its vendor
      tags:
      - Verify
    servers:
    - url: https://www.anchorterminal.com
components:
  schemas:
    VerifyError:
      properties:
        detail:
          type: string
        error:
          enum:
          - bad_request
          - private_address
          - not_found
          - wrong_domain
          - no_link
          - fetch_failed
          - rate_limited
          type: string
        field:
          type: string
        ok:
          type: boolean
        slug:
          type: string
        status:
          description: The HTTP status the page answered with, when it answered
          type: integer
        url:
          type: string
      type: object
    VerifyResult:
      properties:
        listing:
          type: string
        method:
          enum:
          - badge
          - link
          type: string
        note:
          type: string
        ok:
          type: boolean
        recheck:
          type: string
        since:
          format: date
          type: string
        slug:
          type: string
        url:
          type: string
        verifiedAt:
          format: date-time
          type: string
      type: object
    VerifyRequest:
      properties:
        slug:
          description: The listing's slug, e.g. exa-mcp, or its page's URL
          maxLength: 200
          type: string
        url:
          description: 'The page with the badge or the link: on the listing''s own domain, or the README of its repository on github.com'
          format: uri
          maxLength: 2000
          type: string
      required:
      - slug
      - url
      type: object
externalDocs:
  description: Human and agent documentation
  url: https://www.anchorterminal.com/docs/
x-refined-from:
- anchorterminal-openapi.json
- anchorterminal-openapi.yml