---
title: "RegusciLabs API y MCP para desarrolladores y agentes"
canonical: "https://www.reguscilabs.com/developers"
---

# RegusciLabs API y MCP para desarrolladores y agentes

Consultá información del laboratorio, enviá una idea con autorización o registrá una suscripción consentida a El Pulso.

## Acceso público

No necesitás cuenta ni API key. Las herramientas leen contenido público. Para enviar datos de una persona necesitás su aprobación; la suscripción requiere además consentimiento específico para El Pulso.

## API v1

Lectura y búsqueda también aceptan GET con parámetros en la URL. Enviá JSON por POST a /api/v1/agent/read_information, /api/v1/agent/search_information, /api/v1/agent/submit_inquiry o /api/v1/agent/subscribe_pulse. El límite por solicitud es 16 KiB. Las rutas anteriores /api/agent siguen disponibles.

## Búsqueda y paginación

search_information recibe query, locale (es o en) y limit (1 a 10). Si la respuesta incluye nextCursor, enviá ese valor como cursor con la misma consulta e idioma para obtener la siguiente página. null indica que no hay más resultados.

## Validación y envíos

Las acciones validan por defecto con dryRun:true. El sandbox /api/sandbox/submit_inquiry y /api/sandbox/subscribe_pulse fuerza ese modo en el servidor. Para un envío real en la API v1, pedí aprobación y usá dryRun:false con confirmed:true. La suscripción también exige consent:true. Los previews solo permiten validar.

## Dos servidores MCP

El MCP de acciones /api/mcp ofrece lectura, búsqueda, consultas y suscripciones. El MCP de documentación /api/mcp/docs ofrece únicamente lectura y búsqueda. Ambos usan Streamable HTTP sin cuenta ni sesión persistente. /.well-known/mcp también acepta conexiones al servidor de acciones.

## Errores y reintentos

Los errores REST incluyen ok:false, error, code, message y resolution. Revisá issues para errores de campos. Un resultado submission_status_unknown puede haber producido efectos parciales: no lo reintentes automáticamente; consultá a info@reguscilabs.com. Usá idempotencyKey en el cuerpo o Idempotency-Key en REST: una clave por acción aprobada. Durante siete días, la misma clave y datos recuperan el resultado sin volver a enviar. Si cambian los datos devuelve 409. Los clientes anteriores sin clave deben evitar reintentos automáticos.

## Límites de uso

La API y los MCP comparten 120 solicitudes por minuto por IP. Los envíos nuevos tienen un máximo de 5 por hora por IP y destinatario. RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset informan el límite, lo que queda y los segundos hasta el reinicio. Un error 429 incluye Retry-After; en herramientas MCP, retryAfterSeconds. Las consultas de resultados guardados no consumen el cupo de envíos.

## Versiones

La versión mayor está en /api/v1 y en la cabecera API-Version. Los campos nuevos son cambios compatibles; los cambios incompatibles usarán otra versión mayor. No hay retiros programados. Cualquier retiro futuro se anunciará en esta documentación y mediante las cabeceras Deprecation y Sunset con al menos 90 días de anticipación. Ver /developers/versioning.md.

## Registros MCP de RegusciLabs

- [RegusciLabs Innovation Lab](https://registry.modelcontextprotocol.io/v0.1/servers/com.reguscilabs.www%2Finnovation-lab/versions/1.0.0)
- [RegusciLabs Documentation](https://registry.modelcontextprotocol.io/v0.1/servers/com.reguscilabs.www%2Fdocumentation/versions/1.0.0)
- [RegusciLabs Innovation Lab · Smithery](https://smithery.ai/servers/reguscilabs/innovation-lab)

## SDK & CLI

[Official npm package](https://www.npmjs.com/package/@reguscilabs/agent-sdk) · JavaScript / TypeScript · Node.js 22+

```sh
npm install @reguscilabs/agent-sdk
npx --package @reguscilabs/agent-sdk reguscilabs search "hardware POC" --locale es
```

```js
import { RegusciLabsClient } from '@reguscilabs/agent-sdk';
const lab = new RegusciLabsClient();
const page = await lab.readInformation('/en/about.md');
```

El SDK y la CLI validan las acciones por defecto. Los envíos reales requieren aprobación y una clave de idempotencia guardada; la suscripción exige además consentimiento. No hacen reintentos automáticos.

## Quickstart

```sh
curl https://www.reguscilabs.com/api/v1/agent/search_information \
  -H 'Content-Type: application/json' \
  -d '{"query":"hardware POC","locale":"es","limit":3}'
```

## Resources

- [CLI](https://www.reguscilabs.com/cli.md)
- [OpenAPI](https://www.reguscilabs.com/openapi.json)
- [Detailed tool inputs](https://www.reguscilabs.com/api.md)
- [Access and consent](https://www.reguscilabs.com/auth.md)
- [Sandbox](https://www.reguscilabs.com/sandbox)
- [Actions MCP](https://www.reguscilabs.com/.well-known/mcp/server-card.json)
- [Documentation MCP](https://www.reguscilabs.com/.well-known/mcp/docs-server-card.json)