moadim-server

Rust server that exposes the same functionality over two protocols simultaneously:

• REST (http://localhost:5784/) — standard HTTP API for browsers, CLI tools, and services
• MCP (http://localhost:5784/mcp) — Model Context Protocol for AI agents (Claude, etc.)

Both run on the same port.

Features

• Same cron-job, health, and echo logic reachable via REST and MCP
• Cron-job declarations live in ~/.config/moadim/jobs/ — git-trackable, diff-friendly
• Handlers are executable scripts in ~/.config/moadim/handlers/ — any language, also git-trackable
• API interfaces auto-generated at build time into apis/
• Static browser client served from static/index.html

Directory layout

~/.config/moadim/
├── jobs/
│   ├── daily-report/
│   │   ├── job.toml        # tracked — commit this
│   │   ├── job.local.toml  # untracked — local overrides (secrets, machine-specific config)
│   │   └── job.log         # untracked — runtime log
│   ├── cleanup-temp/
│   │   ├── job.toml
│   │   └── job.log
│   └── sync-calendar/
│       ├── job.toml
│       └── job.local.toml
└── handlers/
    ├── send-report.sh
    ├── cleanup-temp.py
    └── sync-calendar.sh

Handlers

Handlers are executable scripts under ~/.config/moadim/handlers/. The server resolves the handler field in job.toml to a file in that directory and execs it on each run.

handlers/send-report.sh      ← handler = "send-report"
handlers/cleanup-temp.py     ← handler = "cleanup-temp"

Any executable works — shell, Python, Node, compiled binary. The server passes job metadata as environment variables prefixed with MOADIM_.

#!/usr/bin/env bash
# ~/.config/moadim/handlers/send-report.sh

curl -s -X POST "https://api.example.com/report" \
  -H "Authorization: Bearer $MOADIM_API_KEY" \
  -d "recipient=$MOADIM_RECIPIENT"

Multiple jobs can share one handler, differing only in schedule or metadata:

jobs/daily-report/job.toml   → handler = "send-report"
jobs/weekly-digest/job.toml  → handler = "send-report"

Handlers are git-trackable alongside jobs:

cd ~/.config/moadim
git add jobs/ handlers/
git commit -m "initial jobs and handlers"

Job declarations

Each job is a folder under ~/.config/moadim/jobs/. The folder name is the job ID.

Each job folder contains an auto-generated .gitignore that excludes *.local.* and *.log files — no manual ignore setup needed.

job.toml

Tracked configuration — schedule, handler, and shared metadata.

# ~/.config/moadim/jobs/daily-report/job.toml

schedule = "0 30 9 * * 1-5 *"   # cron expression (seconds field required)
handler  = "send-report"         # filename in ~/.config/moadim/handlers/ (no extension)
enabled  = true                  # omit to default to true

[metadata]
recipient = "team@example.com"
timezone  = "Asia/Jerusalem"

job.local.toml

Untracked overrides — machine-specific values, secrets, or anything that should not be committed. Loaded after job.toml; local values win on conflict.

# ~/.config/moadim/jobs/daily-report/job.local.toml

enabled = false           # overrides job.toml enabled = true → job is disabled

[metadata]
api_key = "sk-..."        # secret — never commit
recipient = "me@local"    # overrides job.toml recipient

Any field valid in job.toml can be overridden. If both files set enabled, the local file wins.

job.log

Append-only log written by the server on each run. Never committed.

2026-06-11T09:30:00Z [daily-report] run started
2026-06-11T09:30:01Z [daily-report] run finished OK (1.2s)

Running

Native server

cargo run

Starts on http://127.0.0.1:5784. REST and MCP share the same port.
The server reads ~/.config/moadim/jobs/ on startup and watches for changes.

MCP usage

The server exposes an MCP endpoint at http://localhost:5784/mcp. Connect any MCP-compatible client.

Claude Code

claude mcp add --transport http moadim http://localhost:5784/mcp

Any MCP client

transport: streamable-http
url:       http://localhost:5784/mcp

API

Full interface definitions are auto-generated at build time — see the apis/ folder.