Dayze — Life Context

Official130 toolsLive

by gohluke · JavaScript

Life context for agents: get_context_pack + public notable packs. x402 + OAuth.

com.dayze/life-context — Model Context Protocol (MCP) Server

This public MCP server provides “Life Context” for AI agents, including a reference to the Life Context Protocol via a get_context_pack entry point. It also exposes public “notable-people” context packs. It runs on x402 on Base and uses OAuth for private tools.

🛠️ Key Features

Reference “Life Context Protocol” via get_context_pack
Public context packs for notable people
Public MCP server
x402 on Base
OAuth for private tools
14 tools available

🚀 Use Cases

Supplying people- and life-in-days knowledge to AI agents
Loading context packs for agent workflows
Using notable-people packs as reference data for generation or reasoning

⚡ Developer Benefits

Consistent context retrieval through get_context_pack
Pack-based access to “life context” and notable-people information
OAuth support when accessing private tools

⚠️ Limitations

Private tools require OAuth; public packs are available without that requirement

🧩 Topics

ai-agents, mcp, model-context-protocol, notable-people, x402, life-in-days

Topics

ai-agentsmcpmodel-context-protocolnotable-peoplechatgptpersonal-crmrelationship-intelligencelife-context

Captured live from the server via tools/list.

notable_search

Search the public Dayze notable-people catalog by name, occupation, or slug. Use when you need to find a person before fetching a pack. Example slug: albert-einstein. ($0.01)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "Max results 1–20",
          "default": 8
        },
        "q": {
          "type": "string",
          "description": "Primary search query."
        },
        "query": {
          "type": "string",
          "description": "Alias for q."
        }
      },
      "required": [
        "q"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "Max results 1–20",
          "default": 8
        },
        "q": {
          "type": "string",
          "description": "Primary search query."
        },
        "query": {
          "type": "string",
          "description": "Alias for q."
        }
      },
      "required": [
        "query"
      ],
      "additionalProperties": false
    }
  ]
}

notable_profile

Bio-only profile JSON by slug (no life-in-days, similar, or birthday peers). Prefer notable_pack for “who is X / age in days / peers”. Example: taylor-swift. ($0.02)

Parameters1

slug

string

required

Person slug, e.g. albert-einstein

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Person slug, e.g. albert-einstein"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

notable_pack

DEFAULT for who is X: profile + life_in_days (age/day_number) + similar people + birthday peers. Timeline events include day_number. Prefer this over notable_profile. Example: albert-einstein. ($0.05)

Parameters4

slug	string	required	Person slug, e.g. albert-einstein
similar	number	optional
peers	number	optional
date	string	optional	YYYY-MM-DD target date

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Person slug, e.g. albert-einstein"
    },
    "similar": {
      "type": "number",
      "default": 8
    },
    "peers": {
      "type": "number",
      "default": 12
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD target date"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

notable_pack_premium

S-tier guaranteed pack (score≥85, timeline≥8, image, embedding). Errors if below bar. Use when you need high-quality, complete notable context. Example slug: elon-musk. ($0.10)

Parameters4

slug	string	required	Person slug, e.g. elon-musk
similar	number	optional
peers	number	optional
date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Person slug, e.g. elon-musk"
    },
    "similar": {
      "type": "number",
      "default": 12
    },
    "peers": {
      "type": "number",
      "default": 20
    },
    "date": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

compare_lives

Side-by-side notable packs for two slugs (life_in_days + day_number timelines). One call instead of two notable_pack. Example: elon-musk vs steve-jobs. ($0.08)

Parameters5

slug_a	string	required	First person slug
slug_b	string	required	Second person slug
similar	number	optional
peers	number	optional
date	string	optional	YYYY-MM-DD target date for both packs

Raw schema

{
  "type": "object",
  "properties": {
    "slug_a": {
      "type": "string",
      "description": "First person slug"
    },
    "slug_b": {
      "type": "string",
      "description": "Second person slug"
    },
    "similar": {
      "type": "number",
      "default": 4
    },
    "peers": {
      "type": "number",
      "default": 6
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD target date for both packs"
    }
  },
  "required": [
    "slug_a",
    "slug_b"
  ],
  "additionalProperties": false
}

get_life_context

Get a snapshot of the authenticated user's current life context (identity, today/upcoming events, pulse, trackers). Relationships and memories are included by default; pass include_*=false to omit. Location is opt-in. Requires an authenticated Dayze account via OAuth; scoped API keys are also supported for direct clients. ($0.15; API key required)

Parameters3

include_location	boolean	optional	Include city/country label; never returns a precise address
include_relationships	boolean	optional	Include inner-circle and relationship summaries (default true; set false to omit)
include_memories	boolean	optional	Include recent memory summaries (default true; set false to omit)

Raw schema

{
  "type": "object",
  "properties": {
    "include_location": {
      "type": "boolean",
      "default": false,
      "description": "Include city/country label; never returns a precise address"
    },
    "include_relationships": {
      "type": "boolean",
      "default": true,
      "description": "Include inner-circle and relationship summaries (default true; set false to omit)"
    },
    "include_memories": {
      "type": "boolean",
      "default": true,
      "description": "Include recent memory summaries (default true; set false to omit)"
    }
  },
  "additionalProperties": false
}

get_context_pack

Life Context Protocol (LCP) pack for the authenticated user: identity, pulse, who_matters, whats_next, memories, quiz_results. Pass include_relationships/include_memories/include_quiz_results false to omit those sections; location and money stay opt-in. Spec: https://dayze.com/docs/life-context ($0.20; API key required)

Parameters9

query	string	optional	Optional focus query for semantic memories
include_location	boolean	optional	Include city/country label; never returns a precise address
include_relationships	boolean	optional	Include who_matters (inner-circle, relationship health, reach-out). Default true.
include_money	boolean	optional	Include the private cashflow summary
include_memories	boolean	optional	Include recent memories (default true). A query always enables focused memories.
include_quiz_results	boolean	optional	Include latest quiz results (slug, result_type, result_data). Default true.
include_places	boolean	optional	Include recent canonical places (venue-level, no GPS points)
include_trips	boolean	optional	Include recent/upcoming trips from completed travel history
focus	string	optional	Optional focus hint echoed in the pack (e.g. places, travel, people)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional focus query for semantic memories"
    },
    "include_location": {
      "type": "boolean",
      "default": false,
      "description": "Include city/country label; never returns a precise address"
    },
    "include_relationships": {
      "type": "boolean",
      "default": true,
      "description": "Include who_matters (inner-circle, relationship health, reach-out). Default true."
    },
    "include_money": {
      "type": "boolean",
      "default": false,
      "description": "Include the private cashflow summary"
    },
    "include_memories": {
      "type": "boolean",
      "default": true,
      "description": "Include recent memories (default true). A query always enables focused memories."
    },
    "include_quiz_results": {
      "type": "boolean",
      "default": true,
      "description": "Include latest quiz results (slug, result_type, result_data). Default true."
    },
    "include_places": {
      "type": "boolean",
      "default": false,
      "description": "Include recent canonical places (venue-level, no GPS points)"
    },
    "include_trips": {
      "type": "boolean",
      "default": false,
      "description": "Include recent/upcoming trips from completed travel history"
    },
    "focus": {
      "type": "string",
      "description": "Optional focus hint echoed in the pack (e.g. places, travel, people)"
    }
  },
  "additionalProperties": false
}

get_life_graph

Explicit private life-graph export: favorites/VIP plus people with edges or recent event tags. Pass full=true for a larger capped list. Optional event–people links. Requires OAuth or a supported scoped credential. ($0.25; API key required)

Parameters4

include_event_links	boolean	optional
event_links_limit	number	optional
max_people	number	optional
full	boolean	optional	Include additional people by last interaction, up to max_people

Raw schema

{
  "type": "object",
  "properties": {
    "include_event_links": {
      "type": "boolean",
      "default": false
    },
    "event_links_limit": {
      "type": "number",
      "default": 25
    },
    "max_people": {
      "type": "number",
      "default": 80
    },
    "full": {
      "type": "boolean",
      "default": false,
      "description": "Include additional people by last interaction, up to max_people"
    }
  },
  "additionalProperties": false
}

get_person_neighborhood

Subgraph around one user-owned person_id — profile (avatar_url, photo_count, has_photos) plus declared connections. Use get_person_photos for the full gallery. Notes omitted unless include_notes=true (redacted). Requires OAuth or a supported scoped credential. ($0.15; API key required)

Parameters2

person_id	string	required	UUID
include_notes	boolean	optional	When true, include center.notes (server-redacted). Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "UUID"
    },
    "include_notes": {
      "type": "boolean",
      "description": "When true, include center.notes (server-redacted). Default false."
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

get_events

Authenticated user's calendar events. Prefer explicit from/to (YYYY-MM-DD). Shortcuts: today|week|month|year (calendar year)|decade. Browsing noise excluded by default. ($0.10; API key required)

Parameters9

limit	number	optional
cursor	string	optional
include_archived	boolean	optional
from	string	optional	Inclusive YYYY-MM-DD (preferred over range)
to	string	optional	Inclusive YYYY-MM-DD
range	string	optional
include_browsing	boolean	optional	Include extension "Browsed domain · Xm" auto-events (default false)
include_calendar_blocks	boolean	optional	Include Focus Time / calendar_block rows (default false)
kinds	array	optional	Filter event_kind e.g. ["life_event","todo"]

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "type": "string"
    },
    "include_archived": {
      "type": "boolean"
    },
    "from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD (preferred over range)"
    },
    "to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD"
    },
    "range": {
      "type": "string",
      "enum": [
        "today",
        "week",
        "month",
        "year",
        "decade",
        "all"
      ]
    },
    "include_browsing": {
      "type": "boolean",
      "description": "Include extension \"Browsed domain · Xm\" auto-events (default false)"
    },
    "include_calendar_blocks": {
      "type": "boolean",
      "description": "Include Focus Time / calendar_block rows (default false)"
    },
    "kinds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter event_kind e.g. [\"life_event\",\"todo\"]"
    }
  },
  "additionalProperties": false
}

get_people

List the authenticated user's Dayze Contacts (private CRM; table people). Each contact includes avatar_url, photo_count, and has_photos; use get_person_photos(person_id) for the full gallery. Notes omitted by default (has_notes flag); pass include_notes=true for progressive fetch (credential/secret spans are redacted server-side). Supports limit (default 100, max 500) and offset; returns total and truncated. Distinct from public notable People at /people. Advertised name get_people is stable; tools/call also accepts get_contacts / list_contacts. Requires OAuth or a supported scoped credential. ($0.10; API key required)

Parameters4

cursor	string	optional
limit	number	optional	Page size (default 100, max 500)
offset	number	optional	Skip N rows (default 0)
include_notes	boolean	optional	When true, include notes (server-redacted). Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "Page size (default 100, max 500)"
    },
    "offset": {
      "type": "number",
      "description": "Skip N rows (default 0)"
    },
    "include_notes": {
      "type": "boolean",
      "description": "When true, include notes (server-redacted). Default false."
    }
  },
  "additionalProperties": false
}

update_person

MUTATES Dayze Contacts. Patch one existing contact the user owns (person_id UUID required). Optional fields: name (renames + refreshes slug), is_favorite, tier (vip|normal|low), relationship, notes (replaces stored notes — read first if you need to append), birthday (YYYY|YYYY-MM|YYYY-MM-DD|MM-DD|--MM-DD or null to clear; MM-DD stores month_day precision). Rejects unknown fields. Does not create or delete contacts. Rebuilds life_state so the next get_context_pack inner_circle is fresh. Advertised name update_person is stable; tools/call also accepts update_contact. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters10

