Skip to main content
Glama

Dayze — Life Context

Upload Photo

upload_photo

Upload a photo to a Life Graph entity you have (event, expense, place, person, inventory, …). Accepts image_base64, url, or ChatGPT file object image ({download_url, file_id}). Normally re-encodes as WebP; original_preserved and metadata_stripped describe the saved bytes. Partial results include an asset_id for repair: call upload_photo with asset_id and a new request_id, without image bytes. Answers attached: true only after readback confirms asset id, content_type, byte_size, and a viewable URL on the record — never from OCR text alone. Mobile file references without download_url fail clearly (attached: false). Person uploads also write the CRM gallery (person_photos) and avatar when set_as_avatar=true. ($0.15; API key required)

Input Schema

NameRequiredDescriptionDefault
urlNoRemote image URL to fetch and store.
roleNooriginal | cover | thumbnail | receipt | … (photo is stored as original). set_as_avatar implies cover.
imageNoChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url.
titleNoPhoto title, e.g. Receipt from lunch.
file_idNoChatGPT file / attachment id from the chat file bridge (not a Dayze asset_id). Pair with image or a ChatGPT file-storage url.
asset_idNoRepair saved upload: new request_id, no image bytes.
filenameNoOriginal file name, e.g. receipt.jpg.
entity_idYesRecord id, e.g. 3f2a1b4c-8d9e-6f01-c2b3-c4d5e6f70809.
mime_typeNoAlias for content_type.
request_idNoClient idempotency key (retries return original result).
descriptionNoCaption for the photo, e.g. Receipt from lunch.
entity_typeYesType of the record the id refers to, e.g. event.
content_typeNoMIME type of the image, e.g. image/jpeg.
image_base64NoBase64 image bytes (optional data: URL prefix).
attachment_idNoAlias for file_id (ChatGPT attachment id).
set_as_avatarNoAlso use this photo as the contact avatar, e.g. true.
idempotency_keyNoAlias for request_id.

Output Schema

