What is pricing.md, and should you publish your prices?
pricing.md is a machine-readable pricing file at the root of a domain, giving an agent your prices in a form it can parse rather than infer. It matters because an agent comparing suppliers can only include options it can cost, so a business with no readable pricing is invisible at the moment of comparison, no matter how well it ranks.
The honest trade-off
Plenty of businesses deliberately do not publish prices, and the reasons are real: scope varies, competitors watch, and a number without context invites the wrong conversation. This is not an argument that everyone should publish.
It is an argument for deciding rather than defaulting. The cost of not publishing used to be a slightly longer sales conversation. The cost now includes being omitted from comparisons made by a machine that will not ring you to ask.
What to publish if you do
Bands rather than a single number work fine, and are more honest for project work. What matters is that the shape is parseable: what the thing is, what it costs, what changes the cost, and what is excluded.
The exclusions are the part that prevents the wrong conversation. An agent that can read 'from twelve thousand, excluding third-party licences, assumes an existing CRM' will qualify better than one working from a bare figure.
Keep the page and the file in agreement
Scanners check both a human-readable pricing page and the machine-readable file. Two sources that disagree is worse than one, and it is the most common failure once a team has added the file and then updated only the page.
Generate both from one source if you can. Hand-maintained duplicates drift within a quarter.
# Pricing
All projects are fixed-price against an agreed scope.
## Survey and specification
GBP 1,200 to 2,500. Two to three weeks.
Excludes: travel outside the UK mainland.
## Installation
GBP 8,000 to 25,000. Six to ten weeks.
Drivers: number of units, existing plant condition, out-of-hours access.
Excludes: builders' work, electrical supply upgrades.
## Servicing
From GBP 180 per visit, or GBP 1,900 per year on contract.
Last updated: 2026-09-16Does your site have this?
The free checker scores your site against pricing.md and everything else on this list, out of 100, in about ten seconds. It names what is missing rather than handing you a number.
Common questions
- Where does pricing.md go?
- At the root of the domain, served at /pricing.md as text/markdown. It should agree with whatever your human-readable pricing page says.
- Do I have to publish exact prices?
- No. Bands with the drivers that move them, and clear exclusions, are more useful than a single number and more honest for project work. What matters is that an agent can cost you at all.
Sources
The rest of the reference
- llms.txtWhat is llms.txt, and does it actually do anything?
- agent-card.jsonWhat is agent-card.json, and do you need one?
- WebMCPWhat is WebMCP? Tools on your web page, no server required
- ARD catalogWhat is an ARD catalog (ard.json)?
- Markdown twinsHow to serve markdown to AI agents (and why .md matters)
- robots.txt for AIHow to write robots.txt for AI crawlers
- Web Bot AuthWhat is Web Bot Auth? Letting good agents identify themselves
- MCP server cardWhat is server-card.json, and how do agents find your MCP server?
- auth.mdWhat is auth.md, and what if nothing needs authentication?