person_id	string	required	UUID of a person the authenticated user owns
name	string	optional	Rename contact (also refreshes URL slug). Prefer this over create+merge for spelling fixes
preserve_old_name_as_alias	boolean	optional	When renaming, keep the previous name as a former_name alias (default true)
is_favorite	boolean	optional	Favorite flag. Favorites (and VIP) appear in get_context_pack inner_circle
tier	string	optional	Relationship priority. VIP stays in inner_circle even when not favorited
relationship	string	optional	Relationship label (friend, sister, …). Empty or null clears
notes	string	optional	Replaces people.notes (does not append). Empty or null clears
birthday	string	optional	YYYY, YYYY-MM, YYYY-MM-DD, or MM-DD / --MM-DD (year unknown). Null/empty clears
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "UUID of a person the authenticated user owns"
    },
    "name": {
      "type": "string",
      "description": "Rename contact (also refreshes URL slug). Prefer this over create+merge for spelling fixes"
    },
    "preserve_old_name_as_alias": {
      "type": "boolean",
      "description": "When renaming, keep the previous name as a former_name alias (default true)"
    },
    "is_favorite": {
      "type": "boolean",
      "description": "Favorite flag. Favorites (and VIP) appear in get_context_pack inner_circle"
    },
    "tier": {
      "type": "string",
      "enum": [
        "vip",
        "normal",
        "low"
      ],
      "description": "Relationship priority. VIP stays in inner_circle even when not favorited"
    },
    "relationship": {
      "type": "string",
      "description": "Relationship label (friend, sister, …). Empty or null clears"
    },
    "notes": {
      "type": "string",
      "description": "Replaces people.notes (does not append). Empty or null clears"
    },
    "birthday": {
      "type": "string",
      "description": "YYYY, YYYY-MM, YYYY-MM-DD, or MM-DD / --MM-DD (year unknown). Null/empty clears"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

update_notable

MUTATES public notable_people. Superuser only. Patch by slug (bio, about, occupation, birth_place, birth_date, net_worth, residence, before_fame, trivia, family_life, zodiac, flag). Rejects unknown fields. No create/delete. Stamps last_updated_via=mcp. ($0.10; API key required)

Parameters15

slug	string	required	Notable person slug (e.g. taylor-swift)
bio	string	optional
about	string	optional
occupation	string	optional
birth_place	string	optional
birth_date	string	optional	YYYY, YYYY-MM, or YYYY-MM-DD. Null/empty clears
net_worth	string	optional
residence	string	optional
before_fame	string	optional
trivia	string	optional
family_life	string	optional
zodiac	string	optional
flag	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Notable person slug (e.g. taylor-swift)"
    },
    "bio": {
      "type": "string"
    },
    "about": {
      "type": "string"
    },
    "occupation": {
      "type": "string"
    },
    "birth_place": {
      "type": "string"
    },
    "birth_date": {
      "type": "string",
      "description": "YYYY, YYYY-MM, or YYYY-MM-DD. Null/empty clears"
    },
    "net_worth": {
      "type": "string"
    },
    "residence": {
      "type": "string"
    },
    "before_fame": {
      "type": "string"
    },
    "trivia": {
      "type": "string"
    },
    "family_life": {
      "type": "string"
    },
    "zodiac": {
      "type": "string"
    },
    "flag": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

log_food

MUTATES the authenticated user Food Diary and calendar. Use when they ate or drank — do not store this as a chat memory. Example: “I had Mee Pok for late lunch with my parents” → log_food({ what: "Mee Pok", kind: "meal", meal_period: "late lunch", with: ["my parents"] }). Optional: place/merchant, amount, consumed_at (ISO). Resolves with/Mum/Dad via person aliases; unknown names do not fail the food write. Tags companions on the mirrored event. Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters15

what	string	required	What they ate or drank (required). Example: Mee Pok
kind	string	optional
meal_period	string	optional	Spoken period when consumed_at is omitted, e.g. "late lunch"
consumed_at	string	optional	ISO 8601 datetime; wins over meal_period
place	string	optional	Venue or location
merchant	string	optional	Restaurant, stall, or shop
amount	number	optional	Price if mentioned
currency	string	optional	ISO currency, e.g. SGD
with	array	optional	Companion names, aliases, ids, or group tokens. "my parents" / Mum / Dad resolve via aliases; "family" expands to CRM rows with family relationship labels
people_names	array	optional	Alias for with
person_ids	array	optional	Owned person UUIDs to tag (user-scoped)
notes	string	optional
paid_by	string	optional	Who paid (name or alias)
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "What they ate or drank (required). Example: Mee Pok"
    },
    "kind": {
      "type": "string",
      "enum": [
        "meal",
        "snack",
        "drink"
      ]
    },
    "meal_period": {
      "type": "string",
      "description": "Spoken period when consumed_at is omitted, e.g. \"late lunch\""
    },
    "consumed_at": {
      "type": "string",
      "description": "ISO 8601 datetime; wins over meal_period"
    },
    "place": {
      "type": "string",
      "description": "Venue or location"
    },
    "merchant": {
      "type": "string",
      "description": "Restaurant, stall, or shop"
    },
    "amount": {
      "type": "number",
      "description": "Price if mentioned"
    },
    "currency": {
      "type": "string",
      "description": "ISO currency, e.g. SGD"
    },
    "with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Companion names, aliases, ids, or group tokens. \"my parents\" / Mum / Dad resolve via aliases; \"family\" expands to CRM rows with family relationship labels"
    },
    "people_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Alias for with"
    },
    "person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Owned person UUIDs to tag (user-scoped)"
    },
    "notes": {
      "type": "string"
    },
    "paid_by": {
      "type": "string",
      "description": "Who paid (name or alias)"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "what"
  ],
  "additionalProperties": false
}

update_food

MUTATES one existing Food Diary row the authenticated user owns. Required: food_id (UUID). Optional patch (same fields as log_food): what, kind, place, merchant, notes, append_notes (concat), consumed_at / meal_period (profile TZ civil wall-clock), amount, currency, paid_by / payment_method, with / people_names / person_ids. Example: add hot tea onto an existing Salmon Bento → update_food({ food_id, what: "Salmon Bento + hot tea" }). Unknown or other-user food_id returns an error and does not create a row. Syncs the mirrored calendar event and rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters18

food_id	string	required	UUID of a food diary row the authenticated user owns
what	string	optional	Full updated dish/drink text (replaces, does not append). Example: Salmon Bento + hot tea
kind	string	optional
meal_period	string	optional	Spoken period when consumed_at is omitted, e.g. "late lunch"
consumed_at	string	optional	ISO 8601 datetime; wins over meal_period
place	string	optional	Venue or location. Empty or null clears
merchant	string	optional	Restaurant, stall, or shop. Empty or null clears
amount	number	optional	Price if mentioned
currency	string	optional	ISO currency, e.g. SGD
with	array	optional	Companion names, aliases, or ids to add (does not remove existing tags)
people_names	array	optional	Alias for with
person_ids	array	optional	Owned person UUIDs to tag (user-scoped)
notes	string	optional	Replaces notes. Empty or null clears
append_notes	string	optional	Append text to existing notes (newline-separated)
paid_by	string	optional	Who paid (name or alias)
payment_method	string	optional	Alias of paid_by for expense-style agents
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "food_id": {
      "type": "string",
      "description": "UUID of a food diary row the authenticated user owns"
    },
    "what": {
      "type": "string",
      "description": "Full updated dish/drink text (replaces, does not append). Example: Salmon Bento + hot tea"
    },
    "kind": {
      "type": "string",
      "enum": [
        "meal",
        "snack",
        "drink"
      ]
    },
    "meal_period": {
      "type": "string",
      "description": "Spoken period when consumed_at is omitted, e.g. \"late lunch\""
    },
    "consumed_at": {
      "type": "string",
      "description": "ISO 8601 datetime; wins over meal_period"
    },
    "place": {
      "type": "string",
      "description": "Venue or location. Empty or null clears"
    },
    "merchant": {
      "type": "string",
      "description": "Restaurant, stall, or shop. Empty or null clears"
    },
    "amount": {
      "type": "number",
      "description": "Price if mentioned"
    },
    "currency": {
      "type": "string",
      "description": "ISO currency, e.g. SGD"
    },
    "with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Companion names, aliases, or ids to add (does not remove existing tags)"
    },
    "people_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Alias for with"
    },
    "person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Owned person UUIDs to tag (user-scoped)"
    },
    "notes": {
      "type": "string",
      "description": "Replaces notes. Empty or null clears"
    },
    "append_notes": {
      "type": "string",
      "description": "Append text to existing notes (newline-separated)"
    },
    "paid_by": {
      "type": "string",
      "description": "Who paid (name or alias)"
    },
    "payment_method": {
      "type": "string",
      "description": "Alias of paid_by for expense-style agents"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "food_id"
  ],
  "additionalProperties": false
}

delete_food

MUTATES by removing one Food Diary row the authenticated user owns and its mirrored calendar event. Required: food_id (UUID). Prefer this over delete_event for meals logged via log_food. Unknown or other-user food_id returns an error. Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters3

food_id	string	required	UUID of a Food Diary row the authenticated user owns
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "food_id": {
      "type": "string",
      "description": "UUID of a Food Diary row the authenticated user owns"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "food_id"
  ],
  "additionalProperties": false
}

log_event

