Documentación

Construye con OniPin

Instala el chat, conecta IAs por HTTP o MCP. Ejemplos con pin ficticio onp_tu_pin.

Qué puedes usar hoy (MCP, SDK, HTTP)

Plataforma real en producción. Solo necesitas el pin del negocio.

  • MCP — https://onnivers.store/mcp (Cursor, Claude)
  • SDK — npm install onipin-js
  • HTTP /v1 — REST + JSON
  • Widget — /widget.js
Cursor MCP 
{
  "mcpServers": {
    "onipin": { "url": "https://onnivers.store/mcp" }
  }
}

Empezar con OniPin

  1. Regístrate gratis y confirma tu correo.
  2. En MI IA configura negocio, FAQs y catálogo.
  3. Comparte https://onnivers.store/c/onp_tu_pin o instala el widget.
  4. En CHATS toma el control cuando quieras.

Instalar el chat en tu web

HTML 
<script src="https://onnivers.store/widget.js" data-pin="onp_tu_pin"></script>

Protocolo HTTP /v1

GET /v1/ping/{pin}

Discovery del negocio.

curl 
curl https://onnivers.store/v1/ping/onp_tu_pin
POST /v1/chat/{pin}

Envía mensaje; devuelve conversationId y reply.

curl 
curl -X POST https://onnivers.store/v1/chat/onp_tu_pin \
  -H "Content-Type: application/json" \
  -H "X-Caller-Type: ai-agent" \
  -d '{ "message": "¿Horarios?" }'
GET /v1/catalog/{pin}

Catálogo público de productos y servicios.

Discovery para IAs

meta tag 
<meta name="onipin" content="onp_tu_pin">
well-known 
curl "https://onnivers.store/.well-known/onipin.json?pin=onp_tu_pin"

Servidor MCP

Endpoint https://onnivers.store/mcp — usa POST (Streamable HTTP). No es una página web; conéctalo desde Cursor o Claude.

  • buscar_negocio, enviar_mensaje, leer_conversacion
  • obtener_catalogo, crear_reserva, comprar_producto
.cursor/mcp.json 
{ "mcpServers": { "onipin": { "url": "https://onnivers.store/mcp" } } }

SDK onipin-js

npm 
npm install onipin-js
sdk.mjs 
import { OniPinClient } from "onipin-js";

const oni = new OniPinClient({
  baseUrl: "https://onnivers.store",
  pin: "onp_tu_pin",
  callerType: "ai-agent",
});

const info = await oni.ping();
const chat = await oni.chat("Hola");
console.log(chat.reply?.text);

Paquete: npmjs.com/package/onipin-js