# Support

Thank you for using Home Assistant MCP! This document provides guidance on how to get help.

## 📚 Documentation

Before seeking support, please check our comprehensive documentation:

- **[README](README.md)** - Overview and quick start
- **[Installation Guide](docs/INSTALLATION.md)** - Detailed installation instructions
- **[Getting Started](docs/GETTING_STARTED.md)** - First steps with the MCP server
- **[Tools Reference](docs/TOOLS_REFERENCE.md)** - Complete list of available tools
- **[Configuration Guide](docs/CONFIGURATION.md)** - Configuration options
- **[FAQ](docs/FAQ.md)** - Frequently asked questions
- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions

## 🐛 Issues and Bugs

If you've found a bug or issue:

1. **Search existing issues**: Check if someone has already reported it
   - [Open Issues](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues)
   - [Closed Issues](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues?q=is%3Aissue+is%3Aclosed)

2. **Create a new issue**: If not found, [open a new issue](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues/new) with:
   - Clear, descriptive title
   - Detailed description of the problem
   - Steps to reproduce
   - Expected vs actual behavior
   - Environment details (OS, Bun version, Home Assistant version)
   - Relevant logs or error messages (sanitize sensitive data)
   - Screenshots if applicable

## 💬 Community Support

### GitHub Discussions

For questions, ideas, and general discussion:

- **[Discussions](https://github.com/jango-blockchained/advanced-homeassistant-mcp/discussions)** - Ask questions, share ideas
  - 💡 **Ideas** - Feature requests and suggestions
  - 🙋 **Q&A** - Questions and answers
  - 📢 **Announcements** - Updates and news
  - 🗣️ **General** - General discussion

### Community Guidelines

When seeking help:

- **Be respectful** and patient
- **Provide context** and details
- **Search first** before asking
- **Follow up** and share solutions
- **Help others** when you can

## 🚀 Feature Requests

Have an idea for a new feature?

1. **Check existing requests**: See if it's already been suggested
2. **Open a discussion**: Share your idea in [Discussions → Ideas](https://github.com/jango-blockchained/advanced-homeassistant-mcp/discussions/categories/ideas)
3. **Describe the use case**: Explain why it would be valuable
4. **Propose a solution**: Share your thoughts on implementation

## 📖 Examples and Tutorials

Looking for examples?

- **[Examples](docs/EXAMPLES.md)** - Usage examples
- **[Quick Start Scenarios](docs/QUICK_START_SCENARIOS.md)** - Common use cases
- **[Development Guide](docs/DEVELOPMENT.md)** - For contributors

## 🔒 Security Issues

For security vulnerabilities:

- **DO NOT** open a public issue
- Follow our **[Security Policy](SECURITY.md)**
- Report privately via GitHub Security Advisories

## 🤝 Contributing

Want to contribute?

- Read our **[Contributing Guide](CONTRIBUTING.md)**
- Check the **[Development Guide](docs/DEVELOPMENT.md)**
- Review the **[Code of Conduct](CODE_OF_CONDUCT.md)**

## 📧 Contact

### For General Questions

- [GitHub Discussions](https://github.com/jango-blockchained/advanced-homeassistant-mcp/discussions)
- [GitHub Issues](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues)

### For Security Issues

- GitHub Security Advisories (preferred)
- Direct contact with maintainers (via GitHub)

### For Project Inquiries

- Contact: [@jango-blockchained](https://github.com/jango-blockchained)

## ⏱️ Response Times

Please note that this is an open-source project maintained by volunteers:

- **Issues**: We aim to respond within 3-5 business days
- **Discussions**: Typically within 1-2 days
- **Security issues**: Within 48 hours (see [Security Policy](SECURITY.md))
- **Pull requests**: Within 1 week for initial review

Response times may vary based on complexity and maintainer availability.

## 🌟 Getting Better Support

To get faster, more helpful responses:

1. **Be specific**: Provide detailed information
2. **Be prepared**: Include logs, configurations, steps to reproduce
3. **Be patient**: Maintainers are volunteers
4. **Be helpful**: Share solutions you discover
5. **Be respectful**: Follow the Code of Conduct

## 📊 Project Status

- **Active**: Actively maintained and accepting contributions
- **Version**: Check [releases](https://github.com/jango-blockchained/advanced-homeassistant-mcp/releases) for latest version
- **Roadmap**: See [issues](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues) and [discussions](https://github.com/jango-blockchained/advanced-homeassistant-mcp/discussions)

## 🙏 Thank You

Thank you for using Home Assistant MCP! Your feedback, bug reports, and contributions help make this project better for everyone.

---

**Need Help Right Now?**

1. Check the [FAQ](docs/FAQ.md)
2. Review [Troubleshooting Guide](docs/TROUBLESHOOTING.md)
3. Search [Issues](https://github.com/jango-blockchained/advanced-homeassistant-mcp/issues)
4. Ask in [Discussions](https://github.com/jango-blockchained/advanced-homeassistant-mcp/discussions)

**Happy automating!** 🏠🤖