MUTATES the authenticated user calendar. Use for non-food days — funeral, cremation, appointment, dinner, anything that is not a food log. Do not store this as a chat memory. Example (funeral tonight): log_event({ title: "Funeral service — Mr Goh Choo Taw", date: "2026-08-29", time: "8pm", location: "Multi Purpose Hall, Blk 661 Jurong West St 64", category: "funeral" }). Example (Sunday cremation): log_event({ title: "Cremation — Mr Goh Choo Taw", date: "2026-08-30", location: "Mandai Crematorium", category: "funeral" }). Required: title + event_date (YYYY-MM-DD, YYYY-MM, or YYYY; alias date). Soft dates expand to first-of-period and set metadata.date_precision (day|month|year|approx). Optional: event_time (8pm or 20:00; alias time), end_date, end_time, location / city+country, description, category, external_url, visibility (private|friends|public), image_url, timezone, date_precision, share_with (Dayze handles e.g. ["boof"]), people / with / person_ids, idempotency_key (recommended; retries reuse the first write). For trips/residences prefer log_travel({ city, country, start_date, kind }). Unknown people names do not fail the write. Public events return share_url (/e/{id}) for Explore + social. Inserts public.events, optional event_people / shared_events, then rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Event title (required)."
        },
        "idempotency_key": {
          "type": "string",
          "description": "Optional client key (max 128 chars). Retries with the same key return the original result instead of creating a duplicate. If omitted, Dayze fingerprints args for ~15 minutes."
        },
        "request_id": {
          "type": "string",
          "description": "Alias for idempotency_key (preferred by some clients)."
        },
        "event_time": {
          "type": "string",
          "description": "Optional start time: 8pm, 20:00, or 20:00:00. Alias: time."
        },
        "time": {
          "type": "string",
          "description": "Alias for event_time."
        },
        "end_date": {
          "type": "string",
          "description": "Optional end date YYYY-MM-DD (all-day multi-day)."
        },
        "end_time": {
          "type": "string",
          "description": "Optional end time (same formats as event_time)."
        },
        "location": {
          "type": "string",
          "description": "Free-text place. Or pass city + country."
        },
        "city": {
          "type": "string",
          "description": "Structured city (composed into location if location omitted)"
        },
        "country": {
          "type": "string",
          "description": "Structured country"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string",
          "description": "e.g. funeral, family, work, travel. Stored as events.category and event_type."
        },
        "external_url": {
          "type": "string"
        },
        "visibility": {
          "type": "string",
          "enum": [
            "private",
            "friends",
            "public"
          ],
          "description": "Calendar visibility. public → appears on /explore and gets share_url https://dayze.com/e/{id}. Default private."
        },
        "image_url": {
          "type": "string",
          "description": "Optional cover image URL for Explore + /e share cards."
        },
        "timezone": {
          "type": "string",
          "description": "IANA timezone for wall-clock display (e.g. America/New_York)."
        },
        "date_precision": {
          "type": "string",
          "enum": [
            "day",
            "month",
            "year",
            "approx"
          ],
          "description": "Soft date precision stored in metadata. YYYY/YYYY-MM dates default to year/month."
        },
        "share_with": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Dayze profile handles to add as collaborators via shared_events (e.g. [\"boof\"]). Leading @ stripped."
        },
        "people": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "People names or person UUIDs to tag (event_people role=with)."
        },
        "with": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Alias for people."
        },
        "people_names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "person_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Owned person UUIDs to tag (user-scoped)."
        },
        "person_name": {
          "type": "string"
        },
        "amount": {
          "type": "number",
          "description": "If set, also writes a /money transaction (dual-write). Prefer log_transaction / import_venmo_gmail for cashflow-first digs."
        },
        "direction": {
          "type": "string",
          "enum": [
            "from",
            "to"
          ],
          "description": "With amount: from=received, to=sent"
        },
        "source": {
          "type": "string",
          "description": "With amount: venmo/zelle/…"
        },
        "external_id": {
          "type": "string",
          "description": "With amount: idempotency key"
        },
        "person_id": {
          "type": "string",
          "description": "With amount: CRM person UUID"
        },
        "currency": {
          "type": "string"
        },
        "mirror_transaction": {
          "type": "boolean",
          "description": "Default true when amount is set; set false to keep calendar-only"
        },
        "event_date": {
          "type": "string",
          "description": "Start date YYYY-MM-DD. Alias: date."
        },
        "date": {
          "type": "string",
          "description": "Alias for event_date."
        }
      },
      "required": [
        "title",
        "event_date"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Event title (required)."
        },
        "idempotency_key": {
          "type": "string",
          "description": "Optional client key (max 128 chars). Retries with the same key return the original result instead of creating a duplicate. If omitted, Dayze fingerprints args for ~15 minutes."
        },
        "request_id": {
          "type": "string",
          "description": "Alias for idempotency_key (preferred by some clients)."
        },
        "event_time": {
          "type": "string",
          "description": "Optional start time: 8pm, 20:00, or 20:00:00. Alias: time."
        },
        "time": {
          "type": "string",
          "description": "Alias for event_time."
        },
        "end_date": {
          "type": "string",
          "description": "Optional end date YYYY-MM-DD (all-day multi-day)."
        },
        "end_time": {
          "type": "string",
          "description": "Optional end time (same formats as event_time)."
        },
        "location": {
          "type": "string",
          "description": "Free-text place. Or pass city + country."
        },
        "city": {
          "type": "string",
          "description": "Structured city (composed into location if location omitted)"
        },
        "country": {
          "type": "string",
          "description": "Structured country"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string",
          "description": "e.g. funeral, family, work, travel. Stored as events.category and event_type."
        },
        "external_url": {
          "type": "string"
        },
        "visibility": {
          "type": "string",
          "enum": [
            "private",
            "friends",
            "public"
          ],
          "description": "Calendar visibility. public → appears on /explore and gets share_url https://dayze.com/e/{id}. Default private."
        },
        "image_url": {
          "type": "string",
          "description": "Optional cover image URL for Explore + /e share cards."
        },
        "timezone": {
          "type": "string",
          "description": "IANA timezone for wall-clock display (e.g. America/New_York)."
        },
        "date_precision": {
          "type": "string",
          "enum": [
            "day",
            "month",
            "year",
            "approx"
          ],
          "description": "Soft date precision stored in metadata. YYYY/YYYY-MM dates default to year/month."
        },
        "share_with": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Dayze profile handles to add as collaborators via shared_events (e.g. [\"boof\"]). Leading @ stripped."
        },
        "people": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "People names or person UUIDs to tag (event_people role=with)."
        },
        "with": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Alias for people."
        },
        "people_names": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "person_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Owned person UUIDs to tag (user-scoped)."
        },
        "person_name": {
          "type": "string"
        },
        "amount": {
          "type": "number",
          "description": "If set, also writes a /money transaction (dual-write). Prefer log_transaction / import_venmo_gmail for cashflow-first digs."
        },
        "direction": {
          "type": "string",
          "enum": [
            "from",
            "to"
          ],
          "description": "With amount: from=received, to=sent"
        },
        "source": {
          "type": "string",
          "description": "With amount: venmo/zelle/…"
        },
        "external_id": {
          "type": "string",
          "description": "With amount: idempotency key"
        },
        "person_id": {
          "type": "string",
          "description": "With amount: CRM person UUID"
        },
        "currency": {
          "type": "string"
        },
        "mirror_transaction": {
          "type": "boolean",
          "description": "Default true when amount is set; set false to keep calendar-only"
        },
        "event_date": {
          "type": "string",
          "description": "Start date YYYY-MM-DD. Alias: date."
        },
        "date": {
          "type": "string",
          "description": "Alias for event_date."
        }
      },
      "required": [
        "title",
        "date"
      ],
      "additionalProperties": false
    }
  ]
}

update_event

MUTATES one existing calendar event the authenticated user owns. Required: event_id (UUID). Optional patch (same fields as log_event): title, date / event_date, time / event_time, end_date, end_time, location, description, category, external_url, people / with / person_ids. Unknown or other-user event_id returns an error and does not create a row. For food-diary meals, prefer update_food (it syncs the mirrored event). Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters20

event_id	string	required	UUID of a calendar event the authenticated user owns
title	string	optional	Updated title (replaces). Cannot be empty.
event_date	string	optional	Start date YYYY-MM-DD, YYYY-MM, or YYYY. Alias: date.
date	string	optional	Alias for event_date.
date_precision	string	optional	Soft date precision stored in metadata.
event_time	string	optional	Start time: 8pm, 20:00, or 20:00:00. Empty or null clears. Alias: time.
time	string	optional	Alias for event_time.
end_date	string	optional	Optional end date YYYY-MM-DD (all-day multi-day).
end_time	string	optional	Optional end time (same formats as event_time).
location	string	optional	Empty or null clears
description	string	optional	Empty or null clears
category	string	optional	e.g. funeral, family, work, travel. Stored as events.category and event_type.
external_url	string	optional
people	array	optional	People names or person UUIDs to add (event_people role=with). Does not remove existing tags.
with	array	optional	Alias for people.
people_names	array	optional
person_ids	array	optional	Owned person UUIDs to tag (user-scoped).
person_name	string	optional
request_id	string	optional	Client idempotency key (retries return original successful result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "UUID of a calendar event the authenticated user owns"
    },
    "title": {
      "type": "string",
      "description": "Updated title (replaces). Cannot be empty."
    },
    "event_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD, YYYY-MM, or YYYY. Alias: date."
    },
    "date": {
      "type": "string",
      "description": "Alias for event_date."
    },
    "date_precision": {
      "type": "string",
      "enum": [
        "day",
        "month",
        "year",
        "approx"
      ],
      "description": "Soft date precision stored in metadata."
    },
    "event_time": {
      "type": "string",
      "description": "Start time: 8pm, 20:00, or 20:00:00. Empty or null clears. Alias: time."
    },
    "time": {
      "type": "string",
      "description": "Alias for event_time."
    },
    "end_date": {
      "type": "string",
      "description": "Optional end date YYYY-MM-DD (all-day multi-day)."
    },
    "end_time": {
      "type": "string",
      "description": "Optional end time (same formats as event_time)."
    },
    "location": {
      "type": "string",
      "description": "Empty or null clears"
    },
    "description": {
      "type": "string",
      "description": "Empty or null clears"
    },
    "category": {
      "type": "string",
      "description": "e.g. funeral, family, work, travel. Stored as events.category and event_type."
    },
    "external_url": {
      "type": "string"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "People names or person UUIDs to add (event_people role=with). Does not remove existing tags."
    },
    "with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Alias for people."
    },
    "people_names": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Owned person UUIDs to tag (user-scoped)."
    },
    "person_name": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original successful result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "event_id"
  ],
  "additionalProperties": false
}

delete_event

Reversibly archives one owned event. Required event_id and request_id. Returns the prior row in deleted for compatibility, changed, restore_id and life_state_rebuilt. All food, people and asset links are preserved. Restore with restore_event. Replays perform no additional action. ($0.10; API key required)

Parameters3

event_id	string	required	UUID of a calendar event the authenticated user owns
request_id	string	required	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "UUID of a calendar event the authenticated user owns"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "event_id",
    "request_id"
  ],
  "additionalProperties": false
}

log_favorite_song

MUTATES the authenticated user favorite tracks list at /music. Use when they favorite or save a song — do not store this as a chat memory or in music_preferences. Example: “Henry Mancini - Piano And Strings (1995 Remastered)” → log_favorite_song({ track: "Henry Mancini - Piano And Strings (1995 Remastered)" }) or title + artist. Optional year_note, source_url. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters9

title	string	optional	Track title (required unless track blob parses)
artist	string	optional	Artist name (required unless track blob parses)
track	string	optional	Optional "Artist - Title (year remaster)" blob
year_note	string	optional	Optional year or remaster note
remaster_note	string	optional	Alias for year_note
source_url	string	optional	Optional https link
url	string	optional	Alias for source_url
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Track title (required unless track blob parses)"
    },
    "artist": {
      "type": "string",
      "description": "Artist name (required unless track blob parses)"
    },
    "track": {
      "type": "string",
      "description": "Optional \"Artist - Title (year remaster)\" blob"
    },
    "year_note": {
      "type": "string",
      "description": "Optional year or remaster note"
    },
    "remaster_note": {
      "type": "string",
      "description": "Alias for year_note"
    },
    "source_url": {
      "type": "string",
      "description": "Optional https link"
    },
    "url": {
      "type": "string",
      "description": "Alias for source_url"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

get_memories

Authenticated user memories from Dayze Agent. Pass query for semantic/keyword retrieval. Prefer search for event-first trip and calendar titles. Requires OAuth or a supported scoped credential. ($0.10; API key required)

Parameters2

query	string	optional	Semantic focus (optional)
limit	number	optional	Max rows 1–50, default 20

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Semantic focus (optional)"
    },
    "limit": {
      "type": "number",
      "description": "Max rows 1–50, default 20"
    }
  },
  "additionalProperties": false
}

get_expenses

Authenticated user cashflow summary: spend, income, net, and top spend categories. Requires OAuth or a supported scoped credential. ($0.10; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

resolve_person

Resolve a nickname or surface name to a Dayze Contacts row via person_aliases → exact name → slug → unique substring. Returns avatar_url, photo_count, has_photos, and photos[{url,is_primary}] preview; use get_person_photos for full gallery. Notes omitted unless include_notes=true (redacted). Prefer this before money or relationship tools when the agent only has a nickname. Advertised name resolve_person is stable; tools/call also accepts resolve_contact. ($0.05; API key required)

Parameters3

name	string	required	Nickname or display name to resolve
query	string	optional	Alias for name
include_notes	boolean	optional	Include redacted notes (default false)

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Nickname or display name to resolve"
    },
    "query": {
      "type": "string",
      "description": "Alias for name"
    },
    "include_notes": {
      "type": "boolean",
      "description": "Include redacted notes (default false)",
      "default": false
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

get_person_aliases

List canonical aliases (nicknames) for a CRM person. Pass person_id or name (resolved via aliases). Requires OAuth or a supported scoped credential. ($0.05; API key required)

Parameters2

person_id	string	optional	CRM people.id
name	string	optional	Surface name if person_id unknown

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "CRM people.id"
    },
    "name": {
      "type": "string",
      "description": "Surface name if person_id unknown"
    }
  },
  "additionalProperties": false
}

get_person_transactions

Me↔contact money ledger from expenses (paid_to_person_id / income_from_person_id). Pass person_id or name. Returns entries + per-currency totals. Reuses existing expenses — no parallel ledger table. ($0.10; API key required)

