vedutum_add_solar

Lays out photovoltaic modules (or solar thermal collectors) on every roof face of the model that does not face north, with edge margins, as rows on racks on a flat roof; returns module count, area and rated power in kWp. Or removes them. Replaces an earlier layout on those faces; vedutum_undo_last_change goes back. A layout, not a yield forecast. Costs no points.

destructive

Argument	Type	Description
kind	string	"pv" photovoltaics (default) or "thermal" collectors
remove	boolean	True removes all modules instead
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it
flat_roof_layout	string	Flat roof only: racks facing south (default) or east-west

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "pv",
        "thermal"
      ],
      "type": "string",
      "description": "\"pv\" photovoltaics (default) or \"thermal\" collectors"
    },
    "remove": {
      "type": "boolean",
      "description": "True removes all modules instead"
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    },
    "flat_roof_layout": {
      "enum": [
        "south",
        "eastWest"
      ],
      "type": "string",
      "description": "Flat roof only: racks facing south (default) or east-west"
    }
  }
}

vedutum_check_floor_plan

Checks a floor plan file against VEDUTUM’s upload rules before anyone uploads it: file type, size, pages, scan or vector, scale, title block. Use when someone asks which format to export from CAD (Archicad, Revit, AutoCAD, Vectorworks) or whether a scan or photo of a plan works. Nothing is uploaded.

read-only

Argument	Type	Description
pages	integer	Number of pages (PDF)
size_mb	number	File size in megabytes
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
file_type*	string	File extension, e.g. "pdf", "jpg", "dwg", "ifc"
has_dimensions	boolean	True if the plan shows at least one dimension line or a scale bar
scanned_or_photo	boolean	True if the plan is a scan or a photo rather than a CAD export
title_block_with_names	boolean	True if a title block with names or an address is on the page

Input schema (JSON)

vedutum_create_project

Creates a new, empty project in the connected account, optionally with the client and the site address (looked up for sun and surroundings). Returns its id and the link where the floor plan can be uploaded. Costs no points.

Argument	Type	Description
title*	string	Project name, e.g. "Haus Berger" or "Wohnanlage Lindenweg"
address	string	Site address, optional, e.g. "Lindenweg 7, 8010 Graz"
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
client_name	string	Client or owner, optional

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Project name, e.g. \"Haus Berger\" or \"Wohnanlage Lindenweg\""
    },
    "address": {
      "type": "string",
      "maxLength": 200,
      "description": "Site address, optional, e.g. \"Lindenweg 7, 8010 Graz\""
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "client_name": {
      "type": "string",
      "maxLength": 120,
      "description": "Client or owner, optional"
    }
  }
}

vedutum_estimate_points

Counts the points VEDUTUM needs for a job: reading a floor plan (per storey), an optional check run, images and 8-second videos in three quality levels (hd ≈ 1,024 px, praesentation ≈ 2,048 px, druck ≈ 4,096 px). Use when someone asks what a set of renderings or videos takes. Returns points only, with a breakdown; the 3D model, share page and exports need none.

read-only

Argument	Type	Description
storeys	integer	Number of storeys to read from the floor plans, e.g. 2
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
check_run	boolean	Also run the automatic check of each storey
images_2k	integer	Images in 2K (presentation)
images_4k	integer	Images in 4K (print)
images_hd	integer	Images in HD (draft)
videos_2k	integer	8-second videos in 2K
videos_4k	integer	8-second videos in 4K

vedutum_example_project

Returns VEDUTUM’s example project „Haus Lindenweg“ (a fictional study): the share page a client receives, a step-by-step demo and five pictures from plan to finished visualisation, with captions. Use when someone wants to see what the result looks like.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    }
  }
}

vedutum_furnish_rooms

Places furniture in the rooms of a project’s model the way a planner would: by room type (living, kitchen, bedroom, bath, office, meeting…), clear of doors and windows, with 90 cm passages. One room by name or every room of a storey or of the house; "add" fills only empty rooms, "replace" furnishes anew. Changes the model; vedutum_undo_last_change takes it back. Costs no points.

destructive

