chore: Prepare v2.0.0-rc2 release with npm package improvements

- Add bin field to package.json for npx support
- Add preferGlobal: false to indicate npx-first usage
- Update version to 2.0.0-rc2 across package.json and flake.nix
- Update flake.nix to use --omit=dev instead of deprecated --production
- Update README with prominent npx and Nix usage examples
- Simplify GitHub Actions npm publish workflow
- Remove duplicate npm-publish.yml workflow

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: gui-wf

.github/workflows/npm-publish.yml

@@ -4,92 +4,17 @@ on:
   push:
     tags:
       - 'v*'
-      - '[0-9]+.[0-9]+.[0-9]+*'
 
 jobs:
   publish:
     runs-on: ubuntu-latest
     permissions:
-      contents: write
-      pull-requests: write
+      contents: read
+      id-token: write
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Install Nix
-        uses: cachix/install-nix-action@v24
-        with:
-          nix_path: nixpkgs=channel:nixos-unstable
-
-      - name: Extract version from tag
-        id: version
-        run: |
-          # Remove 'v' prefix if present
-          VERSION="${GITHUB_REF#refs/tags/}"
-          VERSION="${VERSION#v}"
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "📌 Target version: $VERSION"
-
-      - name: Update version in files
-        id: update
-        run: |
-          echo "🔄 Running version update script..."
-          nix run .#update-version -- -y "${{ steps.version.outputs.version }}" > version-output.txt 2>&1
-
-          # Check if changes were made
-          if grep -q "No changes needed" version-output.txt; then
-            echo "changes_needed=false" >> $GITHUB_OUTPUT
-            echo "ℹ️  No version updates needed"
-          else
-            echo "changes_needed=true" >> $GITHUB_OUTPUT
-            echo "✅ Version files updated"
-          fi
-
-          # Save output for PR body
-          cat version-output.txt
-
-      - name: Create Pull Request
-        if: steps.update.outputs.changes_needed == 'true'
-        uses: peter-evans/create-pull-request@v5
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: |
-            chore: Update version to ${{ steps.version.outputs.version }}
-
-            Automated version sync for tag ${{ github.ref_name }}
-          title: 'chore: Sync version to ${{ steps.version.outputs.version }}'
-          body: |
-            ## Version Sync Required
-
-            Latest version was changed to `${{ steps.version.outputs.version }}`, and the following files need updating to sync with the tagged version:
-
-            **Changed files:**
-            - `package.json`
-            - `flake.nix`
-
-            ### Diff
-
-            ```diff
-            $(cat version-output.txt)
-            ```
-
-            ---
-
-            🤖 This PR was created automatically by the **Publish to npm** workflow.
-
-            **Next steps:**
-            1. Review the changes
-            2. Merge this PR
-            3. The npm publish will proceed after merge
-          branch: automated/version-sync-${{ steps.version.outputs.version }}
-          delete-branch: true
-          draft: false
-          labels: |
-            automated
-            version-sync
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -107,28 +32,15 @@ jobs:
         run: npm run test:mock
 
       - name: Publish to npm
-        if: steps.update.outputs.changes_needed == 'false'
-        run: npm publish
+        run: npm publish --provenance --access public
         env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Publish summary
-        if: steps.update.outputs.changes_needed == 'false'
         run: |
+          VERSION="${GITHUB_REF#refs/tags/v}"
           echo "## ✅ Published to npm" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
-          echo "- **Version**: ${{ steps.version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: $VERSION" >> $GITHUB_STEP_SUMMARY
           echo "- **Package**: [purelymail-mcp-server](https://www.npmjs.com/package/purelymail-mcp-server)" >> $GITHUB_STEP_SUMMARY
           echo "- **Tag**: ${{ github.ref_name }}" >> $GITHUB_STEP_SUMMARY
-
-      - name: Waiting for version sync
-        if: steps.update.outputs.changes_needed == 'true'
-        run: |
-          echo "## ⏳ Waiting for Version Sync" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "A pull request has been created to sync version files." >> $GITHUB_STEP_SUMMARY
-          echo "npm publish will proceed after the PR is merged and the tag is re-pushed." >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "**Action required:**" >> $GITHUB_STEP_SUMMARY
-          echo "1. Review and merge the version sync PR" >> $GITHUB_STEP_SUMMARY
-          echo "2. Re-tag: \`git tag -f ${{ github.ref_name }} && git push -f origin ${{ github.ref_name }}\`" >> $GITHUB_STEP_SUMMARY

