Skip to content
yonyon.ai
עב

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. It also exposes read-only resources (llms.txt, projects, services).

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

Agent-discovery surfaces