דילוג לתוכן
yonyon.ai
EN

yonyon.ai Developers & API

yonyon.ai is built to be used by AI agents and developers. Everything below is public, unauthenticated, and rate-limited. No API key, no OAuth, no signup.

Quickstart

Ask a question about Yonatan in one request:

curl -N https://yonyon.ai/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"What does Yonatan build?"}]}'

Authentication

None. No API key, bearer token, OAuth, or client registration. Every endpoint is open. The only limit is rate: 10 requests per IP per minute (HTTP 429 with a Retry-After header when exceeded). See /auth.md for the machine-readable version.

Chat API: POST /api/chat

Streams a grounded answer (plain text) about Yonatan’s work, projects, services, and experience. Model: claude-haiku-4-5.

Request body: { "messages": [{ "role": "user", "content": "…" }] }, up to 20 messages, each content ≤ 2000 chars. Response: a streamed text/plain body (concatenate the chunks).

const res = await fetch("https://yonyon.ai/api/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Summarize Yonatan in one line." }],
  }),
});
const text = await res.text(); // streamed plain text

Full schema: /.well-known/openapi.json (OpenAPI 3.1).

MCP server: /api/mcp

A Model Context Protocol server over Streamable HTTP. Tools: ask_yonatan, browse_projects, book_intro_call, read_site_page. It also exposes read-only resources (projects, services, about).

Discover it from any of:

# initialize
curl -s https://yonyon.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# list tools
curl -s https://yonyon.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# call a tool
curl -s https://yonyon.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"ask_yonatan","arguments":{"question":"What is OrchestKit?"}}}'

Server card: /.well-known/mcp/server-card.json · discovery: /.well-known/mcp.json

Command line client: yonyon

An official CLI wrapping everything above, published on npm as yonyon. Zero runtime dependencies, no API key, no configuration. Requires Node 24 or newer.

npx yonyon ask "What has Yonatan built with MCP?"
npx yonyon projects --limit 5
npx yonyon projects --json
npx yonyon mcp --tools
npx yonyon docs
npx yonyon book

Install it properly with npm i -g yonyon. Every command takes --json where a machine-readable shape makes sense, plus --base-url to point it at another deployment and --timeout to bound a request. Source lives in cli/ in this site’s repository.

Agent-discovery surfaces

רוצים תוצאה כזו במוצר שלכם?

שיחת היכרות חינם של 15 דקות. בלי מצגות ובלי לחץ. רק לבדוק אם אני יכול לעזור.

קביעת 15 דקותאו שלחו הודעה במקום