Your AI agent now knows iOS-Safari Web Bluetooth.

beacio ships a Model Context Protocol server. Add one snippet to your agent’s config: it gets an exact install plan for your framework, ready-to-paste code for common BLE devices, and the premium window.beacioIOS APIs when needed.

Claude Code

claude mcp add beacio npx -y @beacio/mcp

Cursor

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "beacio": {
      "command": "npx",
      "args": ["-y", "@beacio/mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "beacio": {
      "command": "npx",
      "args": ["-y", "@beacio/mcp"]
    }
  }
}

Zed

Add to ~/.config/zed/settings.json

{
  "context_servers": {
    "beacio": {
      "command": {
        "path": "npx",
        "args": ["-y", "@beacio/mcp"]
      }
    }
  }
}

Other

Generic mcp.json config

{
  "mcpServers": {
    "beacio": {
      "command": "npx",
      "args": ["-y", "@beacio/mcp"]
    }
  }
}

Works out of the box with

What the server exposes

  • beacio_install_plan — an install plan for your framework and package manager: exact shell commands, the files to edit, and a runnable snippet
  • beacio_patch_existing_app — the edits that make an existing Chrome or Android Web Bluetooth app work in iOS Safari (apply them with beacio migrate)
  • beacio_verify_integration — shell commands and pass criteria that confirm the integration is correct
  • beacio_example — ready-to-paste code for a common BLE profile: heart rate, battery, CGM, lock, beacon or peripheral chat
  • beacio_detect_ios_support — a runtime detection snippet for navigator.bluetooth and window.beacioIOS, with the ways detection can go wrong on iPhone
  • beacio_premium_guide — one iOS-only premium API (background sync, notifications, Live Activities, beacons, peripheral mode or white label) with a runnable example
  • beacio_troubleshoot — a diagnostic checklist and the most common fix for four failure modes
  • beacio_spec_citation — the W3C Web Bluetooth spec link, a summary and caveats for one method

With --developer, for agents working inside the beacio source repository, it also exposes:

  • beacio_dev_best_practices — the project’s AGENTS.md best-practices guide, optionally one topic
  • beacio_dev_search_docs — a keyword search of the beacio documentation index, with beacio.com links
  • beacio_dev_list_structure — a tree view of the repository’s directory structure
  • beacio_dev_find_examples — a search of a curated index of key source files, with path and line

Agent-readable surfaces