ytimesy developer resources for y.

Use these public docs and machine-readable endpoints to understand y, integrate with its safe ingestion APIs, and discover its MCP tools.

OpenAPI spec

Agents and developer tools can inspect the public REST surface automatically.

View /openapi.json

MCP server

Read-only public product metadata tools are exposed over Streamable HTTP.

View MCP manifest

llms.txt

A concise map of the resources AI agents should read first.

View llms.txt

Repository

y is open source. The desktop app code and releases are on GitHub.

Open GitHub

Public API endpoints

GET /api

Lists the public y API, developer resources, OpenAPI spec, and MCP URLs.

GET /api/product

Returns public y product metadata, download links, repository, and contact details.

GET /api/health

Returns basic API health.

POST /api/feedback

Accepts product feedback from the desktop app. Do not send secrets, source code, or private project data.

POST /api/events

Accepts allowlisted, privacy-scoped product analytics events from the desktop app.

POST /api/brick-requests

Accepts enum-only missing-brick requests from y agents.

MCP quickstart

The public MCP endpoint exposes only read-only product metadata tools. It does not expose user chats, local project files, terminal output, or private analytics.

curl -s https://ytimesy.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Sandbox

Use the public endpoints above directly against https://ytimesy.com. Ingestion endpoints are intentionally narrow and validated so agents can test request shape without receiving private data back.