# Skill: Deploy RFC 9727 API Catalog Linkset

> **Standard:** RFC 9727
> **Category:** PROTOCOL_DISCOVERY
> **Classification:** SPECIFICATION_AND_GUIDE
> **Author:** TinyCTO Architecture Guild (https://tinycto.tv)

## Overview
Publish /.well-known/api-catalog using application/linkset+json to expose machine-readable OpenAPI and MCP service descriptions.

## Learning Objectives
1. Publish linkset at /.well-known/api-catalog.
2. Link service descriptions (OpenAPI, MCP, JSON Schema) with rel='service-desc'.
3. Set Content-Type: application/linkset+json; charset=utf-8.

## Prerequisites
- OpenAPI 3.0/3.1 or JSON Schema API definitions

## Implementation & Execution Guide

### Step 1: Publish Linkset JSON
Expose API specifications in RFC 9727 format.

```http
{
  "linkset": [
    {
      "anchor": "https://tinycto.tv",
      "service-desc": [
        {
          "href": "https://tinycto.tv/api/openapi.json",
          "type": "application/vnd.oai.openapi+json"
        }
      ]
    }
  ]
}
```

## Architectural Takeaway
RFC 9727 API Catalogs enable agents to automatically discover, read, and invoke your REST and MCP APIs.