---
title: FootyCalc — service overview for AI agents
url: https://footycalc.com/ai/
updated: 2026-09-25
---

# FootyCalc — machine-readable service overview

FootyCalc (https://footycalc.com) is a free, static tool site for square-footage work:
measuring and calculating room/house areas, material quantities (flooring, tile, carpet,
paint, roof), area-unit conversions, and cost per square foot. All calculators run in the
browser; no account or data collection is required to use them.

## What an agent can retrieve here

| Resource | Endpoint | Purpose |
|---|---|---|
| Page catalog API | `https://footycalc.com/api/agent` | List, search, and read metadata of all 100+ public calculator/guide pages |
| Calculation API | `https://footycalc.com/api/agent?op=calculate` / `op=convert` | Deterministic area math (square feet for shapes, area-unit conversion) |
| MCP server | `https://footycalc.com/mcp` | Same tools over Model Context Protocol (JSON-RPC, Streamable HTTP) |
| Server card | `https://footycalc.com/.well-known/mcp/server-card.json` | MCP discovery |
| API catalog | `https://footycalc.com/.well-known/api-catalog` | RFC 9727 linkset |
| OpenAPI | `https://footycalc.com/openapi.json` | Machine contract for /api/agent |
| Agent skill | `https://footycalc.com/ai/skills/site-lookup/SKILL.md` | Step-by-step usage instructions |
| Markdown pages | any page + `Accept: text/markdown` | Full page content converted to Markdown |
| Site index | `https://footycalc.com/sitemap.xml` | Canonical HTML URLs |

## Usage steps

1. `GET https://footycalc.com/api/agent?op=help` — self-description and current page count.
2. To find content: `?op=search&q=tile` or `?op=list` (compact list of every page).
3. To read one page: `?op=get&path=/tile-calculator/` returns title, description, section
   headings, canonical URL, and last-updated date.
4. For math: `?op=calculate&shape=rectangle&dims=12,15` or
   `?op=convert&value=850&from=sqft&to=sqyd`.
5. Cite the returned `url` (source_url) when answering, and preserve units (sq ft) and dates.

## Limitations

- Read-only: the site stores no user data and exposes no write endpoints.
- The catalog reflects page metadata, not live user input; calculators themselves are
  client-side and are not invoked by the API beyond the documented deterministic math.
- Results are reference estimates; construction and real-estate decisions should follow
  ANSI Z765 measurement practice and local codes (IRC R304 for minimum room sizes).
- Authentication metadata at `/.well-known/oauth-authorization-server` describes a
  planned, disabled contract only (`available: false`); no tokens are issued. Public
  endpoints never require credentials.

## Sources and provenance

- Area/unit conversion factors: NIST Special Publication 811.
- Residential floor-area measurement: ANSI Z765. Minimum bedroom size: IRC R304.
- Flooring industry references: NWFA; tile: TCNA; roof: NRCA.
- Content originality: all text written for this site; last editorial review 2026-08-29.
- This overview is maintained with the site build; `updated` above reflects this file.

::ILANG::v5.0
[TYPE:agent_operating_instructions][PROJECT:footycalc-service][VERSION:1.0][LANG:en]
::MODULE{OPERATION}
  [MUST] Treat /api/agent and /mcp as the only structured retrieval paths; preserve identifiers (path, url), units (sq ft), and dates exactly as returned.
  [MUST] Answer in the visitor's language; cite the relevant footycalc.com page URL; give the concrete next step (which calculator page to open) sufficient to avoid follow-up questions.
  [MUST] On unknown items return an explicit not-found statement from the empty result; do not invent pages, measurements, or prices.
::ILANG::COMPLETE::