---
name: onipin-onnivers
description: Use OniPin MCP for discovery, chat, orders and credits.
version: 1.0.0
author: Deibys Herrera, Hermes Agent
license: MIT
platforms: [windows, macos, linux]
metadata:
  hermes:
    tags: [onipin, onnivers, onicredit, mcp, ecommerce, colombia]
    category: business
---

# OniPin / OnniVers

## Identidad

OniPin / OnniVers
URL principal: https://onnivers.store
MCP: https://onnivers.store/mcp
Producto: descubrir negocios, chatear, comprar y agendar con IA.

Documentación: https://onnivers.store/docs
Skill: https://onnivers.store/skills/onipin-onnivers/SKILL.md
Referencias: https://onnivers.store/skills/onipin-onnivers/references/tools.md
Descubrimiento: https://onnivers.store/.well-known/onipin.json
Pin de demostración: `onp_vuzadcjv3xw7`

Esta skill enseña el procedimiento. No conecta el MCP. Hermes tiene que tener el servidor configurado con la clave `mcp_servers` (no `mcpServers`, que es de Claude o Cursor). El secreto vive en los secretos de Hermes, nunca en esta skill, en la página, en GitHub, en `llms.txt` ni en documentación pública.

```yaml
mcp_servers:
  onipin:
    url: https://onnivers.store/mcp
    headers:
      X-Api-Key: "${ONIPIN_AGENT_KEY}"
    timeout: 120
    connect_timeout: 60
```

## Herramientas disponibles

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

También existen `business_categories`, `protocol_handshake` y `oni_balance`. Los argumentos reales están en https://onnivers.store/skills/onipin-onnivers/references/tools.md

## Reglas de seguridad

- No revelar tokens, claves `ona_`, `ont_`, `mct_` ni secretos OAuth.
- Confirmar destinatario y monto antes de una transferencia.
- Confirmar producto, precio y dirección antes de una compra.
- Después de una operación, leer el resultado y verificar el ID.
- No prometer rentabilidad de ONI.
- El envío de productos físicos se paga al recibir.
- No confundir Onicredit de la aplicación con ONC de blockchain.

Onicredit es el saldo de gasto en la app (centavos COP: 100 centavos = 1 peso). ONC en Base es el espejo de ese saldo: se mueve, no se suma al saldo de la app. ONI es otro activo. Detalle: https://onnivers.store/skills/onipin-onnivers/references/security.md

## Procedimiento de compra

1. Ejecutar buyer_whoami.
2. Verificar saldo y dirección.
3. Buscar el producto.
4. Mostrar nombre, imagen y precio.
5. Pedir confirmación si el usuario no autorizó claramente la compra.
6. Ejecutar purchase_with_credits.
7. Verificar order.id, paymentStatus y saldo restante.

`purchase_with_credits` exige el pin del vendedor y, si el catálogo lo tiene, `productId`. El envío físico va contra entrega: no cobres el flete. Si el resultado no trae `order.id`, no des la compra por hecha.

## Procedimiento de transferencia

1. Confirmar username o pin del destinatario.
2. Confirmar monto en COP.
3. Ejecutar transfer_onicredit.
4. Verificar transfer.id, status y saldo restante.
5. Informar el resultado sin exponer credenciales.

La herramienta pide `to` (pin `onp_…` o `@usuario`) y `amountCents` (pesos × 100). El dueño tiene que haber activado «La IA puede transferir». No llames la herramienta por segunda vez con el mismo monto si el primer resultado ya trae id.