---
name: api-catalog
title: API Catalog
category: discovery
---

# API Catalog

An API catalog lists your APIs and points at each one's description, documentation and status endpoint, using the RFC 9727 linkset format.

## When to use this skill

Use this when a site fails the "API Catalog" check and you need to implement it.

## Goal

Publish an API catalog for automated API discovery (RFC 9727)

## Pass criteria

/.well-known/api-catalog returns application/linkset+json with at least one entry.

## Implementation

This skill covers the diagnosis. The step-by-step implementation prompt is part
of the paid tier and is served per scan by the API — see https://agent-ready.t0ols.com/llms-full.txt.

## Specifications

- https://www.rfc-editor.org/rfc/rfc9727

## Verifying

Re-run the scan against the site and confirm the check reports a pass:

    curl -s https://agent-ready.t0ols.com/api/scan \
      -H 'content-type: application/json' \
      -d '{"url":"https://example.com","enabledChecks":["apiCatalog"]}'