NameRequiredDescriptionDefault
urlNo
assetNo
accountNoThe Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.
messageNo
asset_idNo
attachedNo
photo_idNo
view_urlNo
byte_sizeNo
entity_idNo
optimizedNo
provenanceNoWhich connector wrote the record and which connected Dayze account received it.
entity_typeNo
content_typeNo
avatar_updatedNo
metadata_strippedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / properties / content_type / description
      Added value: +"MIME type of the image, e.g. image/jpeg."
    • addedInput schema / properties / description / description
      Added value: +"Caption for the photo, e.g. Receipt from lunch."
    • addedInput schema / properties / entity_id / description
      Added value: +"Record id, e.g. 3f2a1b4c-8d9e-6f01-c2b3-c4d5e6f70809."
    • addedInput schema / properties / entity_type / description
      Added value: +"Type of the record the id refers to, e.g. event."
    • addedInput schema / properties / filename / description
      Added value: +"Original file name, e.g. receipt.jpg."
    • addedInput schema / properties / set_as_avatar / description
      Added value: +"Also use this photo as the contact avatar, e.g. true."
    • addedInput schema / properties / title / description
      Added value: +"Photo title, e.g. Receipt from lunch."
  2. Changed3 schema fields changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "required": [
      -      "image_base64"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "url"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "image"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "asset_id"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "required": [
      +      "image_base64"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "image"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "asset_id"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "file_id",
      +      "url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "attachment_id",
      +      "url"
      +    ]
      +  }
      +]
    • addedInput schema / properties / attachment_id
      Added value: +{
      +  "description": "Alias for file_id (ChatGPT attachment id).",
      +  "type": "string"
      +}
    • addedInput schema / properties / file_id
      Added value: +{
      +  "description": "ChatGPT file / attachment id from the chat file bridge (not a Dayze asset_id). Pair with image or a ChatGPT file-storage url.",
      +  "type": "string"
      +}
  3. Changed2 schema fields changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "required": [
      -      "image_base64"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "url"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "image"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "required": [
      +      "image_base64"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "image"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "asset_id"
      +    ]
      +  }
      +]
    • addedInput schema / properties / asset_id
      Added value: +{
      +  "description": "Repair saved upload: new request_id, no image bytes.",
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • addedOutput schema / properties / account
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.",
      +  "properties": {
      +    "display_name": {
      +      "description": "Account display name.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "handle": {
      +      "description": "Account handle, e.g. @goh.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "note": {
      +      "description": "How to disclose the account to the user.",
      +      "type": "string"
      +    },
      +    "qa_fixture": {
      +      "description": "True for a known QA test account: its records are fixture data, not a real life.",
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "handle",
      +    "display_name",
      +    "qa_fixture",
      +    "note"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / provenance
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Which connector wrote the record and which connected Dayze account received it.",
      +  "properties": {
      +    "account": {
      +      "additionalProperties": false,
      +      "description": "The Dayze account this data belongs to. With more than one Dayze connection, name it in the answer.",
      +      "properties": {
      +        "display_name": {
      +          "description": "Account display name.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "handle": {
      +          "description": "Account handle, e.g. @goh.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "note": {
      +          "description": "How to disclose the account to the user.",
      +          "type": "string"
      +        },
      +        "qa_fixture": {
      +          "description": "True for a known QA test account: its records are fixture data, not a real life.",
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "handle",
      +        "display_name",
      +        "qa_fixture",
      +        "note"
      +      ],
      +      "type": "object"
      +    },
      +    "channel": {
      +      "description": "Always mcp_connector.",
      +      "type": "string"
      +    },
      +    "connector": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "kind": {
      +          "description": "oauth or api_key.",
      +          "type": "string"
      +        },
      +        "name": {
      +          "description": "The connected app or API-key label shown to the account owner.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "kind",
      +        "name"
      +      ],
      +      "type": "object"
      +    },
      +    "source": {
      +      "description": "chatgpt for ChatGPT OAuth writes; mcp for another OAuth app or API key.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "source",
      +    "channel",
      +    "connector",
      +    "account"
      +  ],
      +  "type": "object"
      +}
  5. Changed6 schema fields changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "required": [
      -      "image_base64"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "url"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "required": [
      +      "image_base64"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "image"
      +    ]
      +  }
      +]
    • addedInput schema / properties / image
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "ChatGPT chat attachment. Prefer this for images from the conversation; API clients may still use image_base64 or url.",
      +  "properties": {
      +    "download_url": {
      +      "description": "Temporary HTTPS URL ChatGPT provides for this file.",
      +      "type": "string"
      +    },
      +    "file_id": {
      +      "description": "ChatGPT file id (not a Dayze asset_id).",
      +      "type": "string"
      +    },
      +    "file_name": {
      +      "description": "Optional original filename from ChatGPT.",
      +      "type": "string"
      +    },
      +    "mime_type": {
      +      "description": "Optional MIME type from ChatGPT.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "download_url",
      +    "file_id"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / role / description
      Previous value: -"original | cover | thumbnail | … (photo is stored as original). set_as_avatar implies cover."New value: +"original | cover | thumbnail | receipt | … (photo is stored as original). set_as_avatar implies cover."
    • addedOutput schema / properties / byte_size
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / content_type
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / view_url
      Added value: +{
      +  "type": "string"
      +}
  6. Changed4 schema fields changed
    • changedInput schema / additionalProperties
      Previous value: -trueNew value: +false
    • addedInput schema / properties / filename
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / mime_type
      Added value: +{
      +  "description": "Alias for content_type.",
      +  "type": "string"
      +}
    • addedInput schema / properties / role
      Added value: +{
      +  "description": "original | cover | thumbnail | … (photo is stored as original). set_as_avatar implies cover.",
      +  "type": "string"
      +}
  7. Changed3 schema fields changed
    • addedOutput schema / properties / attached
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / entity_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / entity_type
      Added value: +{
      +  "type": "string"
      +}
  8. Changed4 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +true
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "content_type": {
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "entity_id": {
      -        "type": "string"
      -      },
      -      "entity_type": {
      -        "type": "string"
      -      },
      -      "idempotency_key": {
      -        "description": "Alias for request_id.",
      -        "type": "string"
      -      },
      -      "image_base64": {
      -        "description": "Base64 image bytes (optional data: URL prefix).",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "description": "Client idempotency key (retries return original result).",
      -        "type": "string"
      -      },
      -      "set_as_avatar": {
      -        "type": "boolean"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "description": "Remote image URL to fetch and store.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "entity_type",
      -      "entity_id",
      -      "image_base64"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "content_type": {
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "entity_id": {
      -        "type": "string"
      -      },
      -      "entity_type": {
      -        "type": "string"
      -      },
      -      "idempotency_key": {
      -        "description": "Alias for request_id.",
      -        "type": "string"
      -      },
      -      "image_base64": {
      -        "description": "Base64 image bytes (optional data: URL prefix).",
      -        "type": "string"
      -      },
      -      "request_id": {
      -        "description": "Client idempotency key (retries return original result).",
      -        "type": "string"
      -      },
      -      "set_as_avatar": {
      -        "type": "boolean"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "description": "Remote image URL to fetch and store.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "entity_type",
      -      "entity_id",
      -      "url"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "required": [
      +      "image_base64"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "url"
      +    ]
      +  }
      +]
    • addedInput schema / properties
      Added value: +{
      +  "content_type": {
      +    "type": "string"
      +  },
      +  "description": {
      +    "type": "string"
      +  },
      +  "entity_id": {
      +    "type": "string"
      +  },
      +  "entity_type": {
      +    "type": "string"
      +  },
      +  "idempotency_key": {
      +    "description": "Alias for request_id.",
      +    "type": "string"
      +  },
      +  "image_base64": {
      +    "description": "Base64 image bytes (optional data: URL prefix).",
      +    "type": "string"
      +  },
      +  "request_id": {
      +    "description": "Client idempotency key (retries return original result).",
      +    "type": "string"
      +  },
      +  "set_as_avatar": {
      +    "type": "boolean"
      +  },
      +  "title": {
      +    "type": "string"
      +  },
      +  "url": {
      +    "description": "Remote image URL to fetch and store.",
      +    "type": "string"
      +  }
      +}
    • addedInput schema / required
      Added value: +[
      +  "entity_type",
      +  "entity_id"
      +]
  9. Changed1 schema field changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "content_type": {
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "entity_id": {
      -        "type": "string"
      -      },
      -      "entity_type": {
      -        "type": "string"
      -      },
      -      "image_base64": {
      -        "description": "Base64 image bytes (optional data: URL prefix).",
      -        "type": "string"
      -      },
      -      "set_as_avatar": {
      -        "type": "boolean"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "description": "Remote image URL to fetch and store.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "entity_type",
      -      "entity_id",
      -      "image_base64"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "content_type": {
      -        "type": "string"
      -      },
      -      "description": {
      -        "type": "string"
      -      },
      -      "entity_id": {
      -        "type": "string"
      -      },
      -      "entity_type": {
      -        "type": "string"
      -      },
      -      "image_base64": {
      -        "description": "Base64 image bytes (optional data: URL prefix).",
      -        "type": "string"
      -      },
      -      "set_as_avatar": {
      -        "type": "boolean"
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "url": {
      -        "description": "Remote image URL to fetch and store.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "entity_type",
      -      "entity_id",
      -      "url"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "content_type": {
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "entity_id": {
      +        "type": "string"
      +      },
      +      "entity_type": {
      +        "type": "string"
      +      },
      +      "idempotency_key": {
      +        "description": "Alias for request_id.",
      +        "type": "string"
      +      },
      +      "image_base64": {
      +        "description": "Base64 image bytes (optional data: URL prefix).",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "description": "Client idempotency key (retries return original result).",
      +        "type": "string"
      +      },
      +      "set_as_avatar": {
      +        "type": "boolean"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Remote image URL to fetch and store.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "entity_type",
      +      "entity_id",
      +      "image_base64"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "content_type": {
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "entity_id": {
      +        "type": "string"
      +      },
      +      "entity_type": {
      +        "type": "string"
      +      },
      +      "idempotency_key": {
      +        "description": "Alias for request_id.",
      +        "type": "string"
      +      },
      +      "image_base64": {
      +        "description": "Base64 image bytes (optional data: URL prefix).",
      +        "type": "string"
      +      },
      +      "request_id": {
      +        "description": "Client idempotency key (retries return original result).",
      +        "type": "string"
      +      },
      +      "set_as_avatar": {
      +        "type": "boolean"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Remote image URL to fetch and store.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "entity_type",
      +      "entity_id",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
  10. Changed3 schema fields changed
    • addedOutput schema / properties / asset
      Added value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
    • addedOutput schema / properties / asset_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / avatar_updated
      Added value: +{
      +  "type": "boolean"
      +}
  11. Changed4 schema fields changed
    • removedInput schema / additionalProperties
      Removed value: -true
    • addedInput schema / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "content_type": {
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "entity_id": {
      +        "type": "string"
      +      },
      +      "entity_type": {
      +        "type": "string"
      +      },
      +      "image_base64": {
      +        "description": "Base64 image bytes (optional data: URL prefix).",
      +        "type": "string"
      +      },
      +      "set_as_avatar": {
      +        "type": "boolean"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Remote image URL to fetch and store.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "entity_type",
      +      "entity_id",
      +      "image_base64"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "content_type": {
      +        "type": "string"
      +      },
      +      "description": {
      +        "type": "string"
      +      },
      +      "entity_id": {
      +        "type": "string"
      +      },
      +      "entity_type": {
      +        "type": "string"
      +      },
      +      "image_base64": {
      +        "description": "Base64 image bytes (optional data: URL prefix).",
      +        "type": "string"
      +      },
      +      "set_as_avatar": {
      +        "type": "boolean"
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Remote image URL to fetch and store.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "entity_type",
      +      "entity_id",
      +      "url"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties
      Removed value: -{
      -  "content_type": {
      -    "type": "string"
      -  },
      -  "description": {
      -    "type": "string"
      -  },
      -  "entity_id": {
      -    "type": "string"
      -  },
      -  "entity_type": {
      -    "type": "string"
      -  },
      -  "image_base64": {
      -    "description": "Base64 image bytes (optional data: URL prefix)",
      -    "type": "string"
      -  },
      -  "set_as_avatar": {
      -    "type": "boolean"
      -  },
      -  "title": {
      -    "type": "string"
      -  },
      -  "url": {
      -    "description": "Remote image URL to fetch, optimize, and store",
      -    "type": "string"
      -  }
      -}
    • removedInput schema / required
      Removed value: -[
      -  "entity_type",
      -  "entity_id"
      -]
  12. Added

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses behavior far beyond the annotations: re-encoding to WebP, the original_preserved/metadata_stripped contract, the verification rule that attached:true requires readback of asset id, content_type, byte_size and a viewable URL, partial-result recovery via asset_id, failure mode for mobile file references, side effects on person_photos/avatar, plus cost ($0.15) and API key requirement. Nothing here contradicts readOnlyHint=false, destructiveHint=false, or openWorldHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then progressively narrower operational detail; nearly every clause carries distinct information, including the readback guarantee and the repair loop. It is dense and semicolon-heavy, bordering on run-on, which costs a little readability but not accuracy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 17-parameter tool with nested objects, an output schema, and annotations already present, the description covers everything an agent needs: accepted input forms, exclusivity of alternatives, failure conditions, side effects, cost, and verification semantics. The return-value contract is delegated appropriately to the existing output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description adds cross-parameter meaning the schema cannot express: the four accepted input modes (image_base64, url, ChatGPT image object, asset_id repair) and the rule that asset_id must be sent without image bytes. It adds less to the auxiliary fields such as role, title, and request_id, which are left to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening states a specific verb and resource — 'Upload a photo to a Life Graph entity' — and enumerates the entity types (event, expense, place, person, inventory), so the agent immediately knows the target scope. It never names upload_asset or attach_food_photo, so the boundary against the closest siblings is left implicit rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear operational routing is given for the non-obvious paths: repair mode ('call upload_photo with asset_id and a new request_id, without image bytes'), conversation-originated files, and person uploads with set_as_avatar. It stops short of saying when to pick this over upload_asset or attach_food_photo, which is the main guidance gap.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.