INTUIMCP
README.md
# INTUIMCP
MCP server for Intui.travel fleet carriers — reads orders, tracks confirmations, cancellations & modifications, and syncs live to Google Sheets.
INTUIMCP is a Model Context Protocol server built for transfer companies operating on the Intui.travel fleet platform. It automates order monitoring by reading order lists and full order detail pages from the supplier portal, detecting field-level changes between syncs, and mirroring everything into a live Google Sheet — one row per order, plus an append-only change log.
What it tracks
Every sync compares each order against the previous snapshot and classifies the change as NEW, CONFIRMED, CANCELLED, DECLINED, COMPLETED, or MODIFIED. Modifications are field-level — you see exactly what changed, for example pickup_datetime: 09:30 → 11:45 or price_gross: 8.32 → 10.50.
Key features
Reads order lists from /en/orders/ and full detail from /en/orders_info/?order_id=…
Label-map parser that survives portal redesigns and maps to canonical order fields
SQLite-backed snapshot store for reliable offline diffing between syncs
Live Google Sheet sync — upsert on Orders tab, append-only Change_Log tab
Two auth backends: portal session cookie (works today) and official Fleet API (ready to wire in when credentials are issued)
Standalone watch.py poller for cron/Task Scheduler continuous sync
6 MCP tools: intui_health_check, intui_list_orders, intui_get_order, intui_sync_orders, intui_get_change_log, intui_probe_portal
Built with: Python · FastMCP / MCP SDK 2.x · httpx · BeautifulSoup4 · gspread · SQLite
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues