# Atmos API

> API pública REST + servidor MCP del CRM Atmos. Autenticación M2M con un token
> `at-api-…` emitido por un administrador del portal. Los identificadores son
> friendlyId (C0001, N0002…), nunca UUID.

## Documentación

- [Referencia completa en markdown](https://docs.atmos.com.mx/llms-full.txt): todos los endpoints, autenticación, errores y paginación.
- [Misma referencia como .md](https://docs.atmos.com.mx/index.md): idéntico contenido, extensión markdown.
- [OpenAPI 3.1 (JSON)](https://docs.atmos.com.mx/api/docs/openapi.json): contrato completo, consumible por SDKs y generadores.
- [Referencia interactiva](https://docs.atmos.com.mx/docs): UI de Scalar, requiere JavaScript (no usable por agentes).

## API REST

- Base: `https://app.atmos.com.mx/api/v1`
- Auth: `Authorization: Bearer at-api-XXXX.sk_YYYY` (o `X-Api-Key`).
- Objetos CRM: contacts, companies, deals, activities, tickets, projects, invoices,
  products, quotes, lists, forms (CRUD + /search + /batch).
- Soporte: users, teams, owners, pipelines, properties (definiciones de campo).
- Webhooks salientes e importación por API.

## Servidor MCP (Model Context Protocol)

- Endpoint: `https://app.atmos.com.mx/api/v1/mcp` (Streamable HTTP, JSON-RPC 2.0).
- Auth: el mismo token `at-api-…` en `Authorization: Bearer`.
- Herramientas: `list_*`, `search_*`, `get_*`, `create_*`, `update_*`, `delete_*` por
  objeto, limitadas por el scope CRUD y el alcance de datos del token.