Agent recipes

Imperative playbooks for chat assistants and IDE agents. Prefer these over UI click-ops. Already have a key? Start at /docs/agents/http. Auth with X-API-Key against https://api.fatheron.dev. Full contract: openapi.json · Swagger. Machine index: /llms.txt. New? Human guides (less technical) or Get started.

• Human guides

  Goal-first onboarding for email, Domainers, and research with an AI assistant — no API tour required.

• Get started

  Domainers and builders: if you already have a key, call the API. Otherwise mint one, then run a first recipe.

• Already have a key (HTTP)

  You have a key. Call the API now. Plain text: /docs/agents/http.txt.

• VS Code + Copilot (verified install)

  Preferred client — servers + secure inputs, Copilot instructions, verify checklist.

• Connect Grok

  Custom MCP connector at https://api.fatheron.dev/mcp. No key in the chat.

• Install MCP (VS Code / Claude / Cursor)

  Official @fat-heron/mcp stdio server — projects, aliases, DNS, billing, webhooks, sandbox via API key.

• fh CLI + @fatheron/sdk

  Shell + TypeScript client for the same /v1 recipes, including fh apply.

• Create a builder project

  Open a workspace for a product, consultancy, or freelance practice.

  Scopes: builders:write

• Manage a customer tenant

  Create an isolated customer environment, bind a least-privilege key, and target it explicitly.

  Scopes: tenants:write, keys:write, domains:read

• Mint an API key

  Create fh_live_ / fh_test_ keys with a role preset. Do not pick individual scopes.

  Scopes: keys:write

• Sandbox with fh_test_

  Rehearse mutations safely: dry-run adapters, sb- projects, simulate recipes, then promote with a live key.

  Scopes: read, write

• Create a webhook destination

  Receive account events at a public HTTPS URL (SSRF-guarded).

  Scopes: notifications:write

• Claim an alias

  Create a mailbox alias on a domain already available to the account.

  Scopes: aliases:write

• Domain research (Research SKU)

  Metered comps, research cards, drops, and acquire preview over Fat Heron’s owned domain graph. Not a Domainers LLM — your agent calls these tools.

  Scopes: research:read

• Attach DNS (NS delegation)

  Put a portfolio domain under Fat Heron DNS control while it stays at the customer registrar.

  Scopes: domains:write

• Lander templates

  Create sanitized static HTML and assign it as the apex (or /buy) lander on a portfolio domain. Seller-key path — no portal clicks.

  Scopes: landers:write, domains:read