Release v1.0.1 — repo polish and icon updates

- Bump version to 1.0.1 in package.json and manifest.json
- Update icon-light PNGs with white backgrounds (512, 32, 16)
- Add npm version, Node.js, and TypeScript badges to README
- Clarify that end users only need Node.js/npm; Bun removed from docs
- Add @modelcontextprotocol/sdk to Acknowledgments
- Update CLAUDE.md with release/deployment docs, MCPB build steps, file reference
- Exclude stray root icon-light.png from MCPB bundle

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: WeAreLocalFalcon

.mcpbignore

@@ -15,5 +15,8 @@ mcpb-packaging-brief.md
 bun.lock
 Dockerfile
 
+# Stray files
+/icon-light.png
+
 # Already bundled or unnecessary
 node_modules/.cache/

CLAUDE.md

@@ -4,9 +4,10 @@
 
 This is the **Local Falcon MCP Server** (`@local-falcon/mcp`), a Model Context Protocol server that wraps the [Local Falcon API](https://docs.localfalcon.com). It enables AI agents to run geo-grid rank tracking scans, retrieve reports, manage campaigns, monitor Google Business Profiles, and analyze competitive positioning across Google Maps, Apple Maps, and AI search platforms.
 
-**Package:** `@local-falcon/mcp` (npm)
+**Package:** [`@local-falcon/mcp`](https://www.npmjs.com/package/@local-falcon/mcp) (npm)
+**Version:** 1.0.1
 **License:** MIT
-**Runtime:** Node.js / Bun
+**Runtime:** Node.js 18+
 **Language:** TypeScript (strict mode)
 
 ## Architecture
@@ -42,10 +43,10 @@ Started via CLI argument to `index.ts`:
 
 | Mode | Command | Description |
 |---|---|---|
-| `stdio` (default) | `bun run index.ts` or `bun run index.ts stdio` | Standard I/O for local MCP clients |
-| `sse` | `bun run index.ts sse` | Server-Sent Events, OAuth 2.1 protected |
-| `http` | `bun run index.ts http` | Streamable HTTP, OAuth 2.1 protected |
-| `HTTPAndSSE` | `bun run index.ts HTTPAndSSE` | Both HTTP and SSE on same server |
+| `stdio` (default) | `npm run start` or `npm run start:stdio` | Standard I/O for local MCP clients |
+| `sse` | `npm run start:sse` | Server-Sent Events, OAuth 2.1 protected |
+| `http` | `npm run start:http` | Streamable HTTP, OAuth 2.1 protected |
+| `HTTPAndSSE` | `npm run start:HTTPAndSSE` | Both HTTP and SSE on same server |
 
 Remote modes (SSE, HTTP) use OAuth 2.1 with PKCE for authentication. The server implements RFC 8414 (Authorization Server Metadata), RFC 9728 (Protected Resource Metadata), and RFC 7591 (Dynamic Client Registration).
 
@@ -205,15 +206,31 @@ The Local Falcon API has two base URLs used by `localfalcon.ts`:
 
 Public API documentation: [docs.localfalcon.com](https://docs.localfalcon.com)
 
+## Release & Deployment
+
+| Component | Details |
+|---|---|
+| npm auto-publish | GitHub Action (`.github/workflows/npm-publish.yml`) triggers on GitHub release creation |
+| MCPB packaging | `manifest.json` (v0.3 spec) + `.mcpbignore` + `mcpb pack . local-falcon-mcp.mcpb` |
+| OAuth 2.1 | Working end-to-end for remote transports (SSE, HTTP). RFC 8414 / RFC 9728 / RFC 7591 |
+| SKILL.md | AI client integration skill definition in `skill/` with 3 reference files |
+
+### MCPB Build
+```bash
+npm run build                          # Compile TypeScript to dist/
+mcpb validate manifest.json            # Validate manifest
+mcpb pack . local-falcon-mcp.mcpb      # Create .mcpb bundle
+```
+
 ## Development
 
 ### Prerequisites
-- Node.js 18+ or Bun
+- Node.js 18+
 - TypeScript 5.8+
 
 ### Setup
 ```bash
-npm install        # or: bun install
+npm install
 cp .env.example .env.local
 # Add your LOCAL_FALCON_API_KEY to .env.local
 ```
@@ -270,8 +287,11 @@ npm run docker:run
 | `localfalcon.ts` | API client — fetch functions, rate limiter, retry logic, types |
 | `oauth/` | OAuth 2.1 implementation (authorization, tokens, PKCE, client registration) |
 | `package.json` | Package config, scripts, dependencies |
+| `manifest.json` | MCPB Desktop Extension manifest (v0.3 spec) — tools, icons, user_config |
+| `.mcpbignore` | Exclusion patterns for MCPB bundle creation |
 | `tsconfig.json` | TypeScript compiler configuration |
 | `.env.example` | Environment variable template |
 | `Dockerfile` | Container build configuration |
-| `skill/` | MCP skill definition (SKILL.md) and reference docs for AI client integration |
+| `skill/` | MCP skill definition (SKILL.md) and 3 reference docs for AI client integration |
+| `.github/workflows/` | npm auto-publish on GitHub release |
 | `_spec/` | Internal development specs (gitignored, not published) |

README.md

@@ -9,7 +9,10 @@
 </p>
 
 <p align="center">
-    <a href="https://github.com/local-falcon/mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://www.npmjs.com/package/@local-falcon/mcp"><img src="https://img.shields.io/npm/v/@local-falcon/mcp.svg" alt="npm version"></a>
+  <a href="https://github.com/local-falcon/mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node.js"></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.8-blue.svg" alt="TypeScript"></a>
   <a href="https://www.localfalcon.com"><img src="https://img.shields.io/badge/Local%20Falcon-Website-red" alt="Local Falcon"></a>
   <a href="https://docs.localfalcon.com"><img src="https://img.shields.io/badge/API%20Docs-docs.localfalcon.com-green" alt="API Docs"></a>
 </p>
@@ -200,30 +203,35 @@ For Windows:
 
 ---
 
-## For developers
+## For Developers
 
-- Build (necessary to run in local MCP host applications):
+> **Note:** End users only need [Node.js](https://nodejs.org/) (LTS) and npm to install and run this server. The instructions below are for contributors and developers working on the source code.
 
-  ```bash
-  bun run build
-  ```
+### Prerequisites
 
-- Run MCP Inspector:
-  ```bash
-  bun run inspector
-  ```
+- [Node.js](https://nodejs.org/) 18+ (LTS recommended)
+- npm (included with Node.js)
 
-- Run MCP Server:
+### Build
 
-  Run one of the following:
+```bash
+npm install
+npm run build
+```
+
+### Run MCP Inspector
+
+```bash
+npm run inspector
+```
 
-  ```bash
-  bun run start
-  bun run start:sse
-  bun run start:stdio
-  ```
+### Run MCP Server
 
-  Note: if sse is not specified, the server will default to stdio.
+```bash
+npm run start             # STDIO mode (default)
+npm run start:sse         # SSE mode with OAuth
+npm run start:http        # HTTP mode with OAuth
+```
 
 
 ---
@@ -238,4 +246,4 @@ MIT
 ## Acknowledgments
 - [Local Falcon API Documentation](https://docs.localfalcon.com)
 - [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol)
-- [Bun](https://bun.sh/)
+- [@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk) (Anthropic MCP SDK)

assets/icons/icon-light-16.png

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "local-falcon-mcp",
   "display_name": "Local Falcon",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Monitor and improve visibility across AI search platforms (ChatGPT, Gemini, Grok, Google AI Overviews, AI Mode) and in local search (Google Maps, Apple Maps) with 37 tools for AI visibility tracking, geo-grid rank analysis, competitor intelligence, campaign management, and Google Business Profile monitoring.",
   "long_description": "An MCP server for the Local Falcon AI Visibility and local SEO platform. Connect Claude to your Local Falcon account to track how businesses appear across AI search results and traditional map platforms.\n\nCapabilities include running geo-grid scans that check visibility from dozens of surrounding coordinates simultaneously, retrieving scan reports with AI-powered analysis, tracking visibility trends over time, managing scheduled campaigns across multiple locations and keywords, monitoring Google Business Profiles for unwanted changes with Falcon Guard, analyzing reviews with sentiment and topic breakdowns, and researching competitors to identify strategic opportunities.\n\nSupported platforms: Google Maps, Apple Maps, Google AI Overviews, Google AI Mode, ChatGPT, Gemini, and Grok.",
   "author": {

assets/icons/icon-light-32.png

@@ -1,6 +1,6 @@
 {
   "name": "@local-falcon/mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "An MCP server for the Local Falcon API.",
   "main": "index.js",
   "repository": {