# mcp

This server gives coding agents tools for beacio Web Bluetooth work in iOS Safari, from project scaffolding to integration checks and troubleshooting.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: wklm
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wklm/beacio-sdk/tree/HEAD/packages/mcp
- Updated: 2026-09-17
- HTML: https://affpapa.org/en/nevibecode/mcp/wklm-mcp

## What it does

The server guides an agent through adding beacio to a Web Bluetooth app. Its consumer tools produce setup plans for HTML and several JavaScript frameworks, patch an existing application, verify the polyfill and build, detect iOS support, and return BLE profile examples. It also covers premium beacio surfaces and common connection failures.

The package includes the `beacio` CLI with `init`, `migrate`, and `check` commands. Developer mode adds tools for the beacio monorepo, including documentation search, structure inspection, and example lookup. Tool responses include links to beacio’s machine-readable documentation. Telemetry is enabled by default, so each call sends a minimal event; `BEACIO_MCP_TELEMETRY` or `DO_NOT_TRACK=1` disables it.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @beacio/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp -- npx -y @beacio/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@beacio/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@beacio/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp npx -y @beacio/mcp
```

## When to use it
- scaffold a beacio Web Bluetooth integration
- patch an existing app for iOS Safari
- verify the polyfill and project build
- diagnose a dropped BLE connection
- find a ready BLE profile example

## Example prompts
- Create a beacio setup plan for a `react` app using `npm` with `beacio_install_plan`.
- Patch this existing Web Bluetooth app for iOS Safari with `beacio_patch_existing_app`.
- Run the integration checks and investigate `device-disconnects` using `beacio_verify_integration` and `beacio_troubleshoot`.

## Similar
- [flutter-fix-layout-issues](https://affpapa.org/en/nevibecode/skills/flutter-fix-layout-issues.md) — skill · 39900 installs
- [expo-web-to-native](https://affpapa.org/en/nevibecode/skills/expo-web-to-native.md) — skill · 19600 installs
- [react-native-expert](https://affpapa.org/en/nevibecode/skills/react-native-expert.md) — skill · 4900 installs
- [build-zoom-virtual-agent](https://affpapa.org/en/nevibecode/skills/anthropics-build-zoom-virtual-agent.md) — skill · 2100 installs
- [design-mobile-apps](https://affpapa.org/en/nevibecode/skills/design-mobile-apps.md) — skill · 1000000 installs
- [vercel-react-native-skills](https://affpapa.org/en/nevibecode/skills/vercel-react-native-skills.md) — skill · 255200 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md