# Uso desde agentes de IA

Esta documentación está escrita para que la lean personas y máquinas. Todo lo que necesita un agente está disponible como texto plano.

## Documentación legible por máquinas

| Recurso | URL | Para qué sirve |
| --- | --- | --- |
| `llms.txt` | [`/es/llms.txt`](https://docs.salchimail.com/es/llms.txt) | Un índice de la documentación con una línea por página |
| `llms-full.txt` | [`/es/llms-full.txt`](https://docs.salchimail.com/es/llms-full.txt) | Todas las guías y la referencia de la API en un solo fichero |
| Páginas en Markdown | Añade `.md` a la URL de cualquier página, por ejemplo [`/es/inicio-rapido.md`](https://docs.salchimail.com/es/inicio-rapido.md) | Leer una página sin HTML |
| Referencia de la API en Markdown | [`/reference.md`](https://docs.salchimail.com/reference.md) (en inglés) | Todas las operaciones, esquemas y ejemplos |
| OpenAPI 3.1 | [`/openapi.json`](https://docs.salchimail.com/openapi.json) · [`/openapi.yaml`](https://docs.salchimail.com/openapi.yaml) | Generar clientes y definiciones de herramientas |

Todos se sirven con `Access-Control-Allow-Origin: *`.

## Servidor MCP

**Próximamente.** Un servidor MCP remoto en `mcp.salchimail.com` permitirá a un agente verificar direcciones, lanzar lotes y consultar el uso con tu clave de API. Esta página lo enlazará cuando esté disponible.

## Skill para agentes

**Próximamente.** Una skill que enseña a un asistente de programación a integrar SalchiMail. Esta página la enlazará cuando esté disponible.

Hasta que existan, apunta tu agente a [`/es/llms.txt`](https://docs.salchimail.com/es/llms.txt) o al contrato OpenAPI: basta para llamar a la API correctamente.

## Reglas para tu agente

Si escribes tú las instrucciones, incluye estas:

- La clave de API es un secreto. Léela de una variable de entorno, envíala solo a `https://api.salchimail.com` y no la imprimas nunca.
- Construye y prueba con una clave `sk_test_`: los resultados son simulados y no se consumen créditos ([Entorno de pruebas](https://docs.salchimail.com/es/entorno-de-pruebas.md)).
- Nunca trates `unknown` como `invalid` ([Veredictos y reason codes](https://docs.salchimail.com/es/veredictos.md)).
- Para más de unas pocas direcciones, crea un lote en lugar de repetir `POST /verify` ([Limpieza de listas por lotes](https://docs.salchimail.com/es/lotes.md)).
- Envía una `Idempotency-Key` en cada `POST` y reutilízala en los reintentos ([Idempotencia](https://docs.salchimail.com/es/idempotencia.md)).
- Decide según `verdict`, `reason_code` y el `code` del error. Nunca analices `reason` ni `message`.
- Una verificación nunca envía un email. No digas a los usuarios que se ha enviado un mensaje a la dirección.
