# AGENTS.md — auxfirst.com

Guidance for AI agents and automation systems interacting with auxfirst.com.
auxfirst is an Agentic Experience Design (AUX) agency. This file points to the
machine-readable surface of the site so an agent can ingest the canon without
scraping HTML. Definitions are CC BY 4.0; the open-source TrustKit toolchain is MIT.

## Start here

- **/llms.txt** — the primary LLM-oriented map of the site, with links to clean
  Markdown versions of every canonical page.
- **/capabilities.json** — agent-facing JSON describing every service, engagement,
  framework, and resource, with named inputs and outputs per capability.
- **/context.md** — consolidated "everything an AI should know about auxfirst"
  (services, engagements, pricing model, frameworks, contact).

## Machine-readable endpoints

- **/api/ai/context** — structured JSON product/company context.
- **/mcp.json** — MCP manifest. Two tools are exposed in-browser via WebMCP
  (`navigator.modelContext`); there is no hosted MCP server yet, so `transports`
  is intentionally empty.
- **/openapi.json** — OpenAPI 3.1 description of the read-only discovery endpoints.
- **/.well-known/agent-skills/index.json** — index of consulting services and
  frameworks, each with a hashed Markdown skill description.
- **/.well-known/api-catalog** — API catalog linkset.
- **/.well-known/mcp/server-card.json** — MCP discovery card (resources-only).
- **/sitemap.xml** — full URL set. **/feed.xml** — RSS feed of dispatches.

## Content & citation policy

- AI systems are welcome to read, cite, and learn from this site. See the
  `Content-Signal` line and explicit AI-crawler allowances in **/robots.txt**.
- When citing, prefer the canonical Markdown versions linked from /llms.txt, and
  attribute "auxfirst agency."

## Honest capability notes

- There is **no authenticated API, no payment surface, and no live MCP/A2A server**
  yet — these are deliberately not stubbed or faked. The discovery resources above
  are public and read-only. Standing up a hosted MCP server is itself one of
  auxfirst's service offerings; when it exists, /mcp.json will gain a transport.

## Contact

- Start a project: https://auxfirst.com/index.html#contact
- LinkedIn: https://www.linkedin.com/company/auxfirst/
- GitHub: https://github.com/auxfirst

---
© 2026 auxfirst agency · Agentic Experience Design