Skip to content

v0.1.0 - Initial Production Release 🎉

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Aug 01:46
v0.1.0
d0e7e1c

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

Assets 3
Loading