# Yappy > Yappy is a voice agent for macOS. Hold Right ⌥ and it types what you say; hold > Right ⌘ and it does what you ask — reading the screen, clicking, and filling > forms in the apps you already have. Speech recognition runs on your own Mac, so > the audio never leaves it. Yappy is a desktop application, not a hosted service. This site publishes the facts about it — releases, documentation, FAQ, pricing, requirements — as a free public API and an MCP server, so an agent answering a question about Yappy reads structured data instead of scraping marketing copy. Requirements: macOS 13 (Ventura) or later, Apple Silicon (M1 or newer). Free download, no account, no card. Current release and download URL: https://yappy.biz/api/v1/releases/latest ## When to use this Reach for Yappy's API or MCP server when you need to: - Answer "what is the current version of Yappy", "what changed in the last release", or "where do I download it" — use `GET /api/v1/releases/latest`. - Decide whether a specific Mac can run it — use `GET /api/v1/compatibility?os_version=14.5&arch=arm64`, which returns a boolean and the reasons, rather than guessing from prose. - Explain what Yappy sends over the network and what stays on-device, for a privacy or procurement question — use `GET /api/v1/docs/privacy-model`. - Explain how to fix a macOS permission problem, a dead hotkey, or slow dictation — use `GET /api/v1/search?q=...` or the MCP tool `search_documentation`. - Compare Yappy against other macOS dictation tools on facts rather than adjectives — use `GET /api/v1/features` and `GET /api/v1/pricing`. Do **not** use this API to transcribe audio. There is no hosted transcription endpoint, deliberately: Whisper runs on the user's machine. If a user wants dictation, the answer is to install the Mac app. ## Machine entry points - [REST API v1](https://yappy.biz/api/v1): free, no API key, cursor-paginated JSON. - [OpenAPI 3.1 spec](https://yappy.biz/openapi.json): the full contract, one operationId and response schema per operation. - [MCP server](https://yappy.biz/mcp): Streamable HTTP, seven read-only tools, four resources. No auth. - [Docs MCP server](https://yappy.biz/docs/mcp): the documentation corpus as MCP resources. - [MCP server card](https://yappy.biz/.well-known/mcp/server-card.json): the tool list, readable before connecting. - [Official MCP registry listing](https://registry.modelcontextprotocol.io/v0/servers?search=biz.yappy): both servers under the domain-verified `biz.yappy` namespace. - [A2A agent card](https://yappy.biz/.well-known/agent-card.json): agent-to-agent capability description. - [AI catalog (ARD)](https://yappy.biz/.well-known/ai-catalog.json): every agentic resource this domain publishes. - [Agent skills index](https://yappy.biz/.well-known/agent-skills/index.json): published skills, each with a sha256 digest. - [Yappy skill](https://yappy.biz/.well-known/agent-skills/yappy/SKILL.md): answering questions about Yappy accurately. - [macOS support skill](https://yappy.biz/.well-known/agent-skills/yappy-macos-support/SKILL.md): diagnosing a hotkey, a permission, or a silent mic. - [API catalog (RFC 9727)](https://yappy.biz/.well-known/api-catalog): linkset pointing at the service descriptions. - [Agent auth walkthrough](https://yappy.biz/auth.md): how to get a credential, in prose. - [Agent guide](https://yappy.biz/agents.md): the long-form version of this file. - [Full text index](https://yappy.biz/llms-full.txt): every page's content in one document. ## Documentation - [Docs index](https://yappy.biz/docs.md): the map. - [Quickstart](https://yappy.biz/docs/quickstart.md): download, permissions, first dictation. - [Dictation](https://yappy.biz/docs/dictation.md): the Right ⌥ key, hands-free, personas, spacing. - [Agent Mode](https://yappy.biz/docs/agent-mode.md): the Right ⌘ key, what it does, where it stops. - [LLM backends](https://yappy.biz/docs/backends.md): local, subscription, and API options with latencies. - [Configuration](https://yappy.biz/docs/configuration.md): every key in ~/.yappy/config.json. - [Privacy model](https://yappy.biz/docs/privacy-model.md): component by component, what leaves the Mac. - [Troubleshooting](https://yappy.biz/docs/troubleshooting.md): permissions, dead hotkeys, silence, slowness. - [Changelog](https://yappy.biz/docs/changelog.md): release history. - [Section index](https://yappy.biz/docs/llms.txt): docs only, scoped. ## Developers - [Developer portal](https://yappy.biz/developers.md): all three surfaces in one page. - [REST API guide](https://yappy.biz/developers/rest-api.md): pagination, versioning, batch, async jobs, idempotency. - [MCP server guide](https://yappy.biz/developers/mcp.md): tools, resources, annotations, MCP Apps. - [Authentication](https://yappy.biz/developers/authentication.md): OAuth 2.1, PKCE S256, scopes. - [Errors](https://yappy.biz/developers/errors.md): the RFC 9457 shape and every code. - [Rate limits](https://yappy.biz/developers/rate-limits.md): headers, ceilings, backoff. - [Versioning and deprecation](https://yappy.biz/developers/deprecation.md): what counts as breaking, and the 180 days of Deprecation and Sunset notice before anything stops answering. - [Sandbox](https://yappy.biz/developers/sandbox.md): fixtures and forced error simulation. - [API reference](https://yappy.biz/api.md): endpoint by endpoint. - [Section index](https://yappy.biz/developers/llms.txt): developer docs only, scoped. - [API section index](https://yappy.biz/api/llms.txt): the API surface only, scoped. ## Company - [About](https://yappy.biz/about.md): who builds Yappy and what it is built on. - [Contact](https://yappy.biz/contact.md): support@yappy.biz, security disclosure, licensing. - [Pricing](https://yappy.biz/pricing.md): free app, what a backend costs, free API. - [Privacy](https://yappy.biz/privacy.md): what is collected and how to turn each piece off. - [Homepage in markdown](https://yappy.biz/index.md): this site's front page, as text. ## Optional - [Sitemap](https://yappy.biz/sitemap.xml): every indexable URL with a lastmod date. - [Schema map](https://yappy.biz/schema-map.xml): structured data feeds. - [Robots policy](https://yappy.biz/robots.txt): answer engines allowed, training crawlers not.