Activity Reporting MCP Server

# Changelog All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines. ## [0.2.0](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.1.3...v0.2.0) (2025-11-04) ### ⚠ BREAKING CHANGES * ADVOCU_ACCESS_TOKEN is now optional but either GDE or MVP configuration must be provided ### Features * add Microsoft MVP API support and unified server ([#127](https://github.com/carlosazaustre/advocu-mcp-server/issues/127)) ([00265a4](https://github.com/carlosazaustre/advocu-mcp-server/commit/00265a447810d06d08d77922ed70a6a0b174aa2b)) ## [0.2.0] (2025-10-12) ### Major Features * **Microsoft MVP Integration**: Complete integration with Microsoft MVP API - Video activity submission - Blog post submission - Speaking engagement submission - Automatic token management and validation - Comprehensive error handling * **Unified Server**: Single server supporting both GDE (Advocu) and MVP programs - Conditional tool enablement based on configured credentials - Unified configuration via environment variables - Dual program support for users in both programs * **MCP Resources**: Documentation accessible via MCP resources - `docs://api-reference` - Complete API documentation - `docs://mvp-api-reference` - Detailed MVP API reference - `docs://mvp-fixes-changelog` - MVP integration fixes changelog - `docs://error-handling` - Error handling improvements guide - `docs://mcp-resources` - MCP resources usage guide ### Improvements * **Error Handling**: Enhanced error messages returned as content instead of exceptions - Contextual error messages by HTTP status code (401, 400, 429) - Detailed troubleshooting steps for authentication failures - Activity context included in error messages * **API Validation**: Strict validation for MVP API - Activity type validation (Video, Blog, Speaking, Book/E-book) - Role validation per activity type - Target audience validation - Technology focus area support * **Token Management**: Simplified token capture and management - HAR file export support for complete token capture - Environment variable configuration - Token validation on server startup ### Bug Fixes * **MVP Activity Types**: Fixed incorrect activity type names - Removed invalid `WEBINAR_ONLINE_TRAINING` type - Use correct `VIDEO` type for video submissions * **MVP Roles**: Fixed role validation per activity type - Videos: `Host`, `Presenter`, `Speaker` only - Blogs: `Author`, `Co-Author`, `Contributor` - Books: `Author`, `Co-Author` - Speaking: `Speaker`, `Panelist`, `Moderator`, `Presenter` * **Additional Technology Areas**: Force empty array for `additionalTechnologyAreas` - API currently rejects non-empty values - Will be investigated in future releases ### Documentation * **API Reference**: Complete documentation for both MVP and GDE APIs * **MVP API Reference**: Detailed field specifications and examples * **CHANGELOG_MVP_FIXES**: Comprehensive changelog of MVP integration fixes * **ERROR_HANDLING_IMPROVEMENTS**: Documentation of error handling patterns * **MCP_RESOURCES**: Guide for using MCP resources ### Contributors * Alan Buscaglia (Gentleman Programming) - MVP integration, error handling, and MCP resources ### Testing * Successful video submission (contributionId: 351180) * Token capture via HAR file export validated * Error handling tested across all status codes ### [0.1.3](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.1.2...v0.1.3) (2025-06-07) ### Bug Fixes * add shebang to index.ts for executable script ([bae5eb5](https://github.com/carlosazaustre/advocu-mcp-server/commit/bae5eb597578be6b7968646164ba8a23e1068cb4)) * normalize formatting of files array in package.json ([047a570](https://github.com/carlosazaustre/advocu-mcp-server/commit/047a57075ea58a85c818bb9f34c6d0884d164f99)) ### [0.1.2](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.1.0...v0.1.2) (2025-06-07) ### [0.1.1](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.1.0...v0.1.1) (2025-06-07) ## [0.1.0](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.0.4...v0.1.0) (2025-06-07) ### ⚠ BREAKING CHANGES * Entry point changed from dist/cli.js to dist/main.js ### Features * add NPM CLI support and publication configuration ([8c88c1c](https://github.com/carlosazaustre/advocu-mcp-server/commit/8c88c1c296c26895567793dc7cdc11d989efe74e)) ### Bug Fixes * add platform-specific Biome packages to resolve CI issues ([d26ba2e](https://github.com/carlosazaustre/advocu-mcp-server/commit/d26ba2e7c5522fc0049b0d9fe766f3be4bc51c90)) * update test command in CI workflow and add .npmignore for docs ([3853259](https://github.com/carlosazaustre/advocu-mcp-server/commit/3853259d1f78ca0fa66f092db6448c9144554100)) ### Code Refactoring * implement unified entry point for MCP and CLI modes ([4030788](https://github.com/carlosazaustre/advocu-mcp-server/commit/40307885b910f491439f56ab3ff81bcd579803a0)) * remove CLI and main entry point files, unify execution in index.js ([2fd03f2](https://github.com/carlosazaustre/advocu-mcp-server/commit/2fd03f25ae5b077468648de7ad303076fa612559)) * update README for improved installation instructions and configuration options ([8746d4d](https://github.com/carlosazaustre/advocu-mcp-server/commit/8746d4d5e08aee0d7bee929b021ee441323ce300)) ### [0.0.4](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.0.3...v0.0.4) (2025-06-07) ### Bug Fixes * format keywords array in package.json ([3fccfe6](https://github.com/carlosazaustre/advocu-mcp-server/commit/3fccfe6c18940d251fc3e2a0654a64a31f3b9594)) ### Documentation * add environment variable configuration for Advocu access token in README ([8d908d1](https://github.com/carlosazaustre/advocu-mcp-server/commit/8d908d1b469f00ba3a402c479f04967e1ec2e70f)) ### [0.0.3](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.0.2...v0.0.3) (2025-06-07) ### Features * add README and setup script for initial project setup and configuration ([1782d20](https://github.com/carlosazaustre/advocu-mcp-server/commit/1782d20f39e2a58dd40325d7557ce6c0a0f430c7)) ### [0.0.2](https://github.com/carlosazaustre/advocu-mcp-server/compare/v0.0.1...v0.0.2) (2025-06-07) ### Features * add dotenv for environment variable management and restructure server entry point ([ece0f51](https://github.com/carlosazaustre/advocu-mcp-server/commit/ece0f51275ffd6fde8fadadce62461c80755fa69)) * Add enums for content types, countries, event formats, interaction formats, and significance types ([5a9c3d2](https://github.com/carlosazaustre/advocu-mcp-server/commit/5a9c3d2fe34547de216940d807c648a3adc31672)) ### Documentation * add API documentation for activity drafts ([918d69e](https://github.com/carlosazaustre/advocu-mcp-server/commit/918d69e1abd050e6d7e643092ce03360132d637f)) ### 0.0.1 (2025-06-07) ### Features * add TypeScript configuration and initial server setup ([4a1e869](https://github.com/carlosazaustre/advocu-mcp-server/commit/4a1e86993fad2ae57c8f34ae494bd0e2841e9bcd))