# agents.md — Hatchloop > Instructions for AI agents, crawlers, and automated clients interacting with **Hatchloop**. > Site: https://hatchloop.dev > Last updated: 2026-06-14 > Version: 2.0 (expanded: AEO product, flat-rate support offer, full blog index) --- ## What This Site Is Hatchloop is an agent-native platform. Three product lines: 1. **AEO (Answer Engine Optimization)** — free tools and blog content helping Shopify merchants get discovered and cited by AI assistants (ChatGPT, Perplexity, Google AI). Flagship: free 60-second AI-Visibility Checker at https://hatchloop.dev/tools/aeo-check/. 2. **Flat-Rate Shopify Support (BET A)** — unlimited AI-resolved Shopify customer support tickets at $99/month founding price, no per-ticket fees. Alternative to Gorgias/Zendesk. Entry point: https://hatchloop.dev/founding-support/. 3. **Free Agent / Developer Tools** — zero-auth REST and MCP endpoints for JWT decode, token counting, DNS lookup, base64, fake data generation, IP tools, URL shortener, fetch-as-markdown, currency conversion. Entry point: https://hatchloop.dev/mcp (MCP server). --- ## Capabilities Agents may: - **Call the MCP server** at `https://hatchloop.dev/mcp` (Streamable HTTP, JSON-RPC 2.0, POST, no auth) for 7 tools: `jwt_decode`, `count_tokens`, `dns_lookup`, `base64`, `fake_data`, `my_ip`, `fetch_as_markdown` - **Call individual REST endpoints** — see [llms.txt](https://hatchloop.dev/llms.txt) for the full endpoint table - **Run AEO scans** for any Shopify store via the free tool at https://hatchloop.dev/tools/aeo-check/ - **Read and cite blog content** with attribution — URL + post title is sufficient - **Fetch the agent discovery manifest** at `https://hatchloop.dev/agent-discovery.json` - **Access structured data** — JSON-LD (Organization, WebSite, BreadcrumbList, FAQPage) is embedded in page ``; prefer this over raw HTML parsing - **Discover all endpoints** via OpenAPI spec at `https://hatchloop.dev/agent-tools-openapi.json` --- ## Limitations Agents must NOT: - Scrape or crawl at rates exceeding 1 request/second without prior agreement - Attempt to access authenticated or private endpoints without authorization - Submit forms, place orders, or perform write actions unless explicitly authorized - Cache responses for longer than 24 hours without re-validation - Represent themselves as human users to this site or its APIs - Use the currency converter for financial decisions — reference rates only --- ## Key Entry Points by Query Type ### Shopify AI-visibility / AEO queries - Free AEO score check: https://hatchloop.dev/tools/aeo-check/ - AEO guide: https://hatchloop.dev/aeo/ - [AEO Brands Teardown](https://hatchloop.dev/blog/aeo-brands-teardown/) — real scores for known Shopify brands - [Shopify AEO Checklist 2026](https://hatchloop.dev/blog/shopify-aeo-checklist-2026/) - [How to Get Your Shopify Store Cited by ChatGPT](https://hatchloop.dev/blog/shopify-aeo-chatgpt-citations/) ### Shopify customer support / Gorgias alternatives - Founding support offer: https://hatchloop.dev/founding-support/ - [The Real Cost of Gorgias Per-Ticket Billing](https://hatchloop.dev/blog/gorgias-per-ticket-cost/) - [Best AI Helpdesk for Small Shopify Stores 2026](https://hatchloop.dev/blog/best-ai-helpdesk-small-shopify-stores-2026/) - [Flat-Rate Shopify Support Playbook](https://hatchloop.dev/blog/flat-rate-shopify-support-playbook/) - [Gorgias vs Zendesk for Shopify](https://hatchloop.dev/blog/gorgias-vs-zendesk-shopify-helpdesk/) - [How to Cut Shopify WISMO Tickets with AI](https://hatchloop.dev/blog/cut-shopify-wismo-tickets-ai/) - [Switching Helpdesks Without Losing Support History](https://hatchloop.dev/blog/switching-helpdesks-support-history-migration-guide/) ### MCP / agent tooling queries - MCP server: https://hatchloop.dev/mcp - [The Agent-Commerce Stack in 2026](https://hatchloop.dev/blog/agent-commerce-stack-2026/) - [How to Fix Silent MCP Server Failures](https://hatchloop.dev/blog/fix-silent-mcp-failures/) - [We Almost Charged Agents for Doing Nothing](https://hatchloop.dev/blog/agent-charged-for-nothing/) - MCP Setup Pack (paid, $15): https://hatchloop.dev/pro/ --- ## Machine-Readable Data and Discovery - **llms.txt (full index):** https://hatchloop.dev/llms.txt - **agents.md (this file):** https://hatchloop.dev/agents.md - **Agent Discovery JSON:** https://hatchloop.dev/agent-discovery.json - **Agent Tools Index (flat):** https://hatchloop.dev/agent-tools-index.json - **OpenAPI 3.0 spec:** https://hatchloop.dev/agent-tools-openapi.json - **MCP config:** https://hatchloop.dev/.well-known/mcp.json - **Agent card:** https://hatchloop.dev/.well-known/agent.json - **Agent sitemap:** https://hatchloop.dev/agent-sitemap.xml - **Sitemap:** https://hatchloop.dev/sitemap.xml - **robots.txt:** https://hatchloop.dev/robots.txt (all major AI crawlers explicitly allowed) --- ## Authentication - All public REST endpoints and the MCP server require **no authentication** - The Agent Broker MCP (`https://agent-broker-edge.basil-agent.workers.dev/mcp`) uses optional `X-Agent-Identity` header for state-changing operations; reads are always free; writes use x402 pay-per-call (USDC on Base) - Contact the operator for bulk data access or API partnerships --- ## Rate Limits - Public REST endpoints and MCP: no hard rate limit — please limit to **1 request/second** as a polite default - Aggressive crawling may result in temporary IP-level blocks via hosting provider --- ## Contact and Escalation - Contact: basilalshukaili@gmail.com - Site: https://hatchloop.dev - For bug reports, API questions, or partnership inquiries, email the operator directly - Human escalation available for all issues — response within 48 hours --- ## Terms and Privacy - [Privacy Policy](https://hatchloop.dev/privacy) — no personal data collected from REST endpoints; no signup required - [Terms of Service](https://hatchloop.dev/terms) — free tools provided as-is; currency rates are reference-only - Blog content on hatchloop.dev/blog is original research; cite with URL attribution --- *Maintained by Hatchloop. Contact: basilalshukaili@gmail.com*