@zudello/modelcontextprotocol 1.0.0

package/README.md

@@ -0,0 +1,667 @@
+# Zudello MCP Server
+
+Model Context Protocol (MCP) server exposing **106 Zudello ERP automation tools** for use with Claude Desktop and other MCP-compatible clients.
+
+## ✅ Implementation Status
+
+**Complete**: All 106 tools successfully migrated from inapp-chat to MCP format.
+
+## Features
+
+- **106 Zudello Tools**: Complete access to Zudello ERP operations
+  - 65 read-only tools for data access and discovery
+  - 41 write tools with approval metadata
+- **Multi-tenant Support**: Environment-based auth for stdio mode
+- **Approval Workflow**: Write operations return approval metadata with risk levels
+- **Type-Safe**: Full TypeScript implementation with strict types
+- **ESM Modules**: Modern ES module architecture
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file with your Zudello credentials:
+
+```bash
+ZUDELLO_TOKEN=your_jwt_token_here
+ZUDELLO_ORGANIZATION=your_org_uuid_here
+ZUDELLO_TEAM=your_team_uuid_here
+ZUDELLO_CLUSTER_URL=api.1.eur1.zudello.io  # Optional, defaults shown
+AUTHENTICATION_API_BASE=api.1.global.zudello.io  # Optional, for org-level API (defaults shown)
+LOG_LEVEL=info  # Optional: debug, info, warn, error
+```
+
+### Claude Desktop Setup
+
+**IMPORTANT**: Always use absolute paths (not `~` or relative paths) in your configuration.
+
+#### macOS Configuration
+
+Config file location: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "node",
+      "args": ["/absolute/path/to/research_mcp/dist/index.js"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+**Example with actual path**:
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "node",
+      "args": ["/Users/yourname/projects/research_mcp/dist/index.js"],
+      "env": {
+        "ZUDELLO_TOKEN": "eyJ...",
+        "ZUDELLO_ORGANIZATION": "d49d2841-5cc4-4ffc-9be2-d07900eb1ffb",
+        "ZUDELLO_TEAM": "19078156-f3cf-41eb-a9b4-984f84c24b35",
+        "ZUDELLO_CLUSTER_URL": "api.au.3.zudello.io"
+      }
+    }
+  }
+}
+```
+
+#### Linux Configuration
+
+Config file location: `~/.config/claude/claude_desktop_config.json`
+
+Use the same JSON structure as macOS above.
+
+#### Windows Configuration
+
+Config file location: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "node",
+      "args": ["C:\\path\\to\\research_mcp\\dist\\index.js"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io"
+      }
+    }
+  }
+}
+```
+
+### Claude Code (CLI) Setup
+
+**IMPORTANT**: Always use absolute paths (not `~` or relative paths) in your configuration.
+
+#### macOS/Linux Configuration
+
+Config file location: `~/.config/claude-code/mcp_servers.json`
+
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "node",
+      "args": ["/absolute/path/to/research_mcp/dist/index.js"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+#### Windows Configuration
+
+Config file location: `%APPDATA%\claude-code\mcp_servers.json`
+
+Use the same JSON structure as above.
+
+### Getting Your Credentials
+
+1. **ZUDELLO_TOKEN**: JWT authentication token (starts with "eyJ")
+   - Obtain from your Zudello account settings or API section
+
+2. **ZUDELLO_ORGANIZATION**: Your organization UUID
+   - Format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
+
+3. **ZUDELLO_TEAM**: Your team UUID
+   - Format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
+
+4. **ZUDELLO_CLUSTER_URL**: Your region-specific API cluster
+   - Examples: `api.1.eur1.zudello.io` (Europe), `api.au.3.zudello.io` (Australia), `api.us.1.zudello.io` (US)
+   - Check your Zudello instance URL to determine your cluster
+
+### Setup Steps
+
+1. **Build the project** (required before first use):
+   ```bash
+   cd /path/to/research_mcp
+   npm install
+   npm run build
+   ```
+
+2. **Create/edit config file** with your credentials (see paths above)
+
+3. **Restart Claude** (Desktop or Code)
+
+4. **Verify installation**:
+   - Ask Claude: "What Zudello MCP tools are available?"
+   - You should see a list of 106 tools
+
+### Troubleshooting
+
+**"Server not found" or "Connection failed"**:
+- Verify the path to `dist/index.js` is absolute (not relative or using `~`)
+- Ensure you ran `npm run build` after installation
+- Check that Node.js is in your PATH: `which node` or `node --version`
+
+**"Invalid credentials" or authentication errors**:
+- Verify your ZUDELLO_TOKEN starts with "eyJ"
+- Check ORGANIZATION and TEAM UUIDs are correct format
+- Confirm CLUSTER_URL matches your Zudello instance region
+
+**"ZodError" or validation errors**:
+- This was a bug in versions before the logger fix - ensure you have the latest code
+- Logs must go to stderr, not stdout (fixed in current version)
+
+**Changes not taking effect**:
+- Always restart Claude Desktop/Code after config changes
+- Run `npm run build` after any code changes
+
+## NPM Package Installation
+
+### Installing from NPM Registry
+
+Once published, you can install the package globally or use it with npx:
+
+#### Global Installation
+```bash
+npm install -g @zudello/modelcontextprotocol
+```
+
+#### Using with npx (no installation)
+```bash
+npx @zudello/modelcontextprotocol
+```
+
+### Using NPM Package with Claude Desktop
+
+After installing the npm package, configure Claude Desktop to use it:
+
+#### macOS (`~/Library/Application Support/Claude/claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "npx",
+      "args": ["@zudello/modelcontextprotocol"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+#### Linux (`~/.config/claude/claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "npx",
+      "args": ["@zudello/modelcontextprotocol"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+#### Windows (`%APPDATA%\Claude\claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "npx",
+      "args": ["@zudello/modelcontextprotocol"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+### Using NPM Package with Claude Code
+
+When using the npm package with Claude Code CLI:
+
+#### macOS/Linux (`~/.config/claude-code/mcp_servers.json`)
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "npx",
+      "args": ["@zudello/modelcontextprotocol"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+#### Windows (`%APPDATA%\claude-code\mcp_servers.json`)
+```json
+{
+  "mcpServers": {
+    "zudello": {
+      "command": "npx",
+      "args": ["@zudello/modelcontextprotocol"],
+      "env": {
+        "ZUDELLO_TOKEN": "your_jwt_token",
+        "ZUDELLO_ORGANIZATION": "your_org_uuid",
+        "ZUDELLO_TEAM": "your_team_uuid",
+        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
+        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
+      }
+    }
+  }
+}
+```
+
+## Publishing to NPM
+
+For maintainers who want to publish this package to npm:
+
+### Prerequisites
+1. **NPM Account**: Create account at https://www.npmjs.com
+2. **NPM Login**: Run `npm login` and authenticate
+3. **Package Scope**: Ensure you have access to `@zudello` scope (or update package name)
+
+### Publishing Steps
+
+```bash
+# 1. Ensure you're on the correct branch
+git checkout main  # or develop, depending on your workflow
+
+# 2. Update version (optional - creates git tag)
+npm version patch  # or minor, major
+# This updates package.json and creates a git tag
+
+# 3. Build and validate
+npm run build
+npm run typecheck
+
+# 4. Test the package locally (optional but recommended)
+npm pack  # Creates a tarball
+npm install -g ./zudello-mcp-server-1.0.0.tgz  # Test install
+zudello-mcp --help  # Test binary
+
+# 5. Publish to npm
+npm publish --access public
+# Use --access public for scoped packages (@zudello/*)
+
+# 6. Push git tags
+git push --tags
+```
+
+### Version Management
+
+Follow semantic versioning (semver):
+- **Patch** (1.0.X): Bug fixes, documentation updates
+- **Minor** (1.X.0): New features, backward-compatible
+- **Major** (X.0.0): Breaking changes
+
+```bash
+npm version patch  # 1.0.0 → 1.0.1
+npm version minor  # 1.0.1 → 1.1.0
+npm version major  # 1.1.0 → 2.0.0
+```
+
+### NPM Package Contents
+
+The published package includes:
+- `dist/` - Compiled JavaScript and TypeScript definitions
+- `README.md` - Full documentation
+- `TOOL_CATALOG.md` - Complete tool reference
+- `QUICKSTART.md` - Quick start guide
+- `LICENSE` - MIT license
+
+Excluded from package (see `.npmignore` or package.json `files`):
+- `src/` - TypeScript source files
+- `node_modules/` - Dependencies
+- `.env` - Local configuration
+- Development files
+
+### Publishing Checklist
+
+Before publishing:
+- ✅ All tests pass (`npm test`)
+- ✅ TypeScript compiles without errors (`npm run typecheck`)
+- ✅ Build succeeds (`npm run build`)
+- ✅ README.md is up to date
+- ✅ CHANGELOG.md documents changes (if maintained)
+- ✅ Version number is updated
+- ✅ Git working directory is clean
+- ✅ You're logged into npm (`npm whoami`)
+
+### Unpublishing (Emergency Only)
+
+If you need to unpublish (not recommended):
+```bash
+# Unpublish specific version (within 72 hours of publish)
+npm unpublish @zudello/modelcontextprotocol@1.0.0
+
+# Deprecate instead (preferred)
+npm deprecate @zudello/modelcontextprotocol@1.0.0 "Use version 1.0.1 instead"
+```
+
+### Alternative: Private NPM Registry
+
+For private/internal use:
+```bash
+# Configure private registry
+npm config set registry https://your-private-registry.com
+
+# Or publish to specific registry
+npm publish --registry https://your-private-registry.com
+```
+
+### API Endpoints
+
+The MCP server uses two different API endpoints:
+
+1. **Team-Level API** (`ZUDELLO_CLUSTER_URL`): Used for most operations (106 tools)
+   - Default: `api.1.eur1.zudello.io`
+   - Region-specific endpoints for team data and operations
+   - Examples: EUR1, US1, APAC1 clusters
+
+2. **Organization-Level API** (`AUTHENTICATION_API_BASE`): Used for org admin operations (9 tools)
+   - Default: `api.1.global.zudello.io` (https:// is added automatically)
+   - Global endpoint for cross-team operations
+   - Used by: Teams, Users, and Groups management tools
+   - Override if your org uses a custom authentication service
+   - **Note**: Only provide the domain, protocol is added automatically
+
+## Tool Categories (106 Total)
+
+### Core Operations (3 tools)
+- `zudelloSearch` - Search and filter resources with complex queries
+- `zudelloFetch` - Fetch single resource by UUID or external ID
+- `zudelloPushMessage` - Load Zudello data into conversation context
+
+### Model Discovery (5 tools)
+- `zudelloListModels` - List all available data models
+- `zudelloGetModelMetadata` - Get display names, icons, UI metadata
+- `zudelloGetModelSchema` - Get field definitions and types
+- `zudelloGetModelRelations` - Discover relationships between models
+- `zudelloGetFieldMetadata` - Get detailed field-level metadata
+
+### Configuration Management (5 tools)
+- Read: `zudelloGetConfig`, `zudelloListConfigs`
+- Write: `zudelloCreateConfig`, `zudelloUpdateConfig`, `zudelloUpdateConfigsOrder`
+
+### Resource Operations (2 tools)
+- `zudelloGetResources` - Batch fetch multiple resources
+- `zudelloUpdateOrCreateResources` - Upsert resources in batch
+
+### Automation Rules - Sentences (8 tools)
+- Read: `zudelloGetSentence`, `zudelloGetSentenceTemplate`, `zudelloListSentences`, `zudelloListSentenceTemplates`, `zudelloListSentenceResources`
+- Write: `zudelloCreateSentence`, `zudelloUpdateSentence`, `zudelloUpdateSentencesOrder`
+
+### History (1 tool)
+- `zudelloGetHistory` - View audit trail and change history
+
+### Automation System (10 tools)
+- Scripts: `zudelloGetScript`, `zudelloListScripts`, `zudelloListGlobalIntegrations`, `zudelloListGlobalScriptsForIntegration`
+- Triggers: `zudelloGetTrigger`, `zudelloListTriggers`
+- Logs: `zudelloGetAutomationLogs`, `zudelloGetRunLogs`, `zudelloGetRunLogsContent`, `zudelloSearchRuns`
+
+### Connections (5 tools)
+- `zudelloListConnections` - List integration connections
+- `zudelloCheckConnectionStatus` - Check connection status
+- `zudelloReconnect` - Reconnect integration
+- `zudelloListAvailableIntegrations` - List available integrations
+- `zudelloGetConnectionTemplate` - Get connection template
+
+### Trigger & Sync Control (2 tools)
+- `zudelloSetTriggerEnabled` - Enable/disable triggers (high-risk)
+- `zudelloInitiateSync` - Trigger data sync (high-risk)
+
+### Bulk Operations (2 tools)
+- `zudelloBulkApproveMilestones` - Approve multiple items
+- `zudelloBulkSendReminders` - Send approval reminders
+
+### Approval Workflows (1 tool)
+- `zudelloGetApprovalFlows` - View approval workflow configurations
+
+### Users & Groups (2 tools)
+- `zudelloGetUserGroups` - Get user groups
+- `zudelloGetUsers` - Get team users
+
+### Datasets (4 tools)
+- Read: `zudelloListDatasets`, `zudelloGetDataset`
+- Write: `zudelloCreateDataset`, `zudelloUpdateDataset`
+
+### Field Settings (4 tools)
+- Read: `zudelloListFields`, `zudelloGetField`
+- Write: `zudelloCreateField`, `zudelloUpdateField`
+
+### Quick Actions (5 tools)
+- Read: `zudelloListQuickActions`, `zudelloGetQuickAction`
+- Write: `zudelloCreateQuickAction`, `zudelloUpdateQuickAction`, `zudelloTriggerQuickAction`
+
+### Export Templates (7 tools)
+- Read: `zudelloListExportTemplates`, `zudelloGetExportTemplate`, `zudelloListExports`, `zudelloGetExportDownloadUrl`
+- Write: `zudelloCreateExportTemplate`, `zudelloUpdateExportTemplate`, `zudelloRunExport`
+
+### Document Types (5 tools)
+- Read: `zudelloListDocumentTypes`, `zudelloGetDocumentType`, `zudelloGetMergedFormMetadata`
+- Write: `zudelloCreateDocumentType`, `zudelloUpdateDocumentType`
+
+### Organization Admin (9 tools)
+- Teams: `zudelloListOrgTeams`, `zudelloFetchOrgTeam`, `zudelloUpdateOrgTeam`
+- Users: `zudelloListOrgUsers`, `zudelloFetchOrgUser`, `zudelloCreateOrgUser`, `zudelloUpdateOrgUser`, `zudelloAssignUserToTeam`
+- Groups: `zudelloListOrgUserGroups`
+
+### Notifications (3 tools)
+- `zudelloListNotificationTypes` - List notification types
+- `zudelloGetNotificationPreferences` - Get user preferences
+- `zudelloUpdateNotificationPreferences` - Update preferences
+
+### Exception Reasons (6 tools)
+- Budget: `zudelloListBudgetExceptionReasons`, `zudelloCreateBudgetExceptionReason`, `zudelloUpdateBudgetExceptionReason`
+- Contract: `zudelloListContractExceptionReasons`, `zudelloCreateContractExceptionReason`, `zudelloUpdateContractExceptionReason`
+
+### Language Placeholders (2 tools)
+- `zudelloGetLanguagePlaceholders` - Get custom terminology labels
+- `zudelloUpdateLanguagePlaceholders` - Update terminology
+
+### Inbox Management (8 tools)
+- Domain: `zudelloGetInboundDomain`
+- Inboxes: `zudelloListInboxes`, `zudelloFetchInbox`, `zudelloCreateInbox`, `zudelloUpdateInbox`
+- Templates: `zudelloListInboxTemplates`, `zudelloCreateInboxTemplate`, `zudelloUpdateInboxTemplate`
+
+### Document Context (2 tools)
+- `zudelloCheckDocumentBudgets` - Validate document against budgets
+- `zudelloCheckContractPricing` - Check contract pricing compliance
+
+### Document Statuses (5 tools)
+- Read: `zudelloListStatuses`, `zudelloGetStatus`
+- Write: `zudelloCreateStatus`, `zudelloUpdateStatus`, `zudelloReorderStatuses`
+
+## Development
+
+```bash
+# Development mode with auto-reload
+npm run dev
+
+# Type check
+npm run typecheck
+
+# Build
+npm run build
+```
+
+## Architecture
+
+```
+app-mcp/
+├── src/
+│   ├── index.ts              # MCP server entry point
+│   ├── context/
+│   │   └── auth.ts           # Multi-tenant authentication
+│   ├── tools/                # 106 tool implementations
+│   │   ├── core/             # Core operations (3)
+│   │   ├── models/           # Model discovery (5)
+│   │   ├── config/           # Configuration (5)
+│   │   ├── resources/        # Resource operations (2)
+│   │   ├── sentences/        # Automation rules (8)
+│   │   ├── history/          # History (1)
+│   │   ├── automation/       # Automation system (10)
+│   │   ├── connections/      # Connections (5)
+│   │   ├── control/          # Trigger/sync control (2)
+│   │   ├── bulk/             # Bulk operations (2)
+│   │   ├── approvals/        # Approval workflows (1)
+│   │   ├── users/            # Users & groups (2)
+│   │   ├── admin/            # Datasets, fields, quick actions (13)
+│   │   ├── documents/        # Export templates, document types (12)
+│   │   ├── org-admin/        # Organization admin (9)
+│   │   ├── notifications/    # Notifications (3)
+│   │   ├── exceptions/       # Exception reasons (6)
+│   │   ├── language/         # Language placeholders (2)
+│   │   ├── document-context/ # Document validation (2)
+│   │   ├── inboxes/          # Inbox management (8)
+│   │   └── statuses/         # Document statuses (5)
+│   ├── services/
+│   │   └── zudello/          # Zudello API service layer
+│   │       ├── core.ts       # Auth and base request building
+│   │       ├── resources.ts  # Resource CRUD
+│   │       ├── automation.ts # Automation operations
+│   │       ├── sentences.ts  # Sentence operations
+│   │       ├── documents.ts  # Document operations
+│   │       ├── organization.ts # Org admin operations
+│   │       ├── notifications.ts
+│   │       ├── language.ts
+│   │       ├── document-context.ts
+│   │       ├── inboxes.ts
+│   │       └── types.ts      # Service type definitions
+│   ├── constants/
+│   │   └── zudello.ts        # Zudello constants (1807 lines)
+│   ├── utils/
+│   │   └── logger.ts         # Structured logging
+│   └── types/
+│       └── index.ts          # TypeScript type definitions
+└── dist/                     # Compiled JavaScript (ESM)
+```
+
+## Tool Approval Metadata
+
+Write tools (41 total) return approval metadata with risk levels:
+
+### High Risk (11 tools)
+- Trigger/sync control (2): `zudelloSetTriggerEnabled`, `zudelloInitiateSync`
+- Config/resources (2): `zudelloUpdateConfig`, `zudelloUpdateOrCreateResources`
+- Automation (1): `zudelloUpdateSentence`
+- Datasets/fields (2): `zudelloUpdateDataset`, `zudelloUpdateField`
+- Quick actions (2): `zudelloUpdateQuickAction`, `zudelloTriggerQuickAction`
+- Document types (1): `zudelloUpdateDocumentType`
+- Org admin (1): `zudelloCreateOrgUser`
+
+### Medium Risk (24 tools)
+- Configuration (1): `zudelloCreateConfig`
+- Automation (1): `zudelloCreateSentence`
+- Bulk operations (2): `zudelloBulkApproveMilestones`, `zudelloBulkSendReminders`
+- Admin tools (6): Create/update datasets, fields, statuses, quick actions, export templates, document types
+- Org admin (2): `zudelloUpdateOrgUser`, `zudelloUpdateOrgTeam`
+- Exception reasons (4): Create/update budget and contract exceptions
+- Language (1): `zudelloUpdateLanguagePlaceholders`
+- Inboxes (4): Create/update inboxes and templates
+- Document types (1): `zudelloCreateDocumentType`
+- Statuses (2): `zudelloCreateStatus`, `zudelloUpdateStatus`
+
+### Low Risk (6 tools)
+- Reorder operations (3): Configs, sentences, statuses
+- Notifications (1): `zudelloUpdateNotificationPreferences`
+- Push message (1): `zudelloPushMessage`
+- Export (1): `zudelloRunExport`
+
+## Migration from inapp-chat
+
+This MCP server is a complete migration of all 106 Zudello tools from the inapp-chat Next.js application. Key changes:
+
+1. **Tool Format**: Migrated from AI SDK format to MCP format
+2. **Authentication**: Changed from Next.js context to explicit AuthContext parameter
+3. **Approval Pattern**: Converted from AI SDK `needsApproval` to MCP `requiresApproval` with `approvalMetadata`
+4. **Service Layer**: Modified to accept AuthContext as first parameter
+5. **Module System**: Converted to ESM with `.js` extensions in imports
+
+## Testing
+
+The MCP server can be tested by:
+1. Running `npm run build` to ensure all tools compile
+2. Configuring Claude Desktop with the server
+3. Testing tool calls through Claude Desktop
+
+## Publishing
+
+This package is automatically published to npm when code is pushed to the `main` branch via GitHub Actions.
+
+For detailed information about:
+- Setting up npm authentication
+- Version management
+- Manual publishing
+- Troubleshooting
+
+See [PUBLISHING.md](./PUBLISHING.md)
+
+## License
+
+MIT
+
+## Author
+
+Zudello