Quick Start¶

Get Moltler running on your existing Elasticsearch cluster in 3 steps.

Prerequisites¶

• Elasticsearch 9.x running
• Admin access to install plugins
• curl and git installed

Step 1: Install the Plugin¶

Download and install the plugin on each node in your cluster:

# Download the plugin (check releases for your ES version)
wget https://github.com/bahaaldine/moltler/releases/download/v1.0.0/x-pack-escript-9.4.0-SNAPSHOT.zip

# Install the plugin
sudo elasticsearch-plugin install file:///path/to/x-pack-escript-9.4.0-SNAPSHOT.zip

# Restart Elasticsearch
sudo systemctl restart elasticsearch

Verify the plugin is loaded:

curl -u elastic:password http://localhost:9200/_cat/plugins | grep escript

Step 2: Install Skills¶

One-liner installation:

curl -sSL https://hub.moltler.dev/install.sh | bash

With custom credentials:

curl -sSL https://hub.moltler.dev/install.sh | bash -s -- \
  --es-url https://your-cluster:9200 \
  --es-user elastic \
  --es-password your-password

Install only specific categories:

# Just observability skills
curl -sSL https://hub.moltler.dev/install.sh | bash -s -- --category observability

# Just security skills
curl -sSL https://hub.moltler.dev/install.sh | bash -s -- --category security

Step 3: Connect Your AI Agent¶

This is where the magic happens. Connect your favorite AI assistant and start querying your data with natural language.

For Cursor IDE, create .cursor/mcp.json:

{
  "mcpServers": {
    "moltler": {
      "url": "http://localhost:9200/_escript/mcp",
      "headers": {
        "Authorization": "Basic ZWxhc3RpYy1hZG1pbjplbGFzdGljLXBhc3N3b3Jk"
      }
    }
  }
}

Restart Cursor, then start asking:

"Find all errors in production from the last hour"

"Hunt for this suspicious IP: 192.168.1.100"

"Show me the slowest API transactions"

Full Agent Setup Guide →

The Experience¶

After connecting your agent, you can have conversations like:

You: "I got paged for a production incident. The payment service seems down."

Agent: Uses get_recent_errors skill

"I found 47 errors in payment-service. Most are 'Connection timeout to gateway'. Let me check transaction latency..."

Uses get_slow_transactions skill

"Payment gateway calls are averaging 12s (10x normal). Issue started at 9:45 AM. Want me to check if there's a related deployment?"

Your AI assistant can now investigate your Elasticsearch data like a senior engineer.

That's It!¶

You now have: - ✅ elastic-script plugin running in your cluster - ✅ 155+ skills installed - ✅ AI agent connected and ready - ✅ Query your data with natural language

What's Next?¶

The Journey¶

┌─────────────────────────────────────────────────────────────────┐
│                        YOUR JOURNEY                              │
│                                                                  │
│  1. INSTALL PLUGIN                                               │
│     └── elasticsearch-plugin install x-pack-escript.zip         │
│                     ↓                                            │
│  2. INSTALL SKILLS                                               │
│     └── curl https://hub.moltler.dev/install.sh | bash          │
│                     ↓                                            │
│  3. RUN SKILLS                                                   │
│     └── RUN SKILL get_recent_errors()                           │
│                     ↓                                            │
│  4. (Optional) BUILD YOUR OWN                                   │
│     └── CREATE SKILL my_skill ...                               │
└─────────────────────────────────────────────────────────────────┘

Alternative: Local Development Setup¶

If you want to develop skills or contribute, use the full development setup:

git clone --recurse-submodules https://github.com/bahaaldine/moltler.git
cd moltler
./scripts/quick-start.sh

This builds everything from source and runs a local ES cluster for development.

Full Installation Guide →