Event-Driven Ansible (EDA) Operations
MCP Server
- Repository: sibilleb/AAP-Enterprise-MCP-Server
- Transport: stdio (Python via
uv run eda.py) - Install:
git clone+uv sync(orpip install -e .) - Requires:
EDA_URL,EDA_TOKEN
Available Tools (12)
Activation Management (7)
| Tool | What It Does |
|---|---|
list_activations |
List all activations in EDA |
get_activation |
Retrieve details for a specific activation by ID |
create_activation |
Create a new activation |
enable_activation |
Enable a disabled activation |
disable_activation |
Disable an active activation |
restart_activation |
Restart an activation |
delete_activation |
Delete an activation |
Rulebooks & Environments (3)
| Tool | What It Does |
|---|---|
list_rulebooks |
List all rulebooks in EDA |
get_rulebook |
Retrieve details of a specific rulebook |
list_decision_environments |
List all decision environments |
Event Streams & Environments (2)
| Tool | What It Does |
|---|---|
create_decision_environment |
Add a new decision environment |
list_event_streams |
List all event streams |
Key Concepts
| Concept | What It Means |
|---|---|
| EDA | Event-Driven Ansible — reactive automation triggered by events |
| Activation | A running instance of a rulebook processing events |
| Rulebook | YAML-defined rules mapping events to Ansible actions |
| Decision Environment | Container image with collections and dependencies for EDA |
| Event Stream | Source of events fed into EDA for processing |
Workflow: Activation Management
- List activations:
list_activations— see all current activations and their state - Inspect:
get_activation— review activation details (rulebook, decision env, status) - Lifecycle:
enable_activation,disable_activation,restart_activationas needed - Report: Activation health summary
Workflow: Event-Driven Automation Audit
- List activations:
list_activations— enumerate all EDA activations - List rulebooks:
list_rulebooks— review available automation rules - Check environments:
list_decision_environments— verify container images - Monitor streams:
list_event_streams— confirm event sources are active - Report: EDA health, dormant activations, orphaned rulebooks
Integration with Other Skills
| Skill | How They Work Together |
|---|---|
aap-automation |
EDA triggers → AAP job template execution |
aap-lint |
Validate rulebook playbook actions before activation |
servicenow-change-workflow |
ServiceNow CR before enabling EDA activations in production |
gait-session-tracking |
Audit trail for EDA lifecycle changes |
slack-network-alerts |
EDA event notifications via Slack |
Environment Variables
EDA_URL— EDA API endpoint (e.g.,https://aap.example.com/api/eda/v1)EDA_TOKEN— EDA API token (can match AAP_TOKEN)
Important Rules
- Activations process events in real-time — disabling/enabling affects live automation
- ServiceNow CR — gate activation changes behind change requests in production
- Record in GAIT — log all EDA operations for audit trail