# Fix: A human/agent usage doc for the server resolves

> Web-audit fix skill for the `mcp-usage-doc` check (MCP & API, MAY).

## Goal

Publish a one-fetch markdown usage doc for your MCP server.

## Fix

Link a short markdown usage doc for your MCP server (curl examples, the tool list, auth, and
rate limits) at a stable path such as `/mcp-skill.md`, `/mcp.md`, or `/.well-known/mcp/usage.md`,
and reference it from the server card and `llms.txt`. It gives an agent a one-fetch orientation.

## Resources

- [anc.dev example](https://anc.dev/mcp-skill.md)

## 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: Publish a one-fetch markdown usage doc for your MCP server
Issue: <the audit's finding for this check>
Fix: Link a short markdown usage doc for your MCP server (curl examples, the tool list, auth, and rate limits) at a stable path such as `/mcp-skill.md`, `/mcp.md`, or `/.well-known/mcp/usage.md`, and reference it from the server card and `llms.txt`. It gives an agent a one-fetch orientation.
Skill: https://anc.dev/web-audit/skill/mcp-usage-doc
Docs: https://anc.dev/mcp-skill.md
```

## Verify

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