OneMacApp

Black Friday60% off, applied automatically at checkout60% off, auto-appliedSee pricing

Developers

OneMacApp API and MCP server

A free, keyless, read-only catalog of OneMacApp's 43 Mac tools, for AI agents and developers.

Last updated

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.

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/pricing
Each 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 a checkout_url per 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/mcp

07Errors

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): limit must be 1–100.
  • rate_limited (429): wait for the Retry-After seconds.
  • 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].

See also Privacy and Terms.