MCP

Your AI agent now knows iOS-Safari Web Bluetooth.

WebBLE ships a Model Context Protocol server. Add one snippet to your agent’s config — it will scaffold a working Web Bluetooth integration, pick the right peripheral filter, and surface the premium window.webbleIOS APIs when needed.

Claude Code

claude mcp add webble npx -y @ios-web-bluetooth/mcp

Cursor

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "webble": {
      "command": "npx",
      "args": ["-y", "@ios-web-bluetooth/mcp"]
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "webble": {
      "command": "npx",
      "args": ["-y", "@ios-web-bluetooth/mcp"]
    }
  }
}

Zed

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

{
  "context_servers": {
    "webble": {
      "command": {
        "path": "npx",
        "args": ["-y", "@ios-web-bluetooth/mcp"]
      }
    }
  }
}

Other

Generic mcp.json config

{
  "mcpServers": {
    "webble": {
      "command": "npx",
      "args": ["-y", "@ios-web-bluetooth/mcp"]
    }
  }
}

Works out of the box with

What the server exposes

  • scaffold_project — detects your framework, adds the right npm package, wraps the app root
  • pick_filter — given a device category (e.g. heart rate monitor), returns the correct service UUIDs and filter shape
  • premium_api_docs — full schema for window.webbleIOS.backgroundSync, beacons, and Live Activities
  • troubleshoot_extension — walks the user through install / Safari settings / entitlements

Agent-readable surfaces

Read the MCP docs →