Parameters5

person_id	string	optional	CRM people.id
name	string	optional	Surface name if person_id unknown
from	string	optional	Inclusive YYYY-MM-DD filter
to	string	optional	Inclusive YYYY-MM-DD filter
limit	number	optional	Max rows 1–200, default 50

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "CRM people.id"
    },
    "name": {
      "type": "string",
      "description": "Surface name if person_id unknown"
    },
    "from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "limit": {
      "type": "number",
      "description": "Max rows 1–200, default 50"
    }
  },
  "additionalProperties": false
}

get_money_between_people

Same as get_person_transactions: authenticated user ↔ one contact via expenses FKs. Prefer get_person_transactions; this alias exists for agent discoverability. ($0.10; API key required)

Parameters5

person_id	string	optional	CRM people.id
name	string	optional	Surface name if person_id unknown
from	string	optional	Inclusive YYYY-MM-DD filter
to	string	optional	Inclusive YYYY-MM-DD filter
limit	number	optional	Max rows 1–200, default 50

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "CRM people.id"
    },
    "name": {
      "type": "string",
      "description": "Surface name if person_id unknown"
    },
    "from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "limit": {
      "type": "number",
      "description": "Max rows 1–200, default 50"
    }
  },
  "additionalProperties": false
}

get_person_interactions

Relationship timeline for one CRM person: interactions rows (message/call/meeting/note + extended kinds like visit/gift/stayed_over encoded in summary) plus co-tagged calendar events. Prefer this over dumping people.notes for “when did I last see X?”. Pass person_id or name. ($0.10; API key required)

Parameters6

person_id	string	optional
name	string	optional
from	string	optional	Inclusive YYYY-MM-DD filter
to	string	optional	Inclusive YYYY-MM-DD filter
kind	string	optional	Optional filter: meeting, visit, gift, stayed_over, met, …
limit	number	optional	Max rows 1–100, default 40

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD filter"
    },
    "kind": {
      "type": "string",
      "description": "Optional filter: meeting, visit, gift, stayed_over, met, …"
    },
    "limit": {
      "type": "number",
      "description": "Max rows 1–100, default 40"
    }
  },
  "additionalProperties": false
}

get_interactions

Bounded graph read over life_updates (PHI-54/61): traverse interaction → person/event/expense/place with source/confidence on every hop. Prefer for “who was I with at X?”, “when am I meeting Y next?”, “how much at Z?”. 93-day default window. Pass person_name, place_query, or ids. ($0.10; API key required)

Parameters9

person_id	string	optional
person_name	string	optional
place_id	string	optional
place_query	string	optional	Venue/merchant substring
expense_id	string	optional
event_id	string	optional
from	string	optional	Inclusive YYYY-MM-DD
to	string	optional	Inclusive YYYY-MM-DD
limit	number	optional	Max 1–50, default 25

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "person_name": {
      "type": "string"
    },
    "place_id": {
      "type": "string"
    },
    "place_query": {
      "type": "string",
      "description": "Venue/merchant substring"
    },
    "expense_id": {
      "type": "string"
    },
    "event_id": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD"
    },
    "to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD"
    },
    "limit": {
      "type": "number",
      "description": "Max 1–50, default 25"
    }
  },
  "additionalProperties": false
}

explain_fact

Return evidence/provenance for a claim: polaris_learned_facts, life_events / life_event_relationships when present, then memories. Use when the agent must cite why it believes something — do not invent sources. ($0.10; API key required)

Parameters3

query	string	required	Fact or phrase to explain
fact	string	optional	Alias for query
limit	number	optional	Max evidence rows 1–20, default 8

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Fact or phrase to explain"
    },
    "fact": {
      "type": "string",
      "description": "Alias for query"
    },
    "limit": {
      "type": "number",
      "description": "Max evidence rows 1–20, default 8"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

list_clarifications

Ranked clarification queue: only person-typed mentions + duplicate CRM people. Non-person junk (places, orgs, media, command fragments) is auto-dismissed. Existing contacts auto-link. ($0.05; API key required)

Parameters3

limit	number	optional	Max rows 1–50, default 15
kind	string	optional	Optional: entity_mention \| duplicate_people
auto_cleanup	boolean	optional	Auto-dismiss non-person / auto-link existing (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max rows 1–50, default 15"
    },
    "kind": {
      "type": "string",
      "description": "Optional: entity_mention | duplicate_people"
    },
    "auto_cleanup": {
      "type": "boolean",
      "description": "Auto-dismiss non-person / auto-link existing (default true)"
    }
  },
  "additionalProperties": false
}

get_trackers

Authenticated user live trackers only; expired countdowns and inactive streaks are omitted. Sobriety/streak trackers remain visible at day 0 after a reset. Merges event-backed trackers with the trackers table when present. Requires OAuth or a supported scoped credential. ($0.10; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

reset_tracker

MUTATES a sobriety/streak tracker for the authenticated user (sets current value to 0 and restarts the clock). Prefer tracker_id from get_trackers, or tracker_title fuzzy match. Optional reset_at (ISO) and note. Rebuilds life_state. Requires API key or OAuth with scope context. Share tokens cannot write. ($0.10; API key required)

Parameters7

tracker_id	string	optional	Event UUID of the tracker
tracker_title	string	optional	Title match when id unknown
title	string	optional	Alias of tracker_title
reset_at	string	optional	ISO datetime of the reset (default now)
note	string	optional	Optional note stored in tracking history
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "tracker_id": {
      "type": "string",
      "description": "Event UUID of the tracker"
    },
    "tracker_title": {
      "type": "string",
      "description": "Title match when id unknown"
    },
    "title": {
      "type": "string",
      "description": "Alias of tracker_title"
    },
    "reset_at": {
      "type": "string",
      "description": "ISO datetime of the reset (default now)"
    },
    "note": {
      "type": "string",
      "description": "Optional note stored in tracking history"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

search

Search the authenticated user life graph. Deterministic routing first: food + relative dates (e.g. "what did I eat yesterday?"); timeline/current-context; money+person; who-is → resolve_person. Otherwise semantic/keyword search. Event hits include event_date and food_id when mirrored from Food Diary. Browser-history titles are excluded. Credential/secret spans are redacted. Requires OAuth or a supported scoped credential. ($0.15; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "Max results 1–50",
          "default": 10
        },
        "query": {
          "type": "string",
          "description": "Primary search query."
        },
        "q": {
          "type": "string",
          "description": "Alias for query."
        }
      },
      "required": [
        "query"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "Max results 1–50",
          "default": 10
        },
        "query": {
          "type": "string",
          "description": "Primary search query."
        },
        "q": {
          "type": "string",
          "description": "Alias for query."
        }
      },
      "required": [
        "q"
      ],
      "additionalProperties": false
    }
  ]
}

search_gmail

Search one of the authenticated user's connected Gmail inboxes (read-only). Reuses Integrations hub Gmail (service_connections provider=gmail). Optional account/email selects a mailbox when multiple are connected — call list_gmail_accounts first. Prefer Gmail operators: from:, subject:, is:unread, newer_than:7d, has:attachment. Returns id, subject, from, date, snippet only (no body). Follow up with read_gmail_message. Cannot send, archive, or delete. Never invent email contents. If Gmail is not connected, connect at /integrations. Requires API key or OAuth with scope context. Share tokens cannot call this tool. ($0.10; API key required)

Parameters5

query	string	required	Gmail search query, e.g. "is:unread newer_than:7d", "from:airline subject:itinerary", "receipt newer_than:30d"
q	string	optional	Alias for query
max_results	number	optional	Max messages to return (default 10, max 20)
account	string	optional	Mailbox email, connection id, or Google subject (from list_gmail_accounts)
email	string	optional	Alias for account

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Gmail search query, e.g. \"is:unread newer_than:7d\", \"from:airline subject:itinerary\", \"receipt newer_than:30d\""
    },
    "q": {
      "type": "string",
      "description": "Alias for query"
    },
    "max_results": {
      "type": "number",
      "description": "Max messages to return (default 10, max 20)",
      "default": 10
    },
    "account": {
      "type": "string",
      "description": "Mailbox email, connection id, or Google subject (from list_gmail_accounts)"
    },
    "email": {
      "type": "string",
      "description": "Alias for account"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

list_gmail_accounts

List connected Gmail mailboxes for the authenticated user (id, email, is_default). Use account on search_gmail / read_gmail_* / import_*_gmail to pick a mailbox. Connect another inbox at /integrations (multi-mailbox after migration). Share tokens cannot call. ($0.05; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

read_gmail_message

Read one Gmail message by id from search_gmail. Returns subject, from, date, snippet, plain-text body (truncated), and attachments[] metadata (attachment_id, filename, mime_type, size). Use read_gmail_attachment for text/csv/vcf contents. Optional account when multiple mailboxes. Read-only. Share tokens cannot call. ($0.10; API key required)

Parameters4

message_id	string	required	Gmail message id from search_gmail
id	string	optional	Alias for message_id
account	string	optional	Mailbox selector (email or connection id)
email	string	optional	Alias for account

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string",
      "description": "Gmail message id from search_gmail"
    },
    "id": {
      "type": "string",
      "description": "Alias for message_id"
    },
    "account": {
      "type": "string",
      "description": "Mailbox selector (email or connection id)"
    },
    "email": {
      "type": "string",
      "description": "Alias for account"
    }
  },
  "required": [
    "message_id"
  ],
  "additionalProperties": false
}

read_gmail_attachment

Download one Gmail attachment by message_id + attachment_id (from read_gmail_message.attachments). Returns utf-8 text for text/csv/vcf/vcard; binary types return filename/mime/size + a note (no base64 dump). Optional account. Read-only. Share tokens cannot call. ($0.10; API key required)

Parameters4

message_id	string	required
attachment_id	string	required
account	string	optional
email	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "string"
    },
    "attachment_id": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "email": {
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "attachment_id"
  ],
  "additionalProperties": false
}

log_sleep

Sleep: log overnight or nap. Cross-midnight OK (e.g. 14:00→03:00 = 13h / 780m). ($0.10; API key required)

Parameters11

started_at	string	required	ISO start
ended_at	string	required	ISO end
sleep_type	string	optional
timezone	string	optional
timezone_start	string	optional
timezone_end	string	optional
quality	number	optional
notes	string	optional
source	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "started_at": {
      "type": "string",
      "description": "ISO start"
    },
    "ended_at": {
      "type": "string",
      "description": "ISO end"
    },
    "sleep_type": {
      "type": "string",
      "enum": [
        "overnight",
        "nap",
        "unknown"
      ]
    },
    "timezone": {
      "type": "string"
    },
    "timezone_start": {
      "type": "string"
    },
    "timezone_end": {
      "type": "string"
    },
    "quality": {
      "type": "number"
    },
    "notes": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "started_at",
    "ended_at"
  ],
  "additionalProperties": false
}

get_sleep

Sleep: list typed sleep/nap records with duration_minutes. ($0.05; API key required)

Parameters3

from	string	optional
to	string	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

get_sleep_summary

Sleep: day/week/month totals and averages. ($0.05; API key required)

Parameters1

range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "range": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ]
    }
  },
  "additionalProperties": false
}

update_sleep

Sleep: patch an existing sleep record by sleep_id. ($0.10; API key required)

Parameters9

sleep_id	string	required
started_at	string	optional
ended_at	string	optional
sleep_type	string	optional
quality	number	optional
notes	string	optional
timezone	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "sleep_id": {
      "type": "string"
    },
    "started_at": {
      "type": "string"
    },
    "ended_at": {
      "type": "string"
    },
    "sleep_type": {
      "type": "string",
      "enum": [
        "overnight",
        "nap",
        "unknown"
      ]
    },
    "quality": {
      "type": "number"
    },
    "notes": {
      "type": "string"
    },
    "timezone": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "sleep_id"
  ],
  "additionalProperties": false
}

