API · MCP · WEBMCP

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.

Tu primera consulta

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

SDK & CLI

Cliente oficial para JavaScript y TypeScript. Node.js 22 o posterior, sin dependencias de ejecución ni API key.

@reguscilabs/agent-sdk · npm

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

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.

Registros MCP de RegusciLabs

Dos servidores publicados en el registro oficial con el dominio verificado de RegusciLabs: acciones con aprobación y documentación de solo lectura. El servidor Innovation Lab también está disponible en Smithery.

Conectá tu asistente mediante https://mcp.reguscilabs.com.

https://mcp.reguscilabs.com/mcp · https://mcp.reguscilabs.com/docs

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/get_latest_news, /api/v1/agent/get_latest_activity, /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. get_latest_news devuelve artículos de Newsroom y ediciones de El Pulso ordenadas por fecha de publicación. Permite filtrar por locale y source (all, newsroom o pulse) y paginar; latestPublishedDate indica la novedad más reciente del archivo público, no noticias en vivo. get_latest_activity devuelve publicaciones sociales curadas con filtros por plataforma, idioma, tema y fechas verificadas; no es un feed en vivo y las fechas sin verificar son nulas.

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

Conectá tu asistente a https://mcp.reguscilabs.com/mcp para lectura, búsqueda, noticias y actividad social pública curada, consultas y suscripciones, o a https://mcp.reguscilabs.com/docs para solo lectura. Ambos usan Streamable HTTP sin cuenta ni sesión persistente. Las rutas originales /api/mcp y /api/mcp/docs siguen funcionando.

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.

Probá una acción

Validá una consulta de proyecto o una suscripción con datos de ejemplo. El servidor de prueba no envía mensajes ni guarda contactos.

Ver la API y los requisitos de consentimiento ↗