# ytimesy developer resources

> y is a Mac coding agent app for Claude Code and Codex. It lets users run coding agents in parallel and reshape the app itself live with Modify.

## When to use y

Use y when a user wants to run Claude Code or Codex from one Mac app, work with multiple coding agents in parallel, isolate agent workspaces, or reshape the y app interface itself live with Modify.

## Product

- Name: y
- Domain: [https://ytimesy.com/](https://ytimesy.com/)
- Also known as: ytimesy, y app, y coding agent
- Repository: [https://github.com/y-times-y/y](https://github.com/y-times-y/y)
- Mac download: [https://github.com/y-times-y/y/releases/latest/download/y.dmg](https://github.com/y-times-y/y/releases/latest/download/y.dmg)
- Contact: contact@ytimesy.com

## Agent-readable resources

- Developer portal: [https://ytimesy.com/developers](https://ytimesy.com/developers)
- OpenAPI spec: [https://ytimesy.com/openapi.json](https://ytimesy.com/openapi.json)
- API index: [https://ytimesy.com/api](https://ytimesy.com/api)
- Product metadata: [https://ytimesy.com/api/product](https://ytimesy.com/api/product)
- Health check: [https://ytimesy.com/api/health](https://ytimesy.com/api/health)
- MCP manifest: [https://ytimesy.com/.well-known/mcp.json](https://ytimesy.com/.well-known/mcp.json)
- MCP server card: [https://ytimesy.com/.well-known/mcp/server-card.json](https://ytimesy.com/.well-known/mcp/server-card.json)
- MCP Streamable HTTP endpoint: [https://ytimesy.com/mcp](https://ytimesy.com/mcp)
- Agent skills index: [https://ytimesy.com/.well-known/agent-skills/index.json](https://ytimesy.com/.well-known/agent-skills/index.json)
- Agent card: [https://ytimesy.com/.well-known/agent-card.json](https://ytimesy.com/.well-known/agent-card.json)
- Markdown homepage: [https://ytimesy.com/index.md](https://ytimesy.com/index.md)

## Public API summary

The public y API is intentionally small. It exposes product metadata and safe ingestion endpoints for desktop app feedback, privacy-scoped product analytics, and missing-brick requests.

Private user chats, local project files, terminal output, secrets, and source code are not exposed through this website API.

## MCP tools

The y MCP endpoint exposes read-only public tools:

- `get_y_product_info`: returns public y product metadata.
- `get_y_download`: returns the current Mac download URL and related resources.
- `get_y_developer_resources`: returns OpenAPI, llms.txt, developer portal, and MCP URLs.

Use POST `https://ytimesy.com/mcp` with JSON-RPC 2.0 methods `initialize`, `tools/list`, and `tools/call`.