resolve_place

Canonicalize a venue name via place aliases and fuzzy match. ($0.10; API key required)

Parameters3

place	string	optional
query	string	optional
name	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_places

Known venues: visit-graph `places` plus saved place cards (`saved_places` from business_contacts) with address, opening_hours, and affordability ($/$$/$$$). ($0.10; API key required)

Parameters7

city	string	optional
country	string	optional
area	string	optional
near	string	optional	Filter saved cards by area/tag/notes (e.g. Madeira).
tag	string	optional
affordability	string	optional	$ \| $$ \| $$$
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "area": {
      "type": "string"
    },
    "near": {
      "type": "string",
      "description": "Filter saved cards by area/tag/notes (e.g. Madeira)."
    },
    "tag": {
      "type": "string"
    },
    "affordability": {
      "type": "string",
      "description": "$ | $$ | $$$"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

get_place

Fetch one saved place card (business_contacts) by place_id — address, opening hours, affordability, notes. ($0.05; API key required)

Parameters3

place_id	string	optional
business_contact_id	string	optional
id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string"
    },
    "business_contact_id": {
      "type": "string"
    },
    "id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

create_place

Save a venue card (business_contacts): address, opening_hours, affordability ($/$$/$$$), notes, tags. Idempotent by name or idempotency_key — does not create calendar notes. ($0.10; API key required)

Parameters21

name	string	required
address	string	optional
opening_hours	string	optional
hours	string	optional	Alias for opening_hours
affordability	string	optional	$ \| $$ \| $$$ (or 1–3)
price_level	string	optional	Alias for affordability
category	string	optional	restaurant\|cafe\|supermarket\|shop\|hawker\|… (aliases mapped to business_contacts.category)
area	string	optional
city	string	optional
country	string	optional
notes	string	optional
tags	array	optional
website	string	optional
phone	string	optional
phone_numbers	array	optional
description	string	optional
hours_source	string	optional	agent \| google_places \| user
idempotency_key	string	optional
latitude	number	optional
longitude	number	optional
request_id	string	optional	Client idempotency key (retries return original result).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "opening_hours": {
      "type": "string"
    },
    "hours": {
      "type": "string",
      "description": "Alias for opening_hours"
    },
    "affordability": {
      "type": "string",
      "description": "$ | $$ | $$$ (or 1–3)"
    },
    "price_level": {
      "type": "string",
      "description": "Alias for affordability"
    },
    "category": {
      "type": "string",
      "description": "restaurant|cafe|supermarket|shop|hawker|… (aliases mapped to business_contacts.category)"
    },
    "area": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "website": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "description": {
      "type": "string"
    },
    "hours_source": {
      "type": "string",
      "description": "agent | google_places | user"
    },
    "idempotency_key": {
      "type": "string"
    },
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

update_place

Patch a saved place card by place_id / business_contact_id. Unspecified fields stay unchanged (hours, affordability, address, notes, …). ($0.10; API key required)

Parameters24

place_id	string	optional
business_contact_id	string	optional
id	string	optional
name	string	optional
address	string	optional
opening_hours	string	optional
hours	string	optional
affordability	string	optional
price_level	string	optional
category	string	optional
area	string	optional
city	string	optional
country	string	optional
notes	string	optional
tags	array	optional
website	string	optional
phone	string	optional
phone_numbers	array	optional
description	string	optional
hours_source	string	optional
latitude	number	optional
longitude	number	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string"
    },
    "business_contact_id": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "opening_hours": {
      "type": "string"
    },
    "hours": {
      "type": "string"
    },
    "affordability": {
      "type": "string"
    },
    "price_level": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "area": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "website": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phone_numbers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "description": {
      "type": "string"
    },
    "hours_source": {
      "type": "string"
    },
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

enrich_place_from_google

Optional Google Places fill for a saved place card (hours/address/phone/website). Defaults to fill_empty_only — does not overwrite agent-supplied fields. ($0.15; API key required)

Parameters5

place_id	string	optional
business_contact_id	string	optional
fill_empty_only	boolean	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string"
    },
    "business_contact_id": {
      "type": "string"
    },
    "fill_empty_only": {
      "type": "boolean"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

get_place_visits

When was I at a venue — merges place_visits, location_visits, and event locations. ($0.10; API key required)

Parameters5

place	string	required
place_id	string	optional
from	string	optional
to	string	optional
person_ids	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string"
    },
    "place_id": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "place"
  ],
  "additionalProperties": false
}

get_location_history

Normalized visit history (venue-level by default). Merges GPS location_visits + place_visits (MCP/Uber digs). ($0.10; API key required)

Parameters6

from	string	optional
to	string	optional
place	string	optional
city	string	optional
country	string	optional
precision	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "place": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "precision": {
      "type": "string",
      "enum": [
        "point",
        "venue",
        "neighborhood",
        "city",
        "country"
      ]
    }
  },
  "additionalProperties": false
}

log_place_visit

MUTATES place_visits for map/history digs (Uber dropoff, address evidence). Required: place (or place_id) + arrived_at/date. Optional: departed_at, source (uber|mcp|…), evidence_expense_id (idempotent), city/country/address. Prefer this over stuffing streets only into expenses. ($0.10; API key required)

Parameters15

place	string	optional
name	string	optional	Alias for place
place_id	string	optional
arrived_at	string	optional	ISO or YYYY-MM-DD
date	string	optional	Alias for arrived_at
departed_at	string	optional
source	string	optional
evidence_expense_id	string	optional
evidence_event_id	string	optional
address	string	optional
city	string	optional
country	string	optional
confidence	number	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Alias for place"
    },
    "place_id": {
      "type": "string"
    },
    "arrived_at": {
      "type": "string",
      "description": "ISO or YYYY-MM-DD"
    },
    "date": {
      "type": "string",
      "description": "Alias for arrived_at"
    },
    "departed_at": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "evidence_expense_id": {
      "type": "string"
    },
    "evidence_event_id": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

get_location_context

Likely current or at-time place with confidence and provenance. ($0.10; API key required)

Parameters1

string

optional

ISO timestamp

Raw schema

{
  "type": "object",
  "properties": {
    "at": {
      "type": "string",
      "description": "ISO timestamp"
    }
  },
  "additionalProperties": false
}

get_current_states

Permitted assertion states for a person (flagged life-graph; off by default). ($0.10; API key required)

Parameters5

people_id	string	optional	CRM people.id UUID
person_id	string	optional	Alias for people_id
predicates	array	optional
valid_at	string	optional
known_at	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "people_id": {
      "type": "string",
      "description": "CRM people.id UUID"
    },
    "person_id": {
      "type": "string",
      "description": "Alias for people_id"
    },
    "predicates": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "valid_at": {
      "type": "string"
    },
    "known_at": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

propose_life_update

Propose assertion create/correct without committing (flagged; off by default). ($0.10; API key required)

Parameters9

people_id	string	optional
person_id	string	optional
predicate	string	optional
value	object	optional
source_text	string	optional
operations	array	optional
client_id	string	optional
idempotency_key	string	optional
request_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "people_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "predicate": {
      "type": "string"
    },
    "value": {
      "type": "object",
      "additionalProperties": true
    },
    "source_text": {
      "type": "string"
    },
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "client_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

commit_life_update

Owner approve+commit via payload_hash + owner_session_id (flagged; off by default). ($0.10; API key required)

Parameters5

proposal_id	string	required
payload_hash	string	required
owner_session_id	string	required
idempotency_key	string	optional
request_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "proposal_id": {
      "type": "string"
    },
    "payload_hash": {
      "type": "string"
    },
    "owner_session_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    }
  },
  "required": [
    "proposal_id",
    "payload_hash",
    "owner_session_id"
  ],
  "additionalProperties": false
}

update_current_location

MUTATES where the user is now: profiles.location + polaris current_city/country (same as in-app Dayze chat). Pass location ("The Madeira, Singapore") and/or city+country; optional place/venue + lat/lon records a fresh location_visits check-in so get_location_context returns is_current. set_home defaults true; check_in defaults true when place or coordinates are set. Does not invent GPS when omitted. ($0.10; API key required)

Parameters12

location	string	optional	Freeform “City, Country” or “Venue, City, Country”
city	string	optional
country	string	optional
place	string	optional	Venue / residence name (e.g. The Madeira)
venue	string	optional	Alias for place
address	string	optional
latitude	number	optional
longitude	number	optional
set_home	boolean	optional	Also write profiles.location / home_location (default true)
check_in	boolean	optional	Write a location_visits row when place or coordinates are set (default true in that case)
idempotency_key	string	optional
request_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "Freeform “City, Country” or “Venue, City, Country”"
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "place": {
      "type": "string",
      "description": "Venue / residence name (e.g. The Madeira)"
    },
    "venue": {
      "type": "string",
      "description": "Alias for place"
    },
    "address": {
      "type": "string"
    },
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "set_home": {
      "type": "boolean",
      "description": "Also write profiles.location / home_location (default true)"
    },
    "check_in": {
      "type": "boolean",
      "description": "Write a location_visits row when place or coordinates are set (default true in that case)"
    },
    "idempotency_key": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_trips

User trips with status filter (planned/completed/etc.). Residences also appear here with metadata.kind=residence — prefer get_residences for home history. ($0.10; API key required)

Parameters6

cursor	string	optional	Continue the same immutable one-hour snapshot; other filters remain frozen.
include_archived	boolean	optional
from	string	optional
to	string	optional
status	string	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
    },
    "include_archived": {
      "type": "boolean"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

get_residences

Home / residence history separate from trips: trips with metadata.kind=residence (from log_travel) plus optional life_eras. Use for Boylston / Madeira / current home cards. ($0.10; API key required)

Parameters4

from	string	optional
to	string	optional
limit	number	optional
include_eras	boolean	optional	Include life_eras rows (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "include_eras": {
      "type": "boolean",
      "description": "Include life_eras rows (default true)"
    }
  },
  "additionalProperties": false
}

get_trip

Single trip with linked places and people. ($0.10; API key required)

Parameters1

trip_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string"
    }
  },
  "required": [
    "trip_id"
  ],
  "additionalProperties": false
}

get_travel_history

Completed/confirmed travel only. ($0.10; API key required)

Parameters2

from	string	optional
to	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_countries_visited

Canonical countries from completed trips (not other people travel). ($0.10; API key required)

Parameters3

from	string	optional
to	string	optional
include_residence	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "include_residence": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

get_cities_visited

Canonical cities from confirmed/completed trips only (excludes soft pins / status=possible). Inference requires category=travel + structured location — not todo titles. ($0.10; API key required)

Parameters2

from	string	optional
to	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

log_travel

MUTATES trips (+ optional calendar travel event). Prefer this over free-text log_event for map/history. Required: city + start_date. Optional: country, end_date, kind (trip|residence|soft_pin), confidence (confirmed|likely|possible), evidence, title, mirror_event. Soft pins default to status=possible and stay off cities/map until confidence=confirmed. Zelle/Venmo money belongs in log_transaction — not here. ($0.10; API key required)

Parameters12

city	string	required
country	string	optional
start_date	string	optional	YYYY-MM-DD
date	string	optional	Alias for start_date
end_date	string	optional
kind	string	optional
confidence	string	optional
title	string	optional
evidence	string	optional	Source note (Gmail id, address, etc.)
mirror_event	boolean	optional	Also insert category=travel calendar event (default true)
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "date": {
      "type": "string",
      "description": "Alias for start_date"
    },
    "end_date": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "trip",
        "residence",
        "soft_pin"
      ]
    },
    "confidence": {
      "type": "string",
      "enum": [
        "confirmed",
        "likely",
        "possible"
      ]
    },
    "title": {
      "type": "string"
    },
    "evidence": {
      "type": "string",
      "description": "Source note (Gmail id, address, etc.)"
    },
    "mirror_event": {
      "type": "boolean",
      "description": "Also insert category=travel calendar event (default true)"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false
}

