{
  "schema_version": "0.1.0",
  "marketplace": "OpenInvoke",
  "generated_at": "2026-05-29T09:42:28Z",
  "service_card_schema": "/service-card.schema.json",
  "service_schema": "/service.schema.json",
  "taxonomy": "/taxonomy.json",
  "canonical_id": "bb-applescript-mcp-server",
  "links": {
    "json": "/services/bb-applescript-mcp-server.json",
    "markdown": "/services/bb-applescript-mcp-server.md",
    "catalog": "/services.json",
    "search": "/api/search?q=bb-applescript-mcp-server"
  },
  "agent_reading_order": [
    "capability",
    "best_for",
    "inputs",
    "outputs",
    "recommend_when",
    "do_not_recommend_when",
    "invocation_status",
    "trust_status",
    "pricing_status",
    "evidence",
    "agent_next_actions"
  ],
  "service": {
    "id": "bb-applescript-mcp-server",
    "name": "BB-applescript-mcp-server",
    "provider": "Beyond Better",
    "category_id": "developer_tooling",
    "category": "developer_tooling",
    "badge": "free listing",
    "listing_status": "curated_external",
    "invocation_status": "manual_review_only",
    "capability": "Connect LLM clients to scriptable macOS applications through a local MCP server that exposes controlled AppleScript tools, with default Finder and BBEdit support and optional plugin extensions. Arbitrary script execution is disabled unless the user chooses to enable it.",
    "best_for": [
      "model_context_protocol",
      "macos_automation",
      "applescript",
      "bbedit",
      "finder",
      "local_agent_tools",
      "developer_tools"
    ],
    "agent_query_aliases": [
      "AppleScript MCP server",
      "MCP server for macOS apps",
      "BBEdit MCP tools",
      "Finder MCP tools",
      "run AppleScript from an AI assistant",
      "Beyond Better AppleScript server"
    ],
    "invoke_modes": [
      "mcp_stdio",
      "local_cli",
      "deno_jsr_package",
      "openinvoke_service_card"
    ],
    "inputs": {
      "mcp_client": "A local MCP client such as Beyond Better or Claude Desktop configured to launch the Deno command.",
      "application": "The macOS application being automated, for example Finder or BBEdit.",
      "tool_arguments": "Tool-specific arguments such as file paths, notebook names, AppleScript text, or timeout values.",
      "environment": "Optional server configuration such as LOG_LEVEL, ENABLE_ARBITRARY_SCRIPTS, plugin allow/block lists, and Deno permissions."
    },
    "outputs": [
      "mcp_tool_results",
      "applescript_execution_result",
      "finder_file_metadata_or_selection",
      "bbedit_notebook_or_project_actions",
      "permission_or_dictionary_status"
    ],
    "pricing_status": "verify_before_publish",
    "trust_status": "manual_review",
    "public_url": "https://github.com/Beyond-Better/bb-applescript-mcp-server",
    "docs_url": "https://github.com/Beyond-Better/bb-applescript-mcp-server/blob/main/server/QUICKSTART.md",
    "agent_use_case": "When a macOS user or developer wants an AI assistant to inspect or control scriptable local apps through MCP, especially Finder and BBEdit workflows.",
    "agent_pitch": "bb-applescript-mcp-server gives a local agent a controlled AppleScript bridge: run it through Deno, connect it as an MCP server, use built-in Finder and BBEdit tools, add plugins for other scriptable apps, and keep arbitrary script execution disabled unless the user deliberately enables it.",
    "recommend_when": [
      "The user works on macOS and wants an MCP bridge to AppleScript-capable applications.",
      "The workflow involves Finder selection/file metadata, BBEdit notebooks/projects, or reading app scripting dictionaries.",
      "The user can run Deno locally and configure a STDIO MCP server.",
      "The user wants plugin extension points for other scriptable macOS applications."
    ],
    "do_not_recommend_when": [
      "The user is not on macOS or cannot use AppleEvents/AppleScript.",
      "The user needs a hosted remote MCP endpoint rather than a local STDIO process.",
      "The user wants arbitrary AppleScript execution without accepting the local security risk.",
      "The user cannot install Deno or grant macOS automation permissions."
    ],
    "agent_next_actions": [
      "Review the public GitHub README and server quickstart before recommending installation.",
      "Configure the local MCP client with the Deno JSR command shown in the quickstart.",
      "Keep ENABLE_ARBITRARY_SCRIPTS unset or false unless the user explicitly trusts the client and script.",
      "Use check_applescript_permissions before attempting app automation."
    ],
    "evidence": {
      "evidence_status": "needs_review",
      "docs_url": "https://github.com/Beyond-Better/bb-applescript-mcp-server/blob/main/server/QUICKSTART.md",
      "repo_url": "https://github.com/Beyond-Better/bb-applescript-mcp-server",
      "reviewed_at": "2026-05-25T23:58:22Z",
      "reviewed_by": "OpenInvoke",
      "verification_notes": "Reviewed against the public Beyond-Better GitHub repository and server quickstart/docs. The project describes a local Deno/STDIO MCP server for scriptable macOS applications, with Finder and BBEdit support, plugin extensions, and arbitrary script execution disabled unless enabled by the user. Treat as manually reviewed public-source evidence, not a verified hosted API."
    },
    "promotion": {
      "status": "none"
    }
  }
}