---
title: "Auth.md | auth.md agent registration metadata | Agent-Ready Check"
description: "auth.md is a short markdown document describing how an agent registers and authenticates. It is prose, which is exactly why it works: both humans and models read it directly. Pass criteria: /auth.md exists with a markdown H1 mentioning auth.md."
locale: en
canonical: https://agent-ready.t0ols.com/checks/auth-md/
---

# Auth.md

> Category: API, Auth, MCP & Skill Discovery

auth.md is a short markdown document describing how an agent registers and authenticates. It is prose, which is exactly why it works: both humans and models read it directly.

## Why it matters

It can also state the opposite: that your API is public and needs no credentials, which saves an agent a pointless registration flow.

## Pass criteria

/auth.md exists with a markdown H1 mentioning auth.md.

## How to implement it

Goal: Publish Auth.md metadata for agent registration

/auth.md exists with a markdown H1 mentioning auth.md.

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://workos.com/auth-md
Implementation notes: https://agent-ready.t0ols.com/.well-known/agent-skills/auth-md/SKILL.md