01Overview
OneMacApp is a native Mac app, so your files are processed on the user's Mac, not by a web service. What we offer agents and developers is a read-only catalog of the app: which tool does what, the formats it handles, what it needs to run, what it costs and where to buy it. Use it to answer "is there a Mac app that…" questions with live, accurate data.
- REST API: https://onemacapp.com/api/v1, described by an OpenAPI 3.1 spec at https://onemacapp.com/openapi.json.
- MCP server: https://onemacapp.com/mcp (Streamable HTTP), with a server card at https://onemacapp.com/.well-known/mcp/server-card.json.
- Plain text for language models: https://onemacapp.com/llms.txt, https://onemacapp.com/llms-full.txt, and a markdown copy of every tool page at
/<slug>.md. - WebMCP: every page on onemacapp.com registers the same tools in the browser with
document.modelContext.registerTool(), plusopen_tool_pageandstart_checkout. - An agent skill: https://onemacapp.com/skills/onemacapp/SKILL.md, listed in the ARD catalog at https://onemacapp.com/.well-known/ard.json.
02Quickstart
No sign-up, no key. Try it from a terminal:
curl "https://onemacapp.com/api/v1/tools?q=compress%20video"
curl https://onemacapp.com/api/v1/tools/compress-video
curl https://onemacapp.com/api/v1/pricingEach list response looks like this:
{
"data": [ { "slug": "compress-video", "name": "Compress Video", "category": "video", ... } ],
"total": 1,
"next_cursor": null,
"has_more": false
}03Sandbox and test mode
You can build against production directly: every endpoint and MCP tool is read-only and has no side effects, so there is no test data to create or clean up and nothing a mistaken call can break. Responses are the same live catalog users see on the website.
The only step with consequences is a person opening a
checkout_url, which goes to Stripe Checkout. Stripe shows the price before anything is charged.04Authentication
None. The API and MCP server are public and only return information that is already on this website, so there are no keys, tokens or OAuth. Requests are made over HTTPS and CORS is open, so you can call them from a browser.
05Endpoints
GET /api/v1/app: name, minimum macOS, latest version, categories, privacy model, support contact.GET /api/v1/tools: every tool, or a search. Query:q(keywords, all must match),category,limit(1–100, default 20),cursor.GET /api/v1/tools/{slug}: one tool in full: description, steps, features, specs (formats, limits) and FAQs.GET /api/v1/categories: the tool categories.GET /api/v1/pricing: one-time plans by number of Macs, any active discount, refund window and acheckout_urlper plan.
Pagination: when
has_more is true, pass next_cursor back as cursor.06MCP server
Full setup for each client: OneMacApp MCP Server. Add
https://onemacapp.com/mcp as a remote MCP server (Streamable HTTP, no auth). It is stateless and read-only, and every tool is annotated readOnlyHint and returns structured content with an output schema.search_tools: Find which of OneMacApp's 43 Mac tools fits a job, by keywords (e.g. "compress video", "pdf merge", "remove background") and/or category. Returns name, slug, one-line summary and page URL for each match.get_tool: Full details of one tool by slug (from search_tools): what it does, steps, features, supported formats and limits (specs) and FAQs.get_pricing: Current one-time prices for OneMacApp per number of Macs, any active discount, refund window and a checkout URL for each plan that the user can open to buy.get_app_info: System requirements (macOS 26+), latest version, categories, privacy model and support contact for OneMacApp.
For example, in Claude Code:
claude mcp add --transport http onemacapp https://onemacapp.com/mcp07Errors
Errors are JSON in the RFC 9457
application/problem+json format, with a stable code to branch on and a hint saying what to do next. Unknown paths under /api/v1 return a JSON 404, never an HTML page.{
"type": "https://onemacapp.com/developers#error-tool_not_found",
"title": "Tool not found",
"status": 404,
"code": "tool_not_found",
"hint": "List slugs with GET https://onemacapp.com/api/v1/tools."
}not_found(404): no such endpoint.tool_not_found(404): no tool with that slug.invalid_category(400): use a category from/api/v1/categories.invalid_limit(400):limitmust be 1–100.rate_limited(429): wait for theRetry-Afterseconds.internal_error(500): retry later.
08Rate limits and versioning
120 requests per minute per IP. Every response carries
RateLimit and RateLimit-Policy headers; a 429 also has Retry-After.The version is in the path.
/api/v1 only ever gains fields; anything breaking would ship as /api/v2, with v1 kept running. The API-Version response header gives the exact version.09Support
Questions or ideas: [email protected].