create_person

Add a Dayze Contacts record; checks duplicates first. Advertised name create_person is stable; tools/call also accepts create_contact. ($0.10; API key required)

Parameters9

name	string	required
relationship	string	optional
tier	string	optional
notes	string	optional
email	string	optional
phone	string	optional
aliases	array	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "relationship": {
      "type": "string"
    },
    "tier": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "aliases": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

merge_people

Apply a reviewed durable preview atomically; undo_contact_change accepts restore_id for 30 days if unchanged. Fold duplicate CRM contact(s) into primary_person_id (same human, spelling variants). Prefer score_people_duplicates first. Not for “X knows Y” — use link_people for relationships. ($0.10; API key required)

Parameters6

preview_id	string	required	Durable preview_id returned by merge_people_preview; review the 30-day restore window before applying.
primary_person_id	string	required
duplicate_person_ids	array	required
restore_window_acknowledged	boolean	required	Must be true — confirms the 30-day restore window was reviewed before apply.
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "preview_id": {
      "type": "string",
      "description": "Durable preview_id returned by merge_people_preview; review the 30-day restore window before applying."
    },
    "primary_person_id": {
      "type": "string"
    },
    "duplicate_person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "restore_window_acknowledged": {
      "type": "boolean",
      "description": "Must be true — confirms the 30-day restore window was reviewed before apply."
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "primary_person_id",
    "duplicate_person_ids",
    "preview_id",
    "restore_window_acknowledged"
  ],
  "additionalProperties": false
}

score_people_duplicates

Score likely CRM duplicate pairs before merge_people. ($0.05; API key required)

Parameters3

person_id	string	optional	Score against one person; omit for global scan.
limit	number	optional
min_probability	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "Score against one person; omit for global scan."
    },
    "limit": {
      "type": "number"
    },
    "min_probability": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

link_people

NON-DESTRUCTIVE: create/update a person_connections edge between two distinct people (friends/family/knows/…). Both contacts remain. Do not use for duplicate cleanup — use merge_people. ($0.10; API key required)

Parameters9

person_id	string	required
other_person_id	string	required
relationship_type	string	optional
notes	string	optional
source	string	optional
confidence	number	optional
direction	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "other_person_id": {
      "type": "string"
    },
    "relationship_type": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "direction": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id",
    "other_person_id"
  ],
  "additionalProperties": false
}

get_person_connections

List graph edges for one CRM person. ($0.05; API key required)

Parameters1

person_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

unlink_people

Remove a person↔person graph edge. ($0.10; API key required)

Parameters5

connection_id	string	optional
person_id	string	optional
other_person_id	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "connection_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "other_person_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

set_primary_person_name

Rename a CRM contact’s canonical name and refresh slug. By default preserves the old name as a former_name alias. Prefer this over create+merge for spelling fixes. Dayze is the context layer — bounded mutation only. ($0.10; API key required)

Parameters5

person_id	string	required
name	string	required
preserve_old_name_as_alias	boolean	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "preserve_old_name_as_alias": {
      "type": "boolean"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id",
    "name"
  ],
  "additionalProperties": false
}

update_person_identity

Patch identity fields (legal/preferred name, pronouns, social handles, user_relationships[]). Never infer sensitive identity from appearance. Confirmed user_relationships are preserved unless force=true. ($0.10; API key required)

Parameters11

person_id	string	required
legal_name	string	optional
preferred_name	string	optional
pronouns	string	optional
website	string	optional
social_handles	object	optional
aliases	array	optional
user_relationships	array	optional
force	boolean	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "legal_name": {
      "type": "string"
    },
    "preferred_name": {
      "type": "string"
    },
    "pronouns": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "social_handles": {
      "type": "object",
      "additionalProperties": true
    },
    "aliases": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "user_relationships": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "force": {
      "type": "boolean"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

add_person_alias

Add a nickname/payment handle/misspelling alias for one CRM person. ($0.05; API key required)

Parameters6

person_id	string	required
alias	string	required
alias_kind	string	optional
source	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "alias": {
      "type": "string"
    },
    "alias_kind": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id",
    "alias"
  ],
  "additionalProperties": false
}

remove_person_alias

Remove one alias from a CRM person. ($0.05; API key required)

Parameters4

person_id	string	required
alias	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "alias": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id",
    "alias"
  ],
  "additionalProperties": false
}

update_person_alias

Update alias_kind/source/display for an existing alias. ($0.05; API key required)

Parameters7

person_id	string	required
alias	string	required
alias_kind	string	optional
source	string	optional
alias_display	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "alias": {
      "type": "string"
    },
    "alias_kind": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "alias_display": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "person_id",
    "alias"
  ],
  "additionalProperties": false
}

audit_people

CONTEXT LAYER: server-side contact hygiene. Returns compact candidate clusters only (duplicates, entity-type hints, normalization, payment-handle collisions). Do NOT use get_people bulk dumps for cleanup. ($0.10; API key required)

Parameters3

checks	array	optional
min_confidence	number	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "checks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "min_confidence": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

merge_people_preview

Save a durable restore snapshot without modifying contacts before merge_people. Returns resulting name/aliases, preserved counts, field conflicts, safe_to_merge. ($0.05; API key required)

Parameters5

primary_person_id	string	required
duplicate_person_ids	array	required
field_choices	object	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "primary_person_id": {
      "type": "string"
    },
    "duplicate_person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "field_choices": {
      "type": "object",
      "additionalProperties": true
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "primary_person_id",
    "duplicate_person_ids"
  ],
  "additionalProperties": false
}

undo_contact_change

Reverse a reversible contact_mutations row (rename, alias, identity, classify, link). For merges, pass restore_id as change_id within 30 days. Restore rejects later edits rather than overwriting them. ($0.10; API key required)

Parameters3

change_id	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "change_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "change_id"
  ],
  "additionalProperties": false
}

update_people_link

Patch an existing person↔person graph edge (type/context/source/confidence). ($0.10; API key required)

Parameters9

connection_id	string	optional
person_id	string	optional
other_person_id	string	optional
relationship_type	string	optional
notes	string	optional
source	string	optional
confidence	number	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "connection_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "other_person_id": {
      "type": "string"
    },
    "relationship_type": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

get_people_links

Alias of get_person_connections — list graph edges for one CRM person. ($0.05; API key required)

Parameters1

person_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

classify_contact

Set entity_type (person/company/merchant/…) on a CRM row without losing transactions or links. ($0.10; API key required)

Parameters8

entity_id	string	optional
person_id	string	optional
entity_type	string	required
identity_status	string	optional
confidence	number	optional
source	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "entity_type": {
      "type": "string"
    },
    "identity_status": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "source": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "entity_type"
  ],
  "additionalProperties": false
}

convert_contact_entity

Convert a contact’s entity_type (same as classify_contact). Preserves FKs. ($0.10; API key required)

Parameters5

entity_id	string	optional
person_id	string	optional
target_type	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "entity_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "target_type": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "target_type"
  ],
  "additionalProperties": false
}

find_identity_candidates

Compact identity resolution candidates by person_id or query (alias/name/payment signals). Prefer over bulk get_people. ($0.05; API key required)

Parameters3

person_id	string	optional
query	string	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

normalize_people_preview

Preview whitespace/phone/handle normalization changes (no title-case of stylized names). ($0.05; API key required)

Parameters3

rules	array	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

normalize_people_apply

Apply a normalize_people_preview by preview_id. ($0.10; API key required)

Parameters4

preview_id	string	required
candidate_hash	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "preview_id": {
      "type": "string"
    },
    "candidate_hash": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "preview_id",
    "candidate_hash",
    "request_id"
  ],
  "additionalProperties": false
}

start_people_cleanup

Server-side read-only cleanup audit. Returns a review queue; never automatically merges contacts. Use normalize_people_preview/apply for reversible normalization. ($0.15; API key required)

Parameters4

checks	array	optional
auto_merge_threshold	number	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "checks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "auto_merge_threshold": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

get_people_cleanup_result

Fetch start_people_cleanup result by cleanup_id. ($0.05; API key required)

Parameters1

cleanup_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "cleanup_id": {
      "type": "string"
    }
  },
  "required": [
    "cleanup_id"
  ],
  "additionalProperties": false
}

dismiss_clarification

Dismiss a pending entity clarification (not_person, etc.). ($0.05; API key required)

Parameters4

clarification_id	string	required
reason	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "clarification_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "clarification_id"
  ],
  "additionalProperties": false
}

resolve_clarification

Link a clarification surface to an existing person. ($0.10; API key required)

Parameters5

clarification_id	string	required
person_id	string	optional
person_name	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "clarification_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "person_name": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "clarification_id"
  ],
  "additionalProperties": false
}

bulk_dismiss_clarifications

Dismiss non-person / typed junk from the clarification queue. ($0.05; API key required)

Parameters4

reason	string	optional
entity_type	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "reason": {
      "type": "string"
    },
    "entity_type": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

link_entities

Link Trip→Stay→Place / Event→Person (graph, not prose). ($0.10; API key required)

Parameters8

from_type	string	required
from_id	string	required
to_type	string	required
to_id	string	required
link_type	string	optional
notes	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "from_type": {
      "type": "string"
    },
    "from_id": {
      "type": "string"
    },
    "to_type": {
      "type": "string"
    },
    "to_id": {
      "type": "string"
    },
    "link_type": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "from_type",
    "from_id",
    "to_type",
    "to_id"
  ],
  "additionalProperties": false
}

get_entity_links

List graph edges for an event, trip, place, or person. ($0.05; API key required)

Parameters2

entity_type	string	required
entity_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string"
    },
    "entity_id": {
      "type": "string"
    }
  },
  "required": [
    "entity_type",
    "entity_id"
  ],
  "additionalProperties": false
}

add_inventory_item

Add an owned object to Life Inventory. ($0.10; API key required)

Parameters3

name	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": true
}

get_inventory

Browse owned inventory with filters. ($0.10; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": true
}

get_inventory_item

Full item with valuations, people links, assets. ($0.10; API key required)

Parameters1

inventory_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    }
  },
  "required": [
    "inventory_id"
  ],
  "additionalProperties": false
}

update_inventory_item

PATCH semantics — unspecified fields untouched. ($0.10; API key required)

Parameters19

inventory_id	string	required
name	string	optional	What the user naturally calls the item.
category	string	optional	Broad type: clothing, instruments, electronics, …
subtype	string	optional	Specific subtype (sweatshirt, jacket, guitar). Alias: item_type.
item_type	string	optional	Alias for subtype.
brand	string	optional
model	string	optional
reference_number	string	optional
serial_number	string	optional
condition	string	optional
status	string	optional
location	string	optional
notes	string	optional
tags	array	optional	Replace tags array (sanitized against category mismatches).
subtype_confidence	number	optional	0–1 confidence when subtype is uncertain (agent_inferred).
estimated_value	number	optional
purchase_price	number	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "What the user naturally calls the item."
    },
    "category": {
      "type": "string",
      "description": "Broad type: clothing, instruments, electronics, …"
    },
    "subtype": {
      "type": "string",
      "description": "Specific subtype (sweatshirt, jacket, guitar). Alias: item_type."
    },
    "item_type": {
      "type": "string",
      "description": "Alias for subtype."
    },
    "brand": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "reference_number": {
      "type": "string"
    },
    "serial_number": {
      "type": "string"
    },
    "condition": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replace tags array (sanitized against category mismatches)."
    },
    "subtype_confidence": {
      "type": "number",
      "description": "0–1 confidence when subtype is uncertain (agent_inferred)."
    },
    "estimated_value": {
      "type": "number"
    },
    "purchase_price": {
      "type": "number"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "inventory_id"
  ],
  "additionalProperties": false
}

archive_inventory_item

