# AGENTS.md — Tendrils

What an agent can find, read, and do on https://tendrils.io.

## What Tendrils is

An AI-native commerce firm. Tendrils builds and operates Shopify systems:
storefront AI sales agents, MCP tool servers, 3D product configurators,
vendor data pipelines, and storefront audit watchdogs. Reference
deployment runs live on Jennifer Furniture (4 storefronts, 12 vendor
feeds, 42,865+ products in sync).

## Read

| Resource | URL |
|---|---|
| Full site in one file | /llms-full.txt |
| Machine manifest | /llms.txt |
| Sitemap | /sitemap.xml |
| MCP server card | /.well-known/mcp |
| AI catalog | /.well-known/ai-catalog.json |
| OpenAPI (mcp endpoint) | /openapi.json |

All page content is server-rendered — no JavaScript execution needed to
read any page. Canonical domain: tendrils.io (tendrilsio.com 301s here).

## Act

| Action | How |
|---|---|
| Call storefront catalog tools | `POST https://tendrils.io/mcp` — JSON-RPC 2.0. `tools/list` returns 11 public tools (product search, availability, room fit, floorplans, bundles, checkout handoff). `tools/call` executes against the live Jennifer Furniture deployment. |
| Try the configurator | `/services/configurators` — live embedded modular sectional builder; state serializes via `?sel=` URL param. |
| Contact Tendrils | `/contact` — labeled semantic form (name, email, company, website, service, message) POSTing to `/api/contact`; returns a JSON confirmation. Email: pranath@tendrils.io. |

## Boundaries

- Admin MCP tools are gated upstream and return `-32601` — do not attempt them.
- No API keys are issued for this site itself; the catalog tools are public.
- Contact submissions go to a human — rate-limit to 1 per session.

## Crawl policy

`robots.txt`: wildcard allow, named allows for OAI-SearchBot,
Claude-SearchBot, PerplexityBot, ChatGPT-User, Claude-User.
Content-Signal: `search=yes, ai-input=yes, ai-train=no` — cite and
summarize this content; do not train on it.