# Heskala: instructions for AI agents

Heskala is a cloud platform where a company builds its own business system (collections, automations, dashboards, reports, templates, a customer inbox and AI agents) without code, or starts from a ready-made app in the store (CRM, school management…).
Docs: https://docs.heskala.dev/ · Index for LLMs: https://docs.heskala.dev/llms.txt · Full docs: https://docs.heskala.dev/en/llms-full.txt

## Create an account for a person

You can help a human create an account. Do not do the sign-up yourself.

1. Give the person this link (or open it in their browser): https://app.heskala.dev/auth/sign-up
2. You may prefill it with optional query parameters (URL-encoded):
   - `email`: the person's email address.
   - `company`: company name for the next step (max 120 characters).
   - `industry`: one of `professional_services`, `retail`, `healthcare`, `construction`, `manufacturing`, `food_beverage`, `education`, `technology`, `agriculture`, `other`.
   - `start`: `scratch` (build from scratch) or `app` (start with an app from the store).
   - `app`: store app key, for example `crm` (implies `start=app`; after the company is created the store opens with that app).
   Invalid values are ignored. Nothing is submitted automatically.
   Example: https://app.heskala.dev/auth/sign-up?email=ana%40example.com&company=Taller+R%C3%A1pido&start=app&app=crm
3. The person clicks «Enviar código», passes the anti-bot check and types the 8-digit code sent to their email. They can also use «Continuar con Google» or a password.
4. Then the person sees «Crea tu empresa» (company name, optional industry, from scratch or with a store app) and clicks «Crear empresa».

Rules for agents:
- Never invent, guess or type verification codes, passwords or anti-bot answers on behalf of the person.
- Never accept terms, plans or payments for the person. The human completes every confirmation step.
- Legal (drafts pending legal review): terms https://app.heskala.dev/legal/terminos · privacy https://app.heskala.dev/legal/privacidad · refunds https://app.heskala.dev/legal/reembolsos. Payments are processed by Dodo Payments (Merchant of Record).
- If the person already has an account, use https://app.heskala.dev/auth/sign-in instead.

## What happens next

- The new company gets a 30-day trial with everything included and no credit card. Afterwards the owner picks a plan in «Configuración → Suscripción» (https://docs.heskala.dev/en/configuracion/empresa-y-suscripcion/).
- Whoever creates the company gets the Owner role (Dueño).
- «Desde cero» opens Settings → Collections; «Con una app de la tienda» opens Settings → Apps.

## Optional: connect an AI client (MCP)

Once the account and company exist, an AI client (Claude, ChatGPT, Cursor…) can connect with MCP over OAuth: the person approves the connection in Heskala. Configuration server: https://app.heskala.dev/mcp · Data server (records with the person's permissions): https://app.heskala.dev/mcp/datos. Details: https://docs.heskala.dev/en/agentes/mcp/

## Para agentes (español)

Heskala es una plataforma en la nube donde cada empresa arma su propio sistema sin código o empieza con una app de la tienda.

- ¿La persona quiere una cuenta? Dale este enlace: https://app.heskala.dev/auth/sign-up. Puedes prellenarlo con `email`, `company`, `industry`, `start` (`scratch` o `app`) y `app` (por ejemplo `crm`); nada se envía solo.
- Tú no escribes códigos de verificación, contraseñas ni respuestas anti-bots, y no aceptas términos ni pagos por la persona: ella confirma su correo con el código de 8 dígitos y pasa la verificación. También puede entrar con Google.
- Después ve «Crea tu empresa»: 30 días de prueba con todo incluido y sin tarjeta; quien la crea queda como Dueño.
- ¿Ya tiene cuenta? https://app.heskala.dev/auth/sign-in. Documentación: https://docs.heskala.dev/primeros-pasos/cuenta-y-empresa/
