Agentgates Directory API

The Directory API from Agentgates — 7 operation(s) for directory.

Operations 8

GET /api/directory/docs Directory agent docs — search, list, review (markdown) #
GET /api/directory/resources Every x402 service, by kind, chain, rating and text #
GET /api/directory/resources/{id} One listing, its legs, and every review WITH ITS RECEIPT #
GET /api/directory/providers The same board grouped by provider (3,000 rows instead of 40,000) #
POST /api/directory/listings List a service. Free, and verified against its own 402 #
GET /api/directory/reviews The EXACT bytes to sign, and a single-use nonce #
POST /api/directory/reviews Submit a review. Gated on a settle read on chain #
GET /api/directory/reviewers/{wallet} What a wallet opinion weighs here, and the formula that says so #

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/agentgates-ai:agentgates-ai-directory-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

agentgates-ai-directory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agentgates Ai Directory API
  version: 1.0.0
  description: 'Operations tagged Directory across 2 of this provider''s published API definitions: agentgates-ai-openapi.json, agentgates-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agentgates.ai
tags:
- name: Directory
paths:
  /api/directory/docs:
    get:
      summary: Directory agent docs — search, list, review (markdown)
      responses:
        '200':
          description: Markdown for agents
      tags:
      - Directory
      operationId: getApiDirectoryDocs
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/resources:
    get:
      summary: Every x402 service, by kind, chain, rating and text
      description: Aggregated from the public registries. Every response carries pagination.total, the full category list with counts under the current search, and each source registry own sync state. Prices are PER LEG and never blended.
      parameters:
      - name: q
        in: query
        schema:
          type: string
        description: Free text over name, description, host and URL
      - name: category
        in: query
        schema:
          type: string
        description: A kind id from the categories block
      - name: chain
        in: query
        schema:
          type: string
        description: base | solana | polygon | arbitrum | ethereum | a raw chain id
      - name: rated
        in: query
        schema:
          type: string
          enum:
          - '1'
        description: Only services carrying a paid review
      - name: sort
        in: query
        schema:
          type: string
          enum:
          - rating
          - calls
          - newest
          - name
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 25
      - name: offset
        in: query
        schema:
          type: integer
          minimum: 0
          default: 0
      responses:
        '200':
          description: Listings, categories with counts, board state
      tags:
      - Directory
      operationId: getApiDirectoryResources
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/resources/{id}:
    get:
      summary: One listing, its legs, and every review WITH ITS RECEIPT
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: The row id, or the URL-encoded resource URL
      responses:
        '200':
          description: Listing + reviews
        '404':
          description: No such listing
      tags:
      - Directory
      operationId: getApiDirectoryResourcesById
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/providers:
    get:
      summary: The same board grouped by provider (3,000 rows instead of 40,000)
      parameters:
      - name: q
        in: query
        schema:
          type: string
      - name: category
        in: query
        schema:
          type: string
      - name: chain
        in: query
        schema:
          type: string
      - name: sort
        in: query
        schema:
          type: string
          enum:
          - calls
          - endpoints
          - rating
          - name
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 25
      - name: offset
        in: query
        schema:
          type: integer
          minimum: 0
          default: 0
      responses:
        '200':
          description: Providers with endpoint counts, traffic, price range and kinds
      tags:
      - Directory
      operationId: getApiDirectoryProviders
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/listings:
    post:
      summary: List a service. Free, and verified against its own 402
      description: We fetch the URL. It must answer 402 with an `accepts` block, and the prices stored come from THAT answer. There is no listing fee and no field where a price is typed in.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - resource
              properties:
                resource:
                  type: string
                  format: uri
                name:
                  type: string
                description:
                  type: string
                tags:
                  type: array
                  items:
                    type: string
      responses:
        '200':
          description: Already listed, refreshed from its 402
        '201':
          description: Listed
        '422':
          description: unreachable | not_x402 | no_accepts | no_legs
      tags:
      - Directory
      operationId: postApiDirectoryListings
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/reviews:
    get:
      summary: The EXACT bytes to sign, and a single-use nonce
      description: The server owns the statement format. A client that builds it gets one character wrong eventually, and a wrong character is an unreadable refusal AFTER the wallet ceremony.
      parameters:
      - name: resource
        in: query
        required: true
        schema:
          type: string
          format: uri
      - name: wallet
        in: query
        required: true
        schema:
          type: string
      - name: chainId
        in: query
        schema:
          type: integer
      - name: tx
        in: query
        schema:
          type: string
        description: The settle hash being reviewed
      - name: rating
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 5
      - name: body
        in: query
        schema:
          type: string
      responses:
        '200':
          description: statement, nonce, issuedAt, and the rules
      tags:
      - Directory
      operationId: getApiDirectoryReviews
      x-operation-id-source: derived
    post:
      summary: Submit a review. Gated on a settle read on chain
      description: 'Five gates, in order: the settle is real; it paid THIS resource; you are the payer (read from the TRANSFER LOG, never tx.from, because x402 exact is relayed); you are not the payee; one settle carries one review.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - resource
              - rating
              - body
              - chainId
              - txHash
              - wallet
              - signature
              - nonce
              - issuedAt
              properties:
                resource:
                  type: string
                  format: uri
                rating:
                  type: integer
                  minimum: 1
                  maximum: 5
                body:
                  type: string
                chainId:
                  type: integer
                txHash:
                  type: string
                wallet:
                  type: string
                signature:
                  type: string
                  description: EIP-191 on EVM; base58 ed25519 detached on Solana
                nonce:
                  type: string
                issuedAt:
                  type: string
                  format: date-time
      responses:
        '201':
          description: Recorded, with the receipt read from chain
        '403':
          description: wallet_mismatch | self_review | sanctioned
        '409':
          description: receipt_pending (retryable) | duplicate_settle | replayed_nonce
        '422':
          description: receipt_invalid | receipt_too_old
      tags:
      - Directory
      operationId: postApiDirectoryReviews
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
  /api/directory/reviewers/{wallet}:
    get:
      summary: What a wallet opinion weighs here, and the formula that says so
      parameters:
      - name: wallet
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: settles, distinctPayees, weight, the live coefficients, and the receipts
      tags:
      - Directory
      operationId: getApiDirectoryReviewersByWallet
      x-operation-id-source: derived
    servers:
    - url: https://agentgates.ai
externalDocs:
  description: Machine index (llms.txt)
  url: https://agentgates.ai/llms.txt
x-refined-from:
- agentgates-ai-openapi.json
- agentgates-ai-openapi.json