Archive instead of destructive delete. ($0.10; API key required)

Parameters4

inventory_id	string	required
reason	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "inventory_id"
  ],
  "additionalProperties": false
}

search_inventory

Search owned inventory by name/brand/model/notes. Returns photo_count, has_photos, cover_url; when empty, photo_hint explains upload_asset linkage. ($0.10; API key required)

Parameters1

query

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

add_inventory_valuation

Append immutable valuation observation. ($0.10; API key required)

Parameters5

inventory_id	string	required
value	number	required
currency	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    },
    "value": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "inventory_id",
    "value"
  ],
  "additionalProperties": true
}

get_inventory_valuations

Chronological valuation history for an item. ($0.10; API key required)

Parameters1

inventory_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    }
  },
  "required": [
    "inventory_id"
  ],
  "additionalProperties": false
}

link_inventory_person

Provenance link e.g. inherited_from, gifted_by. ($0.10; API key required)

Parameters5

inventory_id	string	required
person_id	string	required
relationship	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "relationship": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "inventory_id",
    "person_id",
    "relationship"
  ],
  "additionalProperties": true
}

upload_asset

Upload image bytes to Dayze storage (WebP re-encode strips EXIF/AI metadata). Returns asset_id. For inventory item photos: pass entity_type=inventory, entity_id=inventory_id, role=photo, image_base64 from chat images. Or upload then attach_asset. ($0.15; API key required)

Parameters13

image_base64	string	optional
url	string	optional
filename	string	optional
mime_type	string	optional
asset_type	string	optional	photo \| receipt \| certificate \| document \| thumbnail \| …
role	string	optional	original \| cover \| thumbnail \| …
parent_asset_id	string	optional
entity_type	string	optional	inventory_item maps to inventory
entity_id	string	optional
description	string	optional
metadata	object	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "mime_type": {
      "type": "string"
    },
    "asset_type": {
      "type": "string",
      "description": "photo | receipt | certificate | document | thumbnail | …"
    },
    "role": {
      "type": "string",
      "enum": [
        "original",
        "processed",
        "thumbnail",
        "cover",
        "document",
        "receipt",
        "certificate",
        "photo",
        "other"
      ],
      "description": "original | cover | thumbnail | …"
    },
    "parent_asset_id": {
      "type": "string"
    },
    "entity_type": {
      "type": "string",
      "description": "inventory_item maps to inventory"
    },
    "entity_id": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": true
}

get_asset

Fetch one asset by asset_id with signed_url for download/processing. ($0.05; API key required)

Parameters2

asset_id	string	required
include_signed_url	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string"
    },
    "include_signed_url": {
      "type": "boolean"
    }
  },
  "required": [
    "asset_id"
  ],
  "additionalProperties": false
}

update_asset

Patch role, metadata, description, or parent_asset_id (e.g. mark as processed). ($0.08; API key required)

Parameters9

asset_id	string	required
role	string	optional	original \| cover \| thumbnail \| …
asset_type	string	optional
description	string	optional
filename	string	optional
parent_asset_id	string	optional
metadata	object	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string"
    },
    "role": {
      "type": "string",
      "enum": [
        "original",
        "processed",
        "thumbnail",
        "cover",
        "document",
        "receipt",
        "certificate",
        "photo",
        "other"
      ],
      "description": "original | cover | thumbnail | …"
    },
    "asset_type": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "filename": {
      "type": "string"
    },
    "parent_asset_id": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "asset_id"
  ],
  "additionalProperties": true
}

archive_asset

Soft-delete an asset (sets archived_at). Original rows are preserved for versioning. ($0.05; API key required)

Parameters3

asset_id	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "asset_id"
  ],
  "additionalProperties": false
}

upload_photo

Upload a photo to a Life Graph entity. Accepts image_base64 or url (one required). Re-encodes via WebP (strips EXIF/AI metadata). Person uploads also write the CRM gallery (person_photos) and avatar when set_as_avatar=true. ($0.15; API key required)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "entity_type": {
          "type": "string"
        },
        "entity_id": {
          "type": "string"
        },
        "content_type": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "set_as_avatar": {
          "type": "boolean"
        },
        "image_base64": {
          "type": "string",
          "description": "Base64 image bytes (optional data: URL prefix)."
        },
        "url": {
          "type": "string",
          "description": "Remote image URL to fetch and store."
        },
        "request_id": {
          "type": "string",
          "description": "Client idempotency key (retries return original result)."
        },
        "idempotency_key": {
          "type": "string",
          "description": "Alias for request_id."
        }
      },
      "required": [
        "entity_type",
        "entity_id",
        "image_base64"
      ],
      "additionalProperties": true
    },
    {
      "type": "object",
      "properties": {
        "entity_type": {
          "type": "string"
        },
        "entity_id": {
          "type": "string"
        },
        "content_type": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "set_as_avatar": {
          "type": "boolean"
        },
        "image_base64": {
          "type": "string",
          "description": "Base64 image bytes (optional data: URL prefix)."
        },
        "url": {
          "type": "string",
          "description": "Remote image URL to fetch and store."
        },
        "request_id": {
          "type": "string",
          "description": "Client idempotency key (retries return original result)."
        },
        "idempotency_key": {
          "type": "string",
          "description": "Alias for request_id."
        }
      },
      "required": [
        "entity_type",
        "entity_id",
        "url"
      ],
      "additionalProperties": true
    }
  ]
}

attach_asset

Parameters9

asset_id	string	optional
entity_type	string	required
entity_id	string	required
role	string	optional	original \| cover \| thumbnail \| …
asset_type	string	optional
url	string	optional
metadata	object	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string"
    },
    "entity_type": {
      "type": "string"
    },
    "entity_id": {
      "type": "string"
    },
    "role": {
      "type": "string",
      "enum": [
        "original",
        "processed",
        "thumbnail",
        "cover",
        "document",
        "receipt",
        "certificate",
        "photo",
        "other"
      ],
      "description": "original | cover | thumbnail | …"
    },
    "asset_type": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "entity_type",
    "entity_id"
  ],
  "additionalProperties": true
}

get_entity_assets

List assets linked to an entity (role, signed_url, versions). entity_type inventory_item → inventory. ($0.10; API key required)

Parameters3

entity_type	string	required
entity_id	string	required
asset_type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string"
    },
    "entity_id": {
      "type": "string"
    },
    "asset_type": {
      "type": "string"
    }
  },
  "required": [
    "entity_type",
    "entity_id"
  ],
  "additionalProperties": false
}

log_expense

Create an outgoing expense only. For money received (Venmo/Cash App/PayPal/Zelle) use log_transaction with direction=from and type=income. ($0.10; API key required)

Parameters9

amount	number	required
currency	string	optional
date	string	optional
merchant	string	optional	Payee name (defaults when omitted)
category	string	optional
notes	string	optional
description	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "merchant": {
      "type": "string",
      "description": "Payee name (defaults when omitted)"
    },
    "category": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": true
}

log_transaction

Income/expense/transfer write. direction=from + type=income for Venmo/Stripe/refunds received. Positive amount; external_id dedupes imports. Optional project/tags. Zelle always USD. Optional mirror_event creates a calendar Money · annotation (ledger is still the source of truth for /money). ($0.10; API key required)

Parameters19

account_id	string	optional	Stable provider account identity for imported payments.
message_id	string	optional
extractor_version	string	optional
amount	number	required
direction	string	required
type	string	optional
person_id	string	optional
date	string	optional
currency	string	optional
merchant	string	optional
notes	string	optional
source	string	optional
external_id	string	optional
payment_method	string	optional
mirror_event	boolean	optional	Also insert optional Money · calendar event (default false)
project	string	optional	Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture)
tags	array	optional	Optional tags. Prefer project: / ext: / rail: grammar.
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Stable provider account identity for imported payments."
    },
    "message_id": {
      "type": "string"
    },
    "extractor_version": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "direction": {
      "type": "string",
      "enum": [
        "from",
        "to"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "income",
        "expense",
        "transfer"
      ]
    },
    "person_id": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "merchant": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "external_id": {
      "type": "string"
    },
    "payment_method": {
      "type": "string"
    },
    "mirror_event": {
      "type": "boolean",
      "description": "Also insert optional Money · calendar event (default false)"
    },
    "project": {
      "type": "string",
      "description": "Venture/project label → stored as project:{slug} tag (e.g. Max Soko poker venture)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional tags. Prefer project: / ext: / rail: grammar."
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "amount",
    "direction"
  ],
  "additionalProperties": true
}

import_venmo_gmail

Search connected Gmail for Venmo receipts and write log_transaction rows with external_id=venmo-gmail-{gmail_id} (idempotent). Optional dry_run, max_results, query, mirror_event, account. Prefer this over calendar-only Money · digs. ($0.15; API key required)

Parameters8

query	string	optional	Override Gmail search (default from:venmo.com paid/payment)
max_results	number	optional
dry_run	boolean	optional
mirror_event	boolean	optional	Also create Money · calendar annotations
account	string	optional	Mailbox email or connection id
email	string	optional	Alias for account
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Override Gmail search (default from:venmo.com paid/payment)"
    },
    "max_results": {
      "type": "number"
    },
    "dry_run": {
      "type": "boolean"
    },
    "mirror_event": {
      "type": "boolean",
      "description": "Also create Money · calendar annotations"
    },
    "account": {
      "type": "string",
      "description": "Mailbox email or connection id"
    },
    "email": {
      "type": "string",
      "description": "Alias for account"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

import_uber_gmail

Search connected Gmail for Uber trip receipts and write log_place_visit rows with sources gmail:uber-{gmail_id} (idempotent). Optional dry_run, max_results, query, account. ($0.15; API key required)

Parameters7

query	string	optional	Override Gmail search (default from:uber.com receipt/trip)
max_results	number	optional
dry_run	boolean	optional
account	string	optional
email	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Override Gmail search (default from:uber.com receipt/trip)"
    },
    "max_results": {
      "type": "number"
    },
    "dry_run": {
      "type": "boolean"
    },
    "account": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "additionalProperties": false
}

log_income

Record money received (Stripe, refunds, payroll, Venmo). Alias of log_transaction with type=income and direction=from. Use external_id for Stripe/Gmail idempotency. ($0.10; API key required)

Parameters11

amount	number	required
date	string	optional
currency	string	optional
merchant	string	optional
notes	string	optional
source	string	optional
external_id	string	optional
payment_method	string	optional
person_id	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "date": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "merchant": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "external_id": {
      "type": "string"
    },
    "payment_method": {
      "type": "string"
    },
    "person_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": true
}

update_expense

PATCH an expense row. ($0.10; API key required)

Parameters15

expense_id	string	required
amount	number	optional
category	string	optional
merchant	string	optional
notes	string	optional
description	string	optional
date	string	optional	YYYY-MM-DD expense_date
currency	string	optional
payment_method	string	optional	e.g. venmo, cash, card
source	string	optional	Alias of payment_method
project	string	optional	Venture label → project:{slug} tag
tags	array	optional
external_id	string	optional	Optional; merges ext:{source}:{id} into tags
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "expense_id": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "category": {
      "type": "string"
    },
    "merchant": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD expense_date"
    },
    "currency": {
      "type": "string"
    },
    "payment_method": {
      "type": "string",
      "description": "e.g. venmo, cash, card"
    },
    "source": {
      "type": "string",
      "description": "Alias of payment_method"
    },
    "project": {
      "type": "string",
      "description": "Venture label → project:{slug} tag"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "external_id": {
      "type": "string",
      "description": "Optional; merges ext:{source}:{id} into tags"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "expense_id"
  ],
  "additionalProperties": false
}

record_purchase

Atomic expense + optional inventory item creation. ($0.10; API key required)

Parameters6

name	string	required
amount	number	required
currency	string	optional
date	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "name",
    "amount"
  ],
  "additionalProperties": true
}

record_sale

