{
  "name": "Snapperon",
  "description": "Snapperon is a native Swift and AppKit screenshot editor for Mac. Its local Model Context Protocol (MCP) server lets Claude Desktop and Codex Desktop control the installed app through 18 commands. All 9 annotation tools, every reviewed style option and the presentation controls are available, with rendered previews and one-step Undo for each committed edit batch.",
  "metadata_type": "informational_local_mcp_discovery",
  "release_status": "live",
  "updated": "2026-11-14",
  "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",
    "architecture": "Apple silicon (M1 or newer)",
    "intel_supported": false
  },
  "verified_clients": [
    "Claude Desktop",
    "Codex Desktop"
  ],
  "proof": {
    "commands": 18,
    "tools": 9,
    "schemaReduction": 57,
    "optionCases": 24146,
    "coreTests": 275,
    "nativeSuites": 38
  },
  "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": "Acquire a source or supported supplied PNG/JPEG/PDF bytes as an editable document."
    },
    {
      "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": "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 verification corpus covers 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. Do not rely on raw chat-attachment byte transfer.",
  "privacy": "Snapperon runs the MCP interface locally on your Mac and does not upload screenshots to Snapperon servers. If your assistant inspects a source image or rendered preview, your chosen AI client may send it to its provider under that client’s settings and policies.",
  "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.",
  "scope": "Local desktop app control only. No hosted HTTP MCP endpoint, cloud API, headless Linux service, video recording, scrolling capture, general OCR or PDF re-export."
}