# Fix: /.well-known/api-catalog published (RFC 9727)

> Web-audit fix skill for the `api-catalog` check (MCP & API, MAY).

## Goal

Serve an RFC 9727 api-catalog linkset indexing your API descriptions.

## Fix

Serve `/.well-known/api-catalog` (RFC 9727) as `application/linkset+json` with a `linkset[]` of
anchor plus `service-desc` entries. It is the standard index that points agents at every API
description you publish.

## Resources

- [RFC 9727](https://www.rfc-editor.org/rfc/rfc9727)

## Copy-paste prompt

Paste this into your coding agent, replacing the Issue line with the Result line from [your audit](https://anc.dev/web-audit):

```text
Goal: Serve an RFC 9727 api-catalog linkset indexing your API descriptions
Issue: <the audit's finding for this check>
Fix: Serve `/.well-known/api-catalog` (RFC 9727) as `application/linkset+json` with a `linkset[]` of anchor plus `service-desc` entries. It is the standard index that points agents at every API description you publish.
Skill: https://anc.dev/web-audit/skill/api-catalog
Docs: https://www.rfc-editor.org/rfc/rfc9727
```

## Verify

Re-run the audit at [https://anc.dev/web-audit](https://anc.dev/web-audit) or call the `audit_website` MCP tool; the `api-catalog` check should report `pass`.
