---
title: "API Catalog | API catalog RFC 9727 linkset well-known | Agent-Ready Check"
description: "An API catalog lists your APIs and points at each one's description, documentation and status endpoint, using the RFC 9727 linkset format. Pass criteria: /.well-known/api-catalog returns application/linkset+json with at least one entry."
locale: en
canonical: https://agent-ready.t0ols.com/checks/api-catalog/
---

# API Catalog

> Category: API, Auth, MCP & Skill Discovery

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

## Why it matters

It is how an agent that has never seen your product finds out you have an API at all, without reading your marketing site.

## Pass criteria

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

## How to implement it

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

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

The step-by-step implementation prompt is part of the paid tier. The free layer gives you the diagnosis, the evidence and the specification links.

Specifications: https://www.rfc-editor.org/rfc/rfc9727
Implementation notes: https://agent-ready.t0ols.com/.well-known/agent-skills/api-catalog/SKILL.md