Duskly

Whether a given edit to a real estate listing photo must be disclosed, and whether any market prohibits it outright. Use this before telling someone an edit is safe to publish. Returns Duskly's classification with the reasoning behind it, drawn from rulebooks read directly rather than summarised from secondary sources. Classifications: "disclosable" (permitted with disclosure), "ambiguous" (no rulebook names it explicitly; Duskly discloses by default), "prohibited" (one or more markets forbid it even with disclosure), "exempt". Note that "prohibited" means prohibited somewhere, not everywhere. Read carve_out when present.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "enum": [
        "day-to-dusk",
        "virtual-staging",
        "declutter",
        "occupied-to-vacant",
        "sky-replacement",
        "virtual-renovation"
      ],
      "description": "The edit being performed. One of: day-to-dusk, virtual-staging, declutter, occupied-to-vacant, sky-replacement, virtual-renovation."
    }
  },
  "required": [
    "task"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

The exact disclosure text to publish alongside an edited listing photo, written for each surface it has to appear on: the MLS photo description, public remarks, print, and the syndication feed. Surfaces have different character budgets, so the wording differs per surface rather than being one sentence repeated. Anything that exceeds its budget is reported in over_limit instead of being silently truncated. Supply original_url when the unaltered original is published somewhere, which California Bus. & Prof. Code §10140.8 requires for listings there. Supply required_string only when a jurisdiction mandates exact wording; it is then used verbatim and never paraphrased. The disclosure duty falls on the licensee publishing the listing, not on the software or the photographer. This generates the wording; a licensee publishes it.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "enum": [
        "day-to-dusk",
        "virtual-staging",
        "declutter",
        "occupied-to-vacant",
        "sky-replacement",
        "virtual-renovation"
      ],
      "description": "The edit being performed. One of: day-to-dusk, virtual-staging, declutter, occupied-to-vacant, sky-replacement, virtual-renovation."
    },
    "original_url": {
      "description": "Public URL where the unaltered original can be viewed, if one is published.",
      "type": "string",
      "format": "uri"
    },
    "required_string": {
      "description": "Exact wording a jurisdiction mandates. Used verbatim when supplied.",
      "type": "string",
      "maxLength": 300
    }
  },
  "required": [
    "task"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Edits that are prohibited outright in one or more markets and are never made acceptable by adding a disclosure. Use this when someone asks to remove, conceal or change something in a property photo and you need to know whether a label would make it acceptable. For these, it does not.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Every edit Duskly performs, with what it does and how it is classified for disclosure. Use this to pick the right edit for what someone is asking for, and to see in one call which ones carry compliance consequences.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Inspect an image for provenance signals: an invisible Duskly watermark, IPTC digital source type metadata, and whether a C2PA container appears present. Works on images Duskly did not produce. Read the result carefully before repeating it. This is a limited inspection report, not a certificate of authenticity or compliance. **The absence of a mark is not evidence that an image is a camera capture** — most AI editors write nothing at all, and Duskly's own paid downloads are deliberately unmarked. The C2PA field reports only that a container appears present: manifests are not parsed, signatures are not validated, and Duskly does not sign them. Prefer repeating the summary lines over paraphrasing individual fields.

{
  "type": "object",
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 1,
      "description": "Base64-encoded JPEG or PNG, up to 8MB decoded. A data: URL prefix is accepted and stripped."
    }
  },
  "required": [
    "image_base64"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Duskly's price and what a paid listing returns. Use this when someone asks what it costs or what they get. Editing is not available over MCP: renders spend model credit and require a browser session. Send the person to the URL in the response to do the work.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Returns the URL a person should open to upload listing photos and run an edit themselves. Use this when someone wants an edit performed. Editing is deliberately not callable over MCP: a render spends model credit and is gated behind a browser check that an automated client cannot pass. Hand the person the link rather than attempting the edit.

{
  "type": "object",
  "properties": {
    "task": {
      "description": "Preselects the edit on the page, when known.",
      "type": "string",
      "enum": [
        "day-to-dusk",
        "virtual-staging",
        "declutter",
        "occupied-to-vacant",
        "sky-replacement",
        "virtual-renovation"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

The state of a Duskly listing: how many photos it holds, which have been edited, whether it has been paid for, and how much of its render budget remains. Takes the listing id from the listing URL. Possession of that id is what authorises this, exactly as it does on the website. Use this before duskly_get_listing_pack to check whether a listing has been paid for.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "pattern": "^listing_[a-f0-9]+$",
      "description": "The listing id, the part of a Duskly listing URL after /listing/."
    }
  },
  "required": [
    "listing_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Everything a paid listing returns: the download link for the archive, the disclosure wording for every edited photo, and the public page showing the unaltered originals. Requires the listing to have been paid for. An unpaid listing returns the checkout URL instead, for a person to open. The disclosure wording is generated per photo and per publishing surface. The duty to publish it falls on the licensee publishing the listing, not on the software.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "pattern": "^listing_[a-f0-9]+$",
      "description": "The listing id, the part of a Duskly listing URL after /listing/."
    }
  },
  "required": [
    "listing_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

A Stripe Checkout URL for an unpaid listing, for a **person** to open and pay. Duskly does not take payment through MCP and no agent completes a purchase. Give this URL to the person you are working for; once they have paid, the listing is unlocked and duskly_get_listing_pack returns the deliverables. Returns an error for a listing that is already paid.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "pattern": "^listing_[a-f0-9]+$",
      "description": "The listing id, the part of a Duskly listing URL after /listing/."
    }
  },
  "required": [
    "listing_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}