API · MCP · WEBMCP

RegusciLabs API and MCP for developers and agents

Read about the lab, submit an approved project idea or register a consented Pulse subscription.

Your first request

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

Official JavaScript and TypeScript client. Node.js 22 or later, with no runtime dependencies or 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');

The SDK and CLI validate writes by default. Live actions require approval and a saved idempotency key; subscriptions also require consent. They never retry automatically.

RegusciLabs MCP listings

Two servers published in the official registry under the verified RegusciLabs domain: approved actions and read-only documentation. The Innovation Lab server is also listed on Smithery.

Public access

No account or API key is required. Tools read public content. Transmitting a person's details requires their approval; newsletter signup also requires specific Pulse consent.

API v1

Reading and search also accept GET query parameters. POST JSON to /api/v1/agent/read_information, /api/v1/agent/search_information, /api/v1/agent/submit_inquiry or /api/v1/agent/subscribe_pulse. Requests are limited to 16 KiB. Existing /api/agent routes remain available.

Search and pagination

search_information takes query, locale (es or en), and limit (1–10). When a response includes nextCursor, pass it as cursor with the same query and locale to fetch the next page. null means there are no more results.

Validation and live submissions

Writes default to dryRun:true. /api/sandbox/submit_inquiry and /api/sandbox/subscribe_pulse enforce validation on the server. For a live v1 submission, obtain approval and use dryRun:false with confirmed:true. Subscription additionally requires consent:true. Previews only permit validation.

Two MCP servers

The actions MCP at /api/mcp provides reading, search, inquiries and subscriptions. The documentation MCP at /api/mcp/docs provides reading and search only. Both use Streamable HTTP without an account or persistent session. /.well-known/mcp also accepts connections to the actions server.

Errors and retries

REST errors include ok:false, error, code, message and resolution. Check issues for field errors. submission_status_unknown may mean partial effects: do not automatically retry; contact info@reguscilabs.com. Use idempotencyKey in the input or Idempotency-Key in REST: one key per approved action. For seven days, the same key and input retrieve the outcome without sending again. Changed input returns 409. Legacy calls without a key must not be retried automatically.

Usage limits

The API and MCP servers share 120 requests per minute per IP. New live actions are limited to 5 per hour per IP and recipient. RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset report the limit, remaining requests and seconds until reset. A 429 includes Retry-After; MCP tool errors use retryAfterSeconds. Saved result replays do not consume the live action quota.

Versioning

The major version appears in /api/v1 and the API-Version response header. Additive fields are compatible; breaking changes require a new major route. No retirement is scheduled. Any future retirement will be announced here and through Deprecation and Sunset headers at least 90 days before a route is removed. See /developers/versioning.md.

Try an agent action

Validate an example inquiry or subscription. The sandbox server never sends messages or stores contacts.

Read the API and consent requirements ↗