Argument	Type	Description
mode	string	"add" (default) leaves furnished rooms as they are; "replace" removes their furniture first
room	string	Only this room, by its name on the plan, e.g. "Wohnen" or "Kind 1"
storey	integer	Only this storey (0 = ground floor); default every read storey
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
terraces	boolean	Also set out the ground floor terraces (default true when furnishing a whole storey)
project_id*	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "mode": {
      "enum": [
        "add",
        "replace"
      ],
      "type": "string",
      "description": "\"add\" (default) leaves furnished rooms as they are; \"replace\" removes their furniture first"
    },
    "room": {
      "type": "string",
      "maxLength": 80,
      "description": "Only this room, by its name on the plan, e.g. \"Wohnen\" or \"Kind 1\""
    },
    "storey": {
      "type": "integer",
      "maximum": 5,
      "minimum": 0,
      "description": "Only this storey (0 = ground floor); default every read storey"
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "terraces": {
      "type": "boolean",
      "description": "Also set out the ground floor terraces (default true when furnishing a whole storey)"
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_get_project

Returns one project of the connected account: the state of each floor plan reading (also while it runs), storeys, rooms with their approximate areas, outline area per storey and in total, windows and doors, roof, facade and style, solar modules, surroundings, share link and approval, number of images, and the link into the app. Use after vedutum_read_floor_plan to see the result, and for questions about areas or rooms.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_get_started

Returns the links to open an account or sign in and the four steps from floor plan to share page. Use when someone wants to try it with their own plan. Creates nothing.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    }
  }
}

vedutum_list_projects

Lists the projects in the connected VEDUTUM account with id, client, whether the floor plan has been read, last change, and the points left. Use first when the person talks about one of their projects, to find its id.

read-only

Argument	Type	Description
limit	integer	Number of projects, default 20, newest change first
status	string	Which projects: "active" (default), "archived" or "all"
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Number of projects, default 20, newest change first"
    },
    "status": {
      "enum": [
        "active",
        "archived",
        "all"
      ],
      "type": "string",
      "description": "Which projects: \"active\" (default), \"archived\" or \"all\""
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    }
  }
}

vedutum_model_geometry

Returns the plan geometry (walls, openings, rooms, furniture, roof and facade settings) that the VEDUTUM 3D view draws. Used by the view itself.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_print_resolution

Converts a print size (cm) and dpi, or a pixel width, into the pixels needed on the long edge and the fitting quality level, with the largest print each level allows at 300 and 150 dpi. Use for brochures, boards, site hoardings, websites.

read-only

Argument	Type	Description
dpi	number	Print resolution, default 300
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
width_cm	number	Print width in centimetres
height_cm	number	Print height in centimetres
long_edge_px	number	Or: pixels needed on the long edge, e.g. 1920

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dpi": {
      "type": "number",
      "maximum": 1200,
      "minimum": 30,
      "description": "Print resolution, default 300"
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "width_cm": {
      "type": "number",
      "maximum": 2000,
      "minimum": 0,
      "description": "Print width in centimetres"
    },
    "height_cm": {
      "type": "number",
      "maximum": 2000,
      "minimum": 0,
      "description": "Print height in centimetres"
    },
    "long_edge_px": {
      "type": "number",
      "maximum": 20000,
      "minimum": 0,
      "description": "Or: pixels needed on the long edge, e.g. 1920"
    }
  }
}

vedutum_read_floor_plan

Loads a floor plan from a public https link (PDF, JPG, PNG or WebP, up to 15 MB, one storey per sheet) into a project of the connected account and starts reading walls, openings and rooms into a measured model. Costs 1 point per storey from the account, as in the app; refuses with the reason when points or the free month have run out. Reading runs one to three minutes; check the result with vedutum_get_project. For a file on the person’s computer, give them the upload link from vedutum_get_project instead.

Argument	Type	Description
hint	string	Optional note for the reading, e.g. "the overall width is 12.40 m"
label	string	Name of the sheet, e.g. "EG 1:100"
storey	integer	Which storey the sheet shows: 0 ground floor (default), 1 first floor, -1 basement
file_url*	string	Direct https link to the plan file (not a preview page), e.g. a download link
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "file_url"
  ],
  "properties": {
    "hint": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional note for the reading, e.g. \"the overall width is 12.40 m\""
    },
    "label": {
      "type": "string",
      "maxLength": 120,
      "description": "Name of the sheet, e.g. \"EG 1:100\""
    },
    "storey": {
      "type": "integer",
      "maximum": 5,
      "minimum": -1,
      "description": "Which storey the sheet shows: 0 ground floor (default), 1 first floor, -1 basement"
    },
    "file_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "Direct https link to the plan file (not a preview page), e.g. a download link"
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_search_knowledge

Searches VEDUTUM’s published articles, service pages and feature documentation (German or English) and returns titles, short answers and links. Use for questions about architectural visualisation: floor plan to 3D, rendering costs and resolutions, IFC and CAD formats, sign-off with clients, AI labelling of images.

read-only