Mark inventory sold + record sale proceeds with gain/loss. ($0.10; API key required)

Parameters6

inventory_id	string	required
amount	number	required
currency	string	optional
sold_at	string	optional
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "inventory_id": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "sold_at": {
      "type": "string"
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "inventory_id",
    "amount"
  ],
  "additionalProperties": true
}

get_transactions

List expense/income/transfer rows (includes tags, payment_method). Filter with tag=project:… or project=… ($0.10; API key required)

Parameters8

cursor	string	optional	Continue the same immutable one-hour snapshot; other filters remain frozen.
include_archived	boolean	optional
from	string	optional
to	string	optional
type	string	optional
tag	string	optional	Exact tag, e.g. project:max-soko-poker-venture or rail:zelle
project	string	optional	Project label or slug → project:{slug}
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
    },
    "include_archived": {
      "type": "boolean"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "tag": {
      "type": "string",
      "description": "Exact tag, e.g. project:max-soko-poker-venture or rail:zelle"
    },
    "project": {
      "type": "string",
      "description": "Project label or slug → project:{slug}"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

search_transactions

Keyword search over merchant/description/category, or exact tag query (project:/ext:/rail:). ($0.10; API key required)

Parameters6

cursor	string	optional	Continue the same immutable one-hour snapshot; other filters remain frozen.
include_archived	boolean	optional
query	string	optional
tag	string	optional
project	string	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Continue the same immutable one-hour snapshot; other filters remain frozen."
    },
    "include_archived": {
      "type": "boolean"
    },
    "query": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "project": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

search_photos

Search person photos and entity assets by query/metadata. Returns inline MCP image attachments. ($0.10; API key required)

Parameters5

query	string	optional
from	string	optional
to	string	optional
person_ids	array	optional
place_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    },
    "person_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "place_id": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

get_photo

Single photo metadata + secure URL. Returns inline MCP image attachment when available. ($0.10; API key required)

Parameters1

photo_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "photo_id": {
      "type": "string"
    }
  },
  "required": [
    "photo_id"
  ],
  "additionalProperties": false
}

get_photos_for_event

Assets linked to an event. ($0.10; API key required)

Parameters1

event_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ],
  "additionalProperties": false
}

get_person_photos

Gallery image URLs for a CRM contact. Returns photos[{ id, url, is_primary, created_at }] plus inline MCP image attachments for chat render. Accepts person_id. ($0.10; API key required)

Parameters1

person_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string"
    }
  },
  "required": [
    "person_id"
  ],
  "additionalProperties": false
}

get_photos_for_place

Assets linked to a canonical place. ($0.10; API key required)

Parameters1

place_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string"
    }
  },
  "required": [
    "place_id"
  ],
  "additionalProperties": false
}

cleanup_preview

Read-only account audit and durable archive plan for events, expenses or trips. Returns source hashes, linked records, field differences, rollback payloads and a review queue. Review the exact candidate set before cleanup_apply. Preview expires after 30 minutes. ($0; API key required)

Parameters3

family	string	required
request_id	string	optional	Client idempotency key (retries return original result).
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "family": {
      "type": "string",
      "enum": [
        "events",
        "expenses",
        "trips"
      ]
    },
    "request_id": {
      "type": "string",
      "description": "Client idempotency key (retries return original result)."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "family"
  ],
  "additionalProperties": false
}

cleanup_apply

Atomically archive the exact reviewed preview. Requires preview_id, candidate_hash and request_id. Refuses changed sources. Returns per-row statuses and restore_id; replay performs no additional actions. ($0; API key required)

Parameters4

preview_id	string	required
candidate_hash	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "preview_id": {
      "type": "string"
    },
    "candidate_hash": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "preview_id",
    "candidate_hash",
    "request_id"
  ],
  "additionalProperties": false
}

archive_event

Reversibly archive one owned event; preserve linked data and return restore_id. Use a new request_id for each intended action. ($0; API key required)

Parameters4

event_id	string	required
reason	string	optional
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "event_id",
    "request_id"
  ],
  "additionalProperties": false
}

archive_expense

Reversibly archive one owned expense; preserve linked data and return restore_id. Use a new request_id for each intended action. ($0; API key required)

Parameters4

expense_id	string	required
reason	string	optional
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "expense_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "expense_id",
    "request_id"
  ],
  "additionalProperties": false
}

archive_trip

Reversibly archive one owned trip; preserve linked data and return restore_id. Use a new request_id for each intended action. ($0; API key required)

Parameters4

trip_id	string	required
reason	string	optional
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "trip_id",
    "request_id"
  ],
  "additionalProperties": false
}

restore_event

Restore an archive or normalization receipt. Requires restore_id and request_id. Refuses intervening edits; repeats are no-ops. ($0; API key required)

Parameters3

restore_id	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "restore_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "restore_id",
    "request_id"
  ],
  "additionalProperties": false
}

restore_expense

Restore an archive or normalization receipt. Requires restore_id and request_id. Refuses intervening edits; repeats are no-ops. ($0; API key required)

Parameters3

restore_id	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "restore_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "restore_id",
    "request_id"
  ],
  "additionalProperties": false
}

restore_trip

Restore an archive or normalization receipt. Requires restore_id and request_id. Refuses intervening edits; repeats are no-ops. ($0; API key required)

Parameters3

restore_id	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "restore_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "restore_id",
    "request_id"
  ],
  "additionalProperties": false
}

restore_cleanup

Restore an archive or normalization receipt. Requires restore_id and request_id. Refuses intervening edits; repeats are no-ops. ($0; API key required)

Parameters3

restore_id	string	required
request_id	string	required
idempotency_key	string	optional	Alias for request_id.

Raw schema

{
  "type": "object",
  "properties": {
    "restore_id": {
      "type": "string"
    },
    "request_id": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Alias for request_id."
    }
  },
  "required": [
    "restore_id",
    "request_id"
  ],
  "additionalProperties": false
}

README.md7 KBView on GitHub

Dayze MCP

Dayze gives connected AI tools Life Context: your people, plans and memories in a private, correctable record.

After you sign in, get_context_pack hands your AI the signed-in user's context (who matters, this week's plans, recent memories) over the Model Context Protocol (MCP). The public notable-people catalog (notable_*) is a separate feature and never touches your private record.

ChatGPT + iPhone first. Capture people, plans and moments in Dayze on your iPhone, then connect ChatGPT and ask about your own life. Cursor, Codex, Claude and other MCP clients use the same hosted endpoint.

Listed on LightNow: https://lightnow.ai/servers/com.dayze/life-context

Relationship intelligence

Dayze starts with the people in your life. Ask "When did I last see Maya, and what's next with her?" and your AI can:

Resolve the person — resolve_person / get_people against your private Dayze Contacts.
Show the linked moments — get_person_interactions returns the events, places and notes connected to that person.
Show the evidence — explain_fact returns the source behind a claim, so the answer is traceable rather than guessed.
Correct it — update_person, merge_people and the other write tools fix the record, so the next answer is right.

These four steps use the full endpoint (https://dayze.com/api/mcp). ChatGPT's compact profile is read-only: get_context_pack, get_people_context, get_events, search_dayze and related context reads, with corrections made in Dayze itself.

Connect ChatGPT

ChatGPT → Settings → Connectors → add a custom connector.
URL: https://dayze.com/api/mcp?tools_profile=compact
Click Connect and sign in to Dayze (OAuth). No API key.
Ask: "Use Dayze to pull my context pack for this week."

More detail: README-CHATGPT.md · https://dayze.com/docs/agents

Cursor / Grok Bot

This repo is a Cursor Plugin (v1.33.0): .cursor-plugin/plugin.json, skills/dayze-life-context/, URL-only root mcp.json, plus Codex/ChatGPT metadata in .codex-plugin/ and .mcp.json.

Dayze Contacts is the private CRM. Advertised MCP names stay get_people, create_person, update_person, resolve_person (stable). Call aliases get_contacts / create_contact / update_contact / resolve_contact work on the hosted server. Public People stays notable_*.

Cursor Marketplace: https://github.com/gohluke/dayze-mcp submitted 2026-09-19, in review (see PUBLISH.md). The ChatGPT custom connector works today; the ChatGPT Apps Directory listing is in review.

Until marketplace review lands, test locally:

bash

mkdir -p ~/.cursor/plugins/local
ln -s /path/to/dayze-mcp ~/.cursor/plugins/local/dayze

Reload Cursor (Developer: Reload Window), open Customize, and click Connect. Sign in to Dayze in the browser. Do not paste an API key — Cursor discovers OAuth from RFC 9728. Same Connect flow for Cursor desktop, Cursor web, and Grok Bot.

Docs: https://dayze.com/docs/agents


Website	https://dayze.com
Agents docs	https://dayze.com/docs/agents
Streamable HTTP	https://dayze.com/api/mcp
REST MCP	https://dayze.com/api/mcp
Discovery	https://dayze.com/.well-known/mcp.json
Server card	https://dayze.com/.well-known/mcp/server-card.json
OpenAPI	https://dayze.com/openapi.json
OAuth PRM	https://dayze.com/.well-known/oauth-protected-resource
OAuth AS	https://dayze.com/.well-known/oauth-authorization-server

Quick try

bash

# Streamable HTTP (JSON-RPC)
curl -X POST https://dayze.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

curl -X POST https://dayze.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# REST (compat)
curl https://dayze.com/api/mcp

curl -X POST https://dayze.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"tool":"notable_pack","parameters":{"slug":"albert-einstein"}}'

The last call uses the public notable-people catalog. Timeline events include day_number (e.g. Einstein’s Nobel = Day 15,580).

Auth

Private Life Context tools (get_context_pack, Contacts, events, memories): OAuth dayze_at_… (recommended) or Bearer dayze_k_…, scope context
Public notable_* tools: no login (see public tool pricing)
OAuth 2.1 + PKCE + DCR for ChatGPT / Claude / Gemini agents — see https://dayze.com/docs/agents

Transport

Streamable HTTP JSON-RPC at /api/mcp (initialize, tools/list, tools/call)
Compact ChatGPT profile at /api/mcp?tools_profile=compact (read-only subset)
REST MCP-compatible at /api/v1/mcp (GET capabilities, POST {tool, parameters})
GET /api/mcp returns discovery JSON (200); SSE sessions are not available on Netlify serverless

Glama install / Make Release

Dayze MCP is hosted at https://dayze.com/api/mcp. This repo ships a local stdio adapter (server.mjs) so Glama can build/scan without putting a URL in CMD (Glama rejects remote endpoints in CMD arguments).

Open https://glama.ai/mcp/servers/gohluke/dayze-mcp/admin/dockerfile
Build steps: ["npm install"]
CMD arguments: ["node", "./server.mjs"]
Click Build → wait for green → Build & Release (1.6.2)

If Glama keeps checking out an old commit, use build steps: ["git fetch origin && git checkout origin/main", "npm install"]

Prefer connecting clients directly to https://dayze.com/api/mcp (Streamable HTTP + OAuth).

Technical reference: public tool pricing

This applies only to the public notable-people catalog, not to your private Life Context.

Anonymous notable_* calls have a free tier. After it, the server may answer 402 Payment Required using x402 (USDC on Base).
Signed-in Dayze clients (OAuth or API key) skip that anonymous paywall.
Per-call list prices appear in each tool description (e.g. notable_search $0.01, notable_pack $0.05).
Payment recipient on x402scan: https://www.x402scan.com/recipient/0x4DeE3CDA6cb33b1f7A29dE1385B192F802AE3EDa/resources

License

Documentation and listing metadata in this repo: MIT. The Dayze product and API remain proprietary; this repo exists so directories can index a public GitHub URL.

Install

Tools (130)

notable_searchnotable_profilenotable_packnotable_pack_premiumcompare_livesget_life_contextget_context_packget_life_graph

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://dayze.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "life-context": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dayze.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.