yonyon-client

Tiny TypeScript client and CLI for the public yonyon.ai agent API.

It wraps two public, no-auth surfaces:

• NLWeb /ask - single-shot natural-language query (JSON or SSE streaming)
• /mcp - the MCP server (JSON-RPC over HTTP): list tools, call tools

Rate limit: 10 requests per IP per minute. Runs anywhere with fetch (Node 18+, Deno, Bun, browsers).

Install

npm install yonyon-client

SDK

import { YonyonClient } from "yonyon-client";

const yonyon = new YonyonClient();

// Single-shot answer
const { answer } = await yonyon.ask("What does Yonatan build?");
console.log(answer);

// Streamed answer
for await (const chunk of yonyon.askStream("Summarize the OrchestKit project")) {
  process.stdout.write(chunk);
}

// MCP tools
const tools = await yonyon.listTools(); // ask_yonatan, browse_projects, book_intro_call
const projects = await yonyon.callTool("browse_projects");
const reply = await yonyon.callTool("ask_yonatan", { question: "Do you do RAG work?" });

CLI

npx yonyon ask "what does Yonatan build?"
npx yonyon ask -s "summarize OrchestKit"          # streamed
npx yonyon tools                                   # list MCP tools
npx yonyon call browse_projects                    # call a tool
npx yonyon call ask_yonatan '{"question":"…"}'     # call with JSON args

YONYON_BASE_URL overrides the origin (default https://yonyon.ai).

Links

• Developer docs: https://yonyon.ai/developers
• OpenAPI: https://yonyon.ai/.well-known/openapi.json
• MCP server card: https://yonyon.ai/.well-known/mcp/server-card.json

MIT License.