Argument	Type	Description
limit	integer	Number of results, default 5
query*	string	Search words, e.g. "Grundriss in 3D umwandeln" or "rendering resolution print"
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Number of results, default 5"
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Search words, e.g. \"Grundriss in 3D umwandeln\" or \"rendering resolution print\""
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    }
  }
}

vedutum_set_design

Changes the design settings of a project’s model: roof shape, facade material, window frames, building style, roof covering, number and height of storeys, north direction. Only the values given change. The model and every later image use them. vedutum_undo_last_change goes back. Costs no points.

destructive

Argument	Type	Description
roof	string	flat, gable (Satteldach) or shed (Pultdach)
frame	string	Window frames: anthracite, white, oak, bronze, black
style	string	modern, klassisch, gruenderzeit, laendlich, alpin, mediterran, skandinavisch, bauhaus
facade	string	render (white), renderGrey, larch (light timber), larchDark, brick, brickLight, concrete, metal
storeys	integer	Storeys above ground; storeys without their own plan repeat the ground floor
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it
roof_cover	string

vedutum_set_site_address

Sets the address of a project’s building site: looks it up on OpenStreetMap for sun position and shadows, and loads neighbouring buildings, roads and terrain around it into the model (OpenStreetMap, EU-DEM; takes about a minute, then visible in vedutum_get_project). Replaces the previous address; vedutum_undo_last_change goes back. Costs no points.

destructive

Argument	Type	Description
address*	string	Street address with postcode and town, e.g. "Lindenweg 7, 8010 Graz"
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it
surroundings	boolean	Also load neighbouring buildings and terrain (default true)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id",
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 200,
      "minLength": 3,
      "description": "Street address with postcode and town, e.g. \"Lindenweg 7, 8010 Graz\""
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    },
    "surroundings": {
      "type": "boolean",
      "description": "Also load neighbouring buildings and terrain (default true)"
    }
  }
}

vedutum_share_link

Returns the share link of a project (creating it the first time): the page where a client sees the model and the images, comments and approves, without an account. Also says how often it was opened and whether it was approved.

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_sun_and_shadow

Sun azimuth and elevation, shadow length per metre of building height and shadow direction for a building site on a given day and local times (Central European time), plus sunrise and sunset. Use for orientation, terrace or window planning and quick shadow questions. Looks the site up by town or address via OpenStreetMap. A study on flat ground without neighbouring buildings, not a legal shadow certificate.

read-only

Argument	Type	Description
date*	string	Day as YYYY-MM-DD, e.g. "2026-12-21"
site*	string	Town, postcode or street address of the building site, e.g. "8010 Graz" or "Lindenweg 7, Linz"
times	array	Local times as HH:MM, e.g. ["09:00","12:00","15:00"]. Default 09:00, 12:00, 15:00, 18:00
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
building_height_m	number	Height of the building or wall in metres, to give shadow lengths in metres

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Day as YYYY-MM-DD, e.g. \"2026-12-21\""
    },
    "site": {
      "type": "string",
      "maxLength": 160,
      "minLength": 2,
      "description": "Town, postcode or street address of the building site, e.g. \"8010 Graz\" or \"Lindenweg 7, Linz\""
    },
    "times": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 12,
      "description": "Local times as HH:MM, e.g. [\"09:00\",\"12:00\",\"15:00\"]. Default 09:00, 12:00, 15:00, 18:00"
    },
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "building_height_m": {
      "type": "number",
      "maximum": 300,
      "minimum": 0,
      "description": "Height of the building or wall in metres, to give shadow lengths in metres"
    }
  }
}

vedutum_undo_last_change

Restores a project to the state before the last change made with vedutum_furnish_rooms, vedutum_set_design, vedutum_add_solar or vedutum_set_site_address. One step; changes made in the app are not touched.

destructive

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id*	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "project_id"
  ],
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

vedutum_view_model

Shows a building model in 3D inside the conversation: turn it, look at single storeys or a cut-away view. Without project_id it shows VEDUTUM’s example house „Haus Lindenweg“ (no account needed); with project_id a project of the connected account. Returns a short summary for clients without the view.

read-only

Argument	Type	Description
language	string	Language of the answer: "de" (German) or "en" (English). Default "de".
project_id	any	Project id, as vedutum_list_projects returns it

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "language": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "description": "Language of the answer: \"de\" (German) or \"en\" (English). Default \"de\"."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "maxLength": 40,
          "minLength": 1
        }
      ],
      "description": "Project id, as vedutum_list_projects returns it"
    }
  }
}

VEDUTUM

Try it

vedutum_add_solar Destructive

VEDUTUM

Try it

vedutum_add_solar Destructive

Tools (19)