Vigil Today MCP Integration Reference

What this is

Vigil Today exposes a Model Context Protocol (MCP) endpoint at https://mcp.vigil.today/mcp. Supported AI clients (Claude, ChatGPT) authenticate via OAuth 2.1 + PKCE + RFC 7591 Dynamic Client Registration, then call tools via the MCP Streamable HTTP transport.

Each call is gated server-side by the OAuth scopes you granted: a tool whose required scopes weren't authorized fails with insufficient_scope before the handler runs. Whether the AI client also surfaces a per-call confirmation prompt for write tools is up to that client — Claude and ChatGPT typically do, but you should always check the client's prompt before approving a destructive action.

OAuth scopes

When you connect an AI client, you'll be asked to grant some subset of these scopes on the consent screen. Grant only the ones you understand and intend.

• reminders:read — Read your reminder list, schedules, and due dates.
• inventory:read — Read your inventory items, quantities, and alert states.
• completions:read — Read your completion history and per-reminder stats.
• reminders:write — Create, update, archive, and mark reminders complete.
• inventory:write — Adjust inventory quantities (purchases, uses, and the auto-decrement side of mark-complete on linked reminders).

Read tools (7)

These tools surface what's already in your account. They never modify anything.

vigil_list_reminders (reminders:read)

Lists your reminders. Filter by all / active / overdue / due today.

vigil_get_today_summary (reminders:read, inventory:read)

Reminders due today, low-stock inventory, and upcoming replacements in one combined view.

vigil_get_completion_stats (completions:read)

Per-reminder completion counts, expected counts, completion rate (when computable — null when the reminder had no expected occurrences in the window), and longest gap over the last 7 / 14 / 30 / 90 days.

vigil_list_inventory (inventory:read)

Lists your inventory items with quantity on hand, reorder thresholds, and projected days of supply.

vigil_get_inventory_item (inventory:read)

Detail view of a single inventory item, including recent purchase / use events.

vigil_get_low_stock_items (inventory:read)

Just the items currently flagged low (below reorder threshold or under projected days of supply).

vigil_get_item_history (reminders:read, inventory:read, completions:read)

"When did I last X?" — recent activity timestamps and event log for a reminder, an inventory item, or a name search across both.

Write tools (6)

These tools modify state in your Vigil Today account. Claude and ChatGPT show you a confirmation prompt before each individual call.

The connector can update, complete, and archive existing items, and adjust quantities on inventory items you already track. It cannot create new inventory items — those are added from the Vigil Today web app. Items marked as sensitive in the web app are blocked from MCP writes by default; you can opt in per-connection in Settings → Connections.

vigil_mark_complete (reminders:write)

Marks a reminder complete. If the reminder is linked to an inventory item and inventory:write is granted, also decrements the linked item by 1 in the same transaction.

vigil_create_reminder (reminders:write)

Creates a new reminder with one of six schedule types: interval (every X hours), fixed_times, daily, weekly, monthly, or every_n_units (every N days/weeks/months).

vigil_update_reminder (reminders:write)

Updates an existing reminder — name, icon, enabled state, linked inventory item, or schedule fields. Supports combined updates in one call.

vigil_archive_reminder (reminders:write)

Archives a reminder. Sets it inactive and stamps an archivedAt timestamp; the data is preserved (no record is permanently deleted) and remains queryable via vigil_get_item_history.

vigil_use_one (inventory:write)

Decrements one inventory item by one unit and records a "use" event. Returns an explicit error if the item is already at 0.

vigil_record_purchase (inventory:write)

Adds purchased units to an inventory item (1–9999) and records a "purchase" event. Re-arms the low-stock alert if quantity goes back above the reorder threshold.

Data handling

Tool calls run against your own Firestore data, scoped to your account. Vigil Today does not share that data outside the authorized connector flow. Tool responses you ask the assistant to fetch are returned to the AI client (Claude or ChatGPT) and then handled under that provider's own terms and privacy policy — review those before authorizing a connection.

Audit logs. Per-call audit rows are written to users/{uid}/mcpAuditLogs so you can review activity in Settings → Connections. Each row contains the tool name, requested OAuth scopes, success/error code, and request latency. Audit rows do not contain tool argument values or response payloads.

Audit rows are retained for 90 days in Firestore. After 90 days, a scheduled job emits each rotated row to Google Cloud Logging and deletes it from Firestore. Long-term retention beyond Cloud Logging's default window depends on log bucket retention configuration.

Tokens. Bearer tokens have a 1-hour TTL; refresh tokens have a 90-day TTL. Tokens are stored hashed at rest (we keep sha256(token) as the document key, never the raw value) and are never exposed to the AI client beyond the bearer needed for the current session.

Account deletion. Deleting your Vigil Today account revokes all active AI Connector tokens immediately and removes your reminder, inventory, completion, and audit data from Firestore within 30 days.

Disconnecting. Settings → Connections lists every active AI connection. Revoking a connection invalidates its tokens immediately; subsequent tool calls fail with an auth error and the AI client prompts you to reconnect. Revoking does not delete your Vigil Today account or any of your data — you can continue using the web app for free.

Other docs

• AI Connector overview — what the integration is for, example prompts, pricing.
• Privacy policy — what we collect and how we use it.
• Terms of service
• Safety — what Vigil Today is and is not for.