Loki MCP

Read-only MCP server over Loki / Thor — 1mg's logistics & operations platform. It talks to the same gateway the Thor admin UI uses (https://thor.1mg.com/1mg_api), so no VPN or host setup is needed beyond a valid login token.

Tools

Tool	Surface	What it does
loki_reference_data	enums	Valid values for status/type/category/fulfilled_by/rider filters
loki_search_hubs	hubs	Find a hub id (ObjectId) from a name/code — needed by order/task search
loki_get_hub	hubs	Full hub detail by id
loki_search_orders	orders	Search orders within hub(s) — hub_id required
loki_get_order	orders	Full order detail by order id
loki_get_order_timelines	orders	Chronological status history of an order
loki_search_tasks	tasks	Search delivery/pickup tasks within hub(s) — hub_id required
loki_get_task	tasks	Full task detail by id
loki_search_riders	riders	Search riders / phlebos
loki_get_rider	riders	Full rider detail by numeric id
loki_get_hub_riders	riders	Riders attached to a hub (optionally by type)
loki_get_phlebo_day_metrics	day tracking	Daily KPI summary for a rider (assigned/completed/distance/breach)
loki_get_phlebo_day_tasks	day tracking	Chronological day timeline (shift, login, task sequence)
loki_get_phlebo_planned_route	day tracking	Planned route waypoints + locations
loki_get_phlebo_actual_route	day tracking	Actual GPS pings (speed, battery, coolbox temp)
loki_search_phlebo_daily_metrics	day tracking	"Track Phlebos" board for a hub+date (live status/availability)
loki_get_hub_attendance_metrics	attendance	total_present / total_absent for hub(s) on a date
loki_get_rider_monthly_attendance	attendance	Day-by-day attendance + hours for a rider/month

All tools are read-only (readOnlyHint: true).

Day-tracking note: phlebo_id/rider_id is the numeric rider id; date is YYYY-MM-DD.

Auth

Thor authenticates with the authTokenThor JWT cookie. It is short-lived, so the server reads it fresh on every call — refreshing never needs a restart.

1. Open https://thor.1mg.com while logged in.

2. DevTools → Application → Cookies → copy the authTokenThor value.

3. Paste it into the token file:

   echo 'PASTE_TOKEN_HERE' > ~/.loki_token
   

When calls start returning 401/403, just overwrite ~/.loki_token with a fresh value.

Env var	Default	Purpose
LOKI_TOKEN_FILE	~/.loki_token	Path to token file
LOKI_TOKEN	—	Token fallback if no file
LOKI_BASE_URL	https://thor.1mg.com/1mg_api	Gateway base

Setup

cd loki-mcp
uv sync
echo 'PASTE_TOKEN_HERE' > ~/.loki_token
uv run python server.py   # smoke test (Ctrl-C to stop)

Register in Claude Code

claude mcp add loki -- /Users/abhishekjain/1mg-claude-code/toy-ptojects/loki-mcp/.venv/bin/python \
  /Users/abhishekjain/1mg-claude-code/toy-ptojects/loki-mcp/server.py

Notes

• hub_id is mandatory for order/task search. Resolve names → ids with loki_search_hubs.
• Time filters use DD-MM-YYYY HH:mm:ss.
• This is v1 and intentionally read-only; no write/action tools are exposed.