> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lapyme.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# API para agentes

> Cómo elegir entre la API REST, el SDK y el MCP autenticado, y cómo operar con referencias, permisos e idempotencia correctos.

Usá esta guía cuando un agente necesite consultar u operar datos autorizados de
una organización de La Pyme.

## Elegí la integración

* Usá la [API REST](/api-reference/introduccion) para una integración HTTP con
  contratos explícitos.
* Usá el [SDK de TypeScript](/api-reference/sdk/typescript) para consumir la API
  desde TypeScript con tipos y manejo de errores integrado.
* Usá el MCP autenticado de producto en `https://mcp.lapyme.com.ar/mcp` cuando
  una persona autorice a un agente a usar las herramientas publicadas sobre su
  organización.
* Usá el [MCP público de documentación](/api-reference/ai-toolkit) solo para
  buscar y leer documentación. Ese servidor no accede a datos de clientes.

## Antes de operar

1. Autenticá la solicitud y respetá la organización asociada a la credencial.
2. Descubrí los IDs necesarios mediante las operaciones de lectura. No inventes
   referencias de organización, productos, contactos, ubicaciones o cuentas.
3. Consultá el contrato [OpenAPI](/api-reference/openapi.json) para validar los
   parámetros y las respuestas.
4. Para una escritura reintentable, enviá la clave de
   [idempotencia](/api-reference/idempotencia) cuando la operación la requiera.
5. Tratá los [errores estructurados](/api-reference/errores) como la fuente para
   corregir la solicitud o decidir si un reintento es seguro.

Para elegir entre todas las superficies públicas, consultá la
[guía general para agentes](/agent-instructions).