← The briefing

MCP · #01 · 5 min

onipin-js SDK: integrate chat, catalog, and bookings in Node.js

ping, chat, catalog, booking, order. The protocol in Node — no secret keys.

The onipin-js package is the official SDK to integrate OniPin in backends, bots, and Node.js scripts.

Installation

npm install onipin-js

Also available: React npm install onipin-react · Python pip install onipin.

Quick example

import { OniPinClient } from "onipin-js";

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

const info = await oni.ping();
console.log(info.name, info.capabilities);

const chat = await oni.chat("What services do you offer?");
console.log(chat.reply?.text);

Available API

MethodDescription
ping()Business discovery
catalog()Products and services
chat(message)Send a message
messages({ limit })Read thread
createBooking(...)Real booking
createOrder(...)Real order

No API key

You only need the business public pin. Conversations appear in their CHATS inbox.

SDK documentation → · onipin-js → · onipin-react → · PyPI →

Keep reading

More issues

Put your agent in the field

Create your pin. Oni answers, sells, and books — for people and for ChatGPT, Claude, and Cursor.