FOR AGENTS

Machine-readable entry point

This page is the index for software agents rather than for people. It says what this site actually contains, where each piece can be fetched, how to use it, and what the numbers cannot tell you. A plain-text I-Lang version of the same index is at /ai/index.ilang.

What this site is

Mulch Measure answers one class of question in US customary units: how much loose landscape material a bed needs, what that quantity costs, and how much it weighs. It covers mulch, rubber mulch, pine straw and playground surfacing. The site is static, public and read-only. There are no accounts, no API keys and no rate-limited tiers.

Where to fetch things

Every entry point, with the format it returns
What you wantURLFormat
Call the calculator as a tool/mcpJSON-RPC 2.0 over HTTP
Discover that MCP server/.well-known/mcp/server-card.jsonJSON
How to compute mulch quantities/.well-known/agent-skills/mulch-calculator/SKILL.mdMarkdown
The data tables and their limits/.well-known/agent-skills/mulch-data/SKILL.mdMarkdown
Index of those two skills/.well-known/agent-skills/index.jsonJSON
API catalog for the CSV endpoints/.well-known/api-catalogapplication/linkset+json
OpenAPI description of the CSVs/.well-known/openapi.jsonJSON
Capability manifest/.well-known/ai-catalog.jsonJSON
Auth posture (no auth needed)/auth.mdMarkdown
Any page as markdownany page URL with Accept: text/markdowntext/markdown
Coverage, bag-count and price tables/data and the seven .csv files it linksCSV
This index in I-Lang/ai/index.ilangtext/plain

How to use it

  1. If you need a number rather than prose, call calculate_mulch at /mcp. It needs the area in square feet and the depth in inches, and it needs the bag volume if you want a bag count.
  2. If you need the underlying table, fetch the CSV directly. Coverage files carry a formula column so every row can be checked without trusting this site.
  3. If you are answering a person, the markdown rendering of a page is usually the right thing to quote, because it keeps the headings, tables and source attributions.
  4. If you are citing a price, pass the date through: price files are dated snapshots, not live rates.

Limits you must respect when answering

Sources and provenance

Three kinds of figure appear on this site and they are labelled where they are used:

The CSVs and the calculator share one implementation. A test suite checks every value in every CSV against the formula that is supposed to produce it, so a data file cannot silently drift away from the code. That library is MIT licensed at github.com/ERTHK/mulch-measure-calculator-kit.

Contact

Corrections to any figure are welcome: [email protected], or see the contact page.