Metadata-Version: 2.4
Name: qualys-healthcheck
Version: 0.2.0
Summary: MCP server for automated Qualys VMDR healthcheck assessments - 44-question evaluation with scoring and reporting
Project-URL: Homepage, https://github.com/nelssec/qualys-healthcheck
Project-URL: Repository, https://github.com/nelssec/qualys-healthcheck
Project-URL: Issues, https://github.com/nelssec/qualys-healthcheck/issues
Author-email: Andrew Nelson <andrew@nelssec.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,healthcheck,mcp,qualys,security,vmdr
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: python-pptx>=1.0.0
Provides-Extra: agent
Requires-Dist: anthropic>=0.40.0; extra == 'agent'
Description-Content-Type: text/markdown

# Qualys VMDR Healthcheck

Automated 44-question VMDR healthcheck assessment via MCP server and standalone agent.

## Quick Start

```bash
# Install
pip install -e .

# Set environment variables
export QUALYS_USERNAME=your_username
export QUALYS_PASSWORD=your_password
export QUALYS_BASE_URL=https://qualysapi.qualys.com
export QUALYS_GATEWAY_URL=https://gateway.qualys.com

# Run as MCP server
qualys-healthcheck

# Run standalone agent (requires anthropic package)
pip install -e ".[agent]"
export ANTHROPIC_API_KEY=sk-ant-...
python -m agent --customer "Customer Name"
```

## MCP Tools

- `get_option_profiles()` - Scan option profiles
- `get_auth_records()` - Authentication records
- `get_scan_schedules()` - Scan schedules and durations
- `get_cloud_agents_status()` - Agent deployment status
- `get_tags_and_groups()` - Tags and asset groups
- `get_asset_tracking_config()` - Tracking, merging, purge rules
- `get_dashboard_info()` - Dashboard configuration
- `evaluate_all(customer_name)` - Run full assessment
- `submit_manual_answer(question_id, compliant, notes)` - Record manual answers
- `generate_report(format, output_dir)` - Generate PPTX/HTML reports
