{
  "name": "Snapperon",
  "description": "Snapperon gives Claude Desktop and Codex 20 local commands for working in the Mac editor. An assistant can read screenshot text, create a reading page, start an editable graphic from supplied words, or prepare annotations for you to review.",
  "metadata_type": "informational_local_mcp_discovery",
  "release_status": "live",
  "updated": "2026-11-20",
  "product_url": "https://snapperon.com/mcp/",
  "documentation_url": "https://snapperon.com/llms-full.txt",
  "markdown_url": "https://snapperon.com/mcp.md",
  "server": {
    "execution": "local installed native macOS application",
    "transport": "stdio",
    "distribution": "Signed helper bundled with Snapperon.app",
    "remote_endpoint": null,
    "setup": "Snapperon Settings → Assistant Connections → Enable AI assistants → Copy Codex Setup or Copy Claude Desktop Setup"
  },
  "platform": {
    "operating_system": "macOS 14 (Sonoma) or later. Screenshot translation in the Mac app requires macOS 15 or later.",
    "architecture": "Apple silicon (M1 or newer)",
    "intel_supported": false
  },
  "verified_clients": [
    "Claude Desktop",
    "Codex Desktop"
  ],
  "proof": {
    "commands": 20,
    "tools": 9,
    "annotationTools": 9,
    "schemaReduction": 57,
    "optionCases": 24146,
    "coreTests": 275,
    "nativeSuites": 38,
    "verificationScope": "Historical annotation campaign for option, core, and native test totals."
  },
  "annotation_tools": [
    "Arrows",
    "Text & Banners",
    "Counters (Numbered Steps)",
    "Highlights",
    "Redaction",
    "Rectangles",
    "Circles",
    "Spotlights",
    "Freehand"
  ],
  "presentation_controls": [
    "Crop",
    "Backgrounds",
    "Padding",
    "Borders",
    "Rounded Corners",
    "Shadows",
    "Watermarks"
  ],
  "option_reference_url": "https://snapperon.com/mcp/#tool-options",
  "annotation_setting_entries": 109,
  "composition_field_count": 18,
  "commands": [
    {
      "name": "get_capabilities",
      "description": "Discover tools, styles, fonts, options, limits and access."
    },
    {
      "name": "get_app_state",
      "description": "Read app state, entitlement, permissions and preference version."
    },
    {
      "name": "list_sources",
      "description": "Refresh authorized open documents, windows and displays."
    },
    {
      "name": "acquire_image",
      "description": "Start an editable document from a supported image, PDF page, or supplied plain text. With clipboard access, start from copied text."
    },
    {
      "name": "extract_text",
      "description": "Recognize text in the original screenshot on the Mac. Read recognized words and regions, configure a selection, copy plain text with clipboard access, or make a portrait reading image."
    },
    {
      "name": "set_text_paste_options",
      "description": "Change the layout, background, or spacing of an existing imported text capture."
    },
    {
      "name": "inspect_document",
      "description": "Read document or staged state and inspect its source/composition image."
    },
    {
      "name": "mark_regions",
      "description": "Prepare grounded semantic callouts around identified regions."
    },
    {
      "name": "edit_document",
      "description": "Prepare all nine annotation tools, selective edits, styling and framing; revise a staged batch."
    },
    {
      "name": "commit_edit",
      "description": "Apply the staged batch as one native Undo action."
    },
    {
      "name": "cancel_operation",
      "description": "Discard a stage or cancel an uncommitted operation."
    },
    {
      "name": "get_operation",
      "description": "Recover an operation result using its original idempotency key."
    },
    {
      "name": "present_document",
      "description": "Show a native editor; control selection, zoom, viewport and window placement."
    },
    {
      "name": "get_document_history",
      "description": "Read exact available Undo/Redo action IDs."
    },
    {
      "name": "navigate_history",
      "description": "Undo or redo the exact available action, refusing intervening changes."
    },
    {
      "name": "set_document_page",
      "description": "Switch PDF pages while preserving each page’s edits."
    },
    {
      "name": "export_document",
      "description": "Render PNG/JPEG, save to an approved folder, copy or run native Copy + Close."
    },
    {
      "name": "update_preferences",
      "description": "Change authorized preferences using the current preference version."
    },
    {
      "name": "perform_native_action",
      "description": "Open native dialogs, settings, help and diagnostics; perform authorized app/window actions."
    },
    {
      "name": "release_document",
      "description": "Release unused assistant handles while preserving existing native editors and retry receipts."
    }
  ],
  "capabilities": [
    {
      "name": "Read and reuse text",
      "description": "Recognize screenshot text locally, make a portrait reading page, or create an editable graphic from supplied words."
    },
    {
      "name": "Import & live window capture",
      "description": "Open local images and PDF pages through the native file dialog, access open documents, import supplied image/PDF bytes where the client supports it, or capture authorized windows and displays. Source lists refresh so newly opened windows appear immediately."
    },
    {
      "name": "All 9 annotation tools",
      "description": "Arrows, text, rectangles, circles, counters, spotlight, redaction, highlighting and freehand. Each is a real native annotation layer."
    },
    {
      "name": "Complete styling & option control",
      "description": "Discover and adjust fonts, colors, sizes, opacity, arrowheads, curves, shadows, effects and redaction treatments. All reviewed local options are mapped; the earlier annotation verification campaign covered 24,146 option cases. Free and Pro style rules still apply."
    },
    {
      "name": "Image presentation",
      "description": "Crop, backgrounds/backdrops, padding, borders, rounded corners, shadows and watermark controls."
    },
    {
      "name": "Selective editing",
      "description": "Select, move, resize, duplicate, reorder, restyle or remove individual annotations without disturbing the rest of the work."
    },
    {
      "name": "Preview before commit",
      "description": "Stage edits, inspect the rendered output, revise the same staged batch and commit it as one native Undo action."
    },
    {
      "name": "Documents, PDF pages & windows",
      "description": "Switch open documents and PDF pages, adjust zoom and window placement, and preserve open work."
    },
    {
      "name": "Export & native handoff",
      "description": "Export PNG/JPEG, copy to an authorized clipboard, save to an approved folder, or invoke native Save As, Share, Preview and Copy + Close. Native dialogs may require your choices; opening one does not complete a save or share."
    },
    {
      "name": "Preferences & diagnostics",
      "description": "Discover settings, update authorized preferences, open native help/settings and save connection diagnostics. Access grants, macOS approvals and account/payment decisions remain native human actions."
    }
  ],
  "client_input_guidance": "In Claude Desktop testing, raw chat-attachment byte transfer failed on the client side. Use Snapperon’s native Open File dialog to select a local image or PDF, or capture an authorized Mac window or display. For a text graphic, acquire_image accepts supplied plain text or reads copied text with clipboard permission.",
  "privacy": "Capture and Apple Vision recognition run locally without screenshot uploads to Snapperon. Your AI client governs any images, previews and extracted text it receives. An assistant with source access can see beneath editable redactions. Share the flattened, redacted export when only the finished image should be visible.",
  "plan_rules": "Local MCP control works without an account in Free and Pro. Standard plan rules still apply: Free includes up to 10 screenshots/day, core styles, Solid redaction and a Snapperon watermark on saved/shared images. Pro adds unlimited captures, the full style and redaction library, and a custom watermark or none. Free includes Extract Text, screenshot translation on macOS 15+ for supported language pairs, Crop, all clipboard text layouts and spacing, and manual filter sliders. Classic reading pages include Plain, Soft and Topo backgrounds. Pro adds Modern and Editorial, six more backgrounds, and the Screenshot Polish and Product True Color filter presets.",
  "scope": "Local desktop app control with on-device Apple Vision OCR. Inputs include still images, PDF pages and plain text. Outputs include PNG/JPEG images, portrait reading-page images and plain text. No hosted HTTP MCP endpoint, headless service, video recording, scrolling capture, QR code reading or PDF re-export."
}
