v0.5.1

0.5.1 (2026-06-15)

Bug Fixes

• release: authenticate GitHub Packages publish via NPM_TOKEN (4d8af65)

v0.4.1

0.4.1 (2026-06-14)

Bug Fixes

• release: sync package-lock version + correct Node version in setup guide (edf0917)

v0.4.0

0.4.0 (2026-06-14)

Features

• revert toolchain to Node + Vitest, restore Node runtime support (fe2d5b8)

v0.3.0

0.3.0 (2026-06-14)

• feat!: migrate toolchain to bun-only (Phase 1) (0a56da3)

BREAKING CHANGES

• the package is now bun-only. Consumers must install bun and
  launch the server with bun/bunx instead of node/npx; engines.node is removed.

Co-Authored-By: Claude noreply@anthropic.com

v0.2.2

0.2.2 (2026-06-14)

Bug Fixes

• server: silence dotenv startup log to protect stdio MCP stream (15acad4)

v0.2.1

0.2.1 (2026-06-14)

Bug Fixes

• docs: use Zensical's required site_name key (aae28ce)

v0.2.0

0.2.0 (2026-06-14)

Bug Fixes

• deps: pin msw to 2.10.4 to restore Jest ESM compatibility (db6b471)

Features

• tickets: add facet filters to ticket_search (b13dac6)

v0.1.0 - Initial Production Release 🎉

MCP IncidentIQ Server v0.1.0

First official release of the MCP IncidentIQ Server for K-12 school districts!

🚀 Highlights

• 140+ MCP Tools across 9 comprehensive domain modules
• Production Validated with numerous tickets and thousands of users
• Successfully Tested against a partner K-12 school district production instance
• Full API Integration for all major IncidentIQ features
• K-12 Optimized with FERPA/COPPA compliance considerations

📊 Production Testing Results

• ✅ Tickets retrieved and searchable at production scale
• ✅ Users (students, staff, parents) accessible at production scale
• ✅ IT agents with full details
• ✅ Support teams with complete member lists
• ✅ District locations including all school buildings
• ✅ Performance validated with large production datasets

🛠 Features

Domain Modules

• Tickets - Search, view, and manage IT support tickets
• Users - Student, staff, and parent management
• Assets - Device tracking (Chromebooks, iPads, etc.)
• Locations - School buildings and room management
• Teams - IT support team administration
• Custom Fields - District-specific data fields
• Purchase Orders - PO tracking and management
• Analytics - Reporting and dashboard tools
• Issues - Issue types and categories

Technical Features

• JWT Bearer token authentication
• Pagination support for large datasets
• Advanced filtering and search
• Rate limiting awareness
• Comprehensive error handling
• TypeScript with strict typing

📚 Documentation

• Comprehensive README with quick start guide
• Claude Desktop integration guide
• API permissions documentation
• Security policy with FERPA/COPPA compliance
• Contributing guidelines

🧪 Testing

• 104 unit tests (all passing)
• K-12 specific test scenarios
• Mock server with realistic data
• CI/CD pipeline with GitHub Actions

⚠️ Known Issues

• Some fields may return "undefined" (cosmetic issue)
• Parts and Issues modules not yet implemented
• Location advanced search parameter validation
• Test coverage at 22.57% (functional but needs improvement)

🔧 Installation

# Clone the repository
git clone https://github.com/IIQ-Community/mcp-incidentiq.git
cd mcp-incidentiq

# Install dependencies
yarn install

# Configure environment
cp .env.example .env
# Edit .env with your IncidentIQ API credentials

# Build the project
yarn build

# Start the server
yarn start

🤝 Contributing

We welcome contributions from the K-12 IT community! Please see our Contributing Guidelines for details.

📄 License

MIT License - See LICENSE file for details.

🙏 Acknowledgments

• IIQ Community Contributors
• A partner K-12 school district for UAT testing
• All K-12 IT professionals using IncidentIQ

---

Full Changelog: https://github.com/IIQ-Community/mcp-incidentiq/commits/v0.1.0