.github/workflows/publish-npm.yml

@@ -2,10 +2,7 @@
   "mcpServers": {
     "purelymail": {
       "command": "npx",
-      "args": [
-        "tsx",
-        "/home/guibaeta/Projects/purelymail-mcp-server/src/index.ts"
-      ],
+      "args": ["-y", "purelymail-mcp-server"],
       "env": {
         "PURELYMAIL_API_KEY": "${PURELYMAIL_API_KEY}",
         "MOCK_MODE": "false"

.mcp.json

@@ -2,6 +2,36 @@
 
 A Model Context Protocol (MCP) server that provides AI assistants with access to PurelyMail's email management API.
 
+## Usage
+
+**Run with npx (no installation needed):**
+
+```bash
+npx -y purelymail-mcp-server
+```
+
+**Or use Nix (via GitHub flake):**
+
+```bash
+nix run github:gui-wf/purelymail-mcp-server
+```
+
+**Configure in your MCP client:**
+
+```json
+{
+  "mcpServers": {
+    "purelymail": {
+      "command": "npx",
+      "args": ["-y", "purelymail-mcp-server"],
+      "env": {
+        "PURELYMAIL_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
 ## Features
 
 - **Type-Safe API Integration**: Generated TypeScript client from PurelyMail's swagger specification
@@ -48,14 +78,14 @@ node dist/index.js
 
 Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 
-#### When installed via npm:
+#### Using npx (recommended - no installation):
 
 ```json
 {
   "mcpServers": {
     "purelymail": {
       "command": "npx",
-      "args": ["purelymail-mcp-server"],
+      "args": ["-y", "purelymail-mcp-server"],
       "env": {
         "PURELYMAIL_API_KEY": "your-api-key-here"
       }
@@ -64,7 +94,7 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
 }
 ```
 
-#### Using Nix flake from GitHub:
+#### Using Nix from GitHub:
 
 ```json
 {
@@ -121,7 +151,7 @@ For Claude Code, create a `.mcp.json` file in your project root:
   "mcpServers": {
     "purelymail": {
       "command": "npx",
-      "args": ["purelymail-mcp-server"],
+      "args": ["-y", "purelymail-mcp-server"],
       "env": {
         "PURELYMAIL_API_KEY": "${PURELYMAIL_API_KEY}"
       }
@@ -177,14 +207,14 @@ The server provides 19 individual tools, each corresponding to a specific Purely
 
 ## Installation
 
-### Via npm (Recommended)
+### Via npx (Recommended - No Installation)
 ```bash
-npm install -g purelymail-mcp-server
+npx -y purelymail-mcp-server
 ```
 
-### Via npx (No Installation)
+### Via Nix (GitHub Flake)
 ```bash
-npx purelymail-mcp-server
+nix run github:gui-wf/purelymail-mcp-server
 ```
 
 ### From Source

README.md

@@ -70,14 +70,14 @@
         packages.default = pkgs.stdenv.mkDerivation {
           pname = "purelymail-mcp-server";
           # AIDEV-TODO: Make version update dynamic and based on whats defined in package.json - to not have to edit many files
-          version = "2.0.0-rc1";
+          version = "2.0.0-rc2";
           src = ./.;
 
           buildInputs = [ pkgs.nodejs_20 ];
 
           buildPhase = ''
             # Install dependencies (production only)
-            npm ci --production
+            npm ci --omit=dev
 
             # Generate types if spec exists (no network calls during build)
             if [ -f purelymail-api-spec.json ]; then

flake.nix

@@ -1,6 +1,6 @@
 {
   "name": "purelymail-mcp-server",
-  "version": "2.0.0-rc1",
+  "version": "2.0.0-rc2",
   "description": "MCP server for PurelyMail email service management",
   "keywords": [
     "mcp",
@@ -21,6 +21,9 @@
   "license": "SEE LICENSE IN LICENSE",
   "author": "Guilherme Fontes <[email protected]> (https://gui.wf)",
   "main": "dist/index.js",
+  "bin": {
+    "purelymail-mcp-server": "dist/index.js"
+  },
   "files": [
     "dist/",
     "src/types/",
@@ -31,6 +34,7 @@
   "publishConfig": {
     "access": "public"
   },
+  "preferGlobal": false,
   "type": "module",
   "scripts": {
     "fetch:swagger": "node scripts/fetch-swagger.js",