Documentación

Construye con OniPin

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

Wallet · activo ONI

Documentación del activo ONI

Qué es ONI, ledger, canjes a Onicredit / tokens de venta, retiro y ejemplos.

Wallet 2 AI · Onicredit

Onicredit (ONI Credi)

Saldo de gasto para personas y agentes. Recarga, límites, canje desde ONI, transferencia pin a pin y comprobante con hash en Base.

Explorador

Documentación OniScan

Cómo buscar transferencias, direcciones y txs del ecosistema ONI.

Abrir

Entrar a OniScan

Explorador público en onnivers.store/scan

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

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

  • MCP — https://onnivers.store/mcp (Cursor, Claude)
  • CLI — npm install -g onipin-cli
  • SDK JS — npm install onipin-js
  • React — npm install onipin-react (OniChat)
  • SDK Python — pip install onipin
  • HTTP /v1 + OpenAPI — https://onnivers.store/v1/openapi.yaml
  • 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>

React (paquete oficial)

React 
npm install onipin-react

import { OniChat } from "onipin-react";

<OniChat pin="onp_tu_pin" />
<OniChat pin="onp_tu_pin" mode="iframe" height={640} />

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 e Intent Spec (IA ↔ negocio)

Guía para asistentes: Cómo una IA decide usar OniPin

meta tag 
<meta name="onipin" content="onp_tu_pin">
well-known plataforma 
curl "https://onnivers.store/.well-known/onipin"
well-known negocio 
curl "https://onnivers.store/.well-known/onipin.json?pin=onp_tu_pin"
descubrir desde URL 
curl "https://onnivers.store/v1/discover?url=https://example.com"
handshake 
curl -X POST https://onnivers.store/v1/handshake/onp_tu_pin \
  -H "Content-Type: application/json" \
  -d '{"agent":{"name":"MyBot"},"intent":"appointment.create"}'

Intent Specification 0.2

Cómo una IA decide usar OniPin

El usuario dice "agenda una cita" — no "usa OniPin". Esta spec define el flujo que cualquier asistente puede implementar.

Flujo en 5 pasos

  1. Descubrir — ¿El negocio publica OniPin? (/v1/discover, meta onipin, llms.txt)
  2. Handshake — Anunciar agente + intención (POST /v1/handshake/{pin})
  3. Enviar mensaje — POST /v1/chat/{pin}
  4. Recibir respuesta — Texto + conversationId
  5. Acción — Cita/pedido en Agenda (data.bookingId / orderId)

Descubrir desde URL

curl 
curl "https://onnivers.store/v1/discover?url=https://onnivers.store/probar-chat/"

Handshake

curl 
curl -X POST https://onnivers.store/v1/handshake/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -d '{"agent":{"name":"MyBot","version":"1.0"},"intent":"appointment.create"}'

Chat con intent

curl 
curl -X POST https://onnivers.store/v1/chat/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -H "X-Caller-Type: ai-agent" \
  -d '{"message":"Quiero demo el viernes","agent":{"name":"MyBot"},"intent":"appointment.create"}'

Intenciones

  • business.chat — conversación general
  • appointment.create — cita / demo
  • order.create — pedido
  • product.price — precio
  • catalog.browse — catálogo
  • payment.info — pago

Pin demo:onp_vuzadcjv3xw7

Servidor MCP

Endpoint https://onnivers.store/mcp — Endpoint — usa POST (Streamable HTTP). No es una página web. Hermes usa mcp_servers. Cursor y Claude usan mcpServers.

discover_from_url, business_lookup, catalog_list, chat_send, chat_read, booking_create, order_create, buyer_whoami, purchase_with_credits, transfer_onicredit, payment_methods_list

agentes.md · llms.txt · .well-known/onipin.json

.cursor/mcp.json 
{ "mcpServers": { "onipin": { "url": "https://onnivers.store/mcp" } } }

Integración con Hermes Agent

Hermes usa mcp_servers para las herramientas reales y una skill pública para el procedimiento. No pongas claves ona_, ont_ ni mct_ en la página, GitHub ni SKILL.md.

  • MCP: https://onnivers.store/mcp
  • Skill: https://onnivers.store/skills/onipin-onnivers/SKILL.md
  • Documentación: https://onnivers.store/docs
hermes config.yaml 
mcp_servers:
  onipin:
    url: https://onnivers.store/mcp
    headers:
      X-Api-Key: "${ONIPIN_AGENT_KEY}"
    timeout: 120
    connect_timeout: 60
/skills install 
/skills install https://onnivers.store/skills/onipin-onnivers/SKILL.md --name onipin-onnivers
  • Compra: buyer_whoami, muestra nombre, imagen y precio, luego purchase_with_credits. Verifica order.id. El envío físico se paga al recibir.
  • Transferencia: confirma pin o @usuario y el monto en COP, luego transfer_onicredit con to y amountCents. Verifica transfer.id.
  • No prometas rentabilidad de ONI. El Onicredit de la app no es el ONC de blockchain.

OniPin Terminal (CLI)

OniPin Terminal es la interfaz de dueño en la consola (estilo Claude Code): login, REPL oni >, cerebro local opcional y los mismos comandos /… que usas en /app. Paquete npm: onipin — `npm install -g onipin` o `npx onipin`.

Captura de OniPin Terminal con el logo ONI centrado
Terminal del dueño — Instala el CLI, inicia sesión en el navegador y abre el REPL. Habla en español o usa comandos slash. Ejemplo: crea productos con descripción e imagen, gestiona pedidos, agenda, wallet ONI y MI IA.

Instalar

install 
npm install -g onipin-cli
# Windows: onipin.cmd
onipin login
onipin

Comandos de dueño (sesión)

owner REPL 
oni > /help
oni > /catalog
oni > /product add "Gorra" 20000 --desc "Algodón" --image ./foto.png
oni > /orders
oni > /agenda
oni > /oni
oni > /mia
# o en español: "necesito subir un producto"

Comandos visitante / agente (/v1)

visitor /v1 
onipin ping --pin onp_tu_pin --text
onipin catalog --pin onp_tu_pin --text
onipin chat --pin onp_tu_pin "¿Qué servicios ofrecen?" --text
onipin book --pin onp_tu_pin --service "Demo" --client "Ana" --contact "ana@email.com" --date "mañana 10:00"
onipin order --pin onp_tu_pin --product "Plan Pro" --client "Ana" --contact "ana@email.com" --qty 1

Paquete: onipin-cli · Para agentes externos (Cursor/Claude) MCP sigue siendo ideal. El Terminal es para operar tu negocio como dueño desde la consola.

Dentro del REPL: /help · /product add · /orders · /oni · /mia

SDK (npm + React + CLI + PyPI)

install 
npm install onipin-js
npm install onipin-react
npm install -g onipin-cli
pip install onipin
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();
await oni.handshake("appointment.create");
const chat = await oni.chat("Quiero demo el viernes", { intent: "appointment.create" });
console.log(chat.reply?.text);
OniChat.tsx 
import { OniChat } from "onipin-react";

export function Support() {
  return <OniChat pin="onp_tu_pin" />;
}
sdk.py 
from onipin import OniPinClient

oni = OniPinClient(pin="onp_tu_pin", agent={"name": "MyBot", "version": "1.0"})
oni.handshake("business.chat")
print(oni.chat("Quiero demo el viernes", intent="business.chat").get("reply"))

onipin-js · onipin-react · onipin-cli · onipin (PyPI) · OpenAPI