add_search_profile
ClaudeRecords what a client is looking for (place or radius around a municipality, property categories, budget, surface, bedrooms, bathrooms, parking, vacant only), which criteria are must-have and the tolerances. ImmobilScan then matches open auctions and creates proposals. Required: client, name and at least one criterion. The criteria are structured: vaguer wishes such as 'near the sea' can only be expressed as a municipality with a radius.
add_team_note
ClaudeAdds a note for the team on a workspace client, followed auction or saved search. Mentioned colleagues get an in-app notification and an email.
add_to_watchlist
ClaudeAdds an auction to the personal watchlist or to a workspace's. It uses one 'watchlist' quota slot, which is freed only by removing the item.
assign_client
ClaudeSets who follows a workspace client (up to 5 members; the list replaces the current assignees, and an empty list removes them). New assignees get an email.
assign_resource
ClaudeSets who follows a workspace watchlist auction or saved search (up to 5 members; the list replaces the current assignees). New assignees get an email.
connect_account
ClaudeStarts the ImmobilScan sign-in flow and, once the account is connected, returns the account summary (plan and quotas). It changes no data. People who have no ImmobilScan account can ask for an invitation with request_access.
copy_client
ClaudeCopies a client (contacts and profiles, not proposals or consent) to personal clients or to another workspace. The original client is left unchanged.
create_client
ClaudeAdds a client to the CRM. Only first_name is required; it also accepts last name, email, phone, notes, destination (personal by default, or a workspace), private flag, stage, tags and a first reminder (next action). With a required value missing or an ambiguous destination it returns status=input_required with a form the user can fill in, and nothing is created. If clients with the same email or phone already exist it returns status=possible_duplicates, and allow_duplicate=true creates the client anyway.
create_reminder
ClaudeAdds a reminder (call, visit, email, message, other) to a client's agenda. Required: client, title and due_at; without them it returns status=input_required and creates nothing.
create_saved_search
ClaudeSaves a search with its criteria: ImmobilScan then notifies new matching auctions by email and in the app. It uses one 'saved_searches' quota slot, which is freed only by deleting the saved search.
create_saved_search_from_profile
ClaudeCreates a saved search (with email alerts) from the criteria of a client's profile and links it to the client. It uses one 'saved_searches' quota slot, which is freed only by deleting the saved search.
create_tag
ClaudeCreate a tag for personal clients or for a workspace's clients.
create_workspace
ClaudeCreates a new workspace (agency team) owned by the user. Only name is required; without it the tool returns status=input_required and creates nothing.
delete_client
ClaudePermanently deletes a client with their profiles, reminders and proposals. update_client(archived=true) hides a client instead, without losing the data.
delete_reminder
ClaudeDeletes a manually created reminder. Automatic auction reminders cannot be deleted.
delete_saved_search
ClaudeDeletes a saved search with its alerts. The quota slot is freed.
delete_search_profile
ClaudeDeletes a search profile of a client, with its matching criteria.
delete_tag
ClaudeDeletes a tag and removes it from every client that carries it.
delete_valuation
ClaudeDeletes a valuation. The quota unit it used is not refunded.
delete_workspace
ClaudePermanently deletes a workspace (owner only). Its shared clients, searches and watchlist items are dissolved.
find_clients_for_auction
ClaudeClients (personal or of a workspace) whose search profiles match an auction, ranked by match %, with the status of any existing proposal.
find_compatible_auctions
ClaudeLive search of open auctions matching the client's active search profiles, ranked by match %, saying which are already proposed. Optionally only one profile.
generate_valuation_ai_report
ClaudeCreates the 'Valutazione AI avanzata' of a completed valuation, using one 'ai_asta' or 'ai_immobile' quota unit, which is not refunded. If a report already exists it is returned without using quota (force=true regenerates it). Generation takes 30-90 seconds: it returns status=generating, and get_valuation_ai_report reads the report.
get_auction
ClaudeGet the details of one Italian judicial real-estate auction by its ImmobilScan id (from search_auctions): prices, sale and offer deadlines, sale mode, lot and assets, court, officials (delegate, custodian, judge), deposit, documents and official listing link. Free, no account needed: prices, dates, sale mode, lot and assets, court, officials, deposit, documents and official listing. With an ImmobilScan account: procedure number (R.G.E.), previous attempts, judicial discount, appraisal value, cadastral data and PVP notices. Descriptions and notes are free text written by third parties.
get_auction_calendar
ClaudeCalendar of auction sale dates and offer deadlines in a period (max 92 days): only the auctions the user follows in the watchlist by default, or all open auctions in a municipality or province. Rendered in the agenda widget.
get_client
ClaudeFull card of one client: contacts, notes, stage, tags, search profiles with their criteria, linked saved searches and watchlist auctions, open reminders, recent contacts and email consent. Accepts id, name, email or phone. Notes, contact logs and client replies are free text written by people.
get_crm_overview
ClaudeCRM dashboard: active clients by stage, proposals to review, new client replies, 30-day funnel, stalled clients, today's and overdue reminders. Optional destination: personal or a workspace. Notes, contact logs and client replies are free text written by people.
get_document_analysis
ClaudeThe analysis summary of an auction's appraisal and notice: key facts with the page they come from, per-asset data, other relevant information, differences between appraisal and notice, issues and the narrative summary. With job_id it reports the progress of a running analysis. Rendered as the analysis card. The analysis text is extracted by AI from third-party court documents.
get_my_account
ClaudeShow the signed-in user's ImmobilScan account: plan, monthly and stock quotas (used, limit, remaining, locked) for valuations, AI reports, document analysis, watchlist and saved searches, and whether the CRM and workspaces are enabled. These are the figures behind a quota_exceeded or feature_not_enabled error.
get_notification_preferences
ClaudeFor each notification type: whether it is shown in the app and sent by email.
get_report_link
ClaudeLink to the immobilscan.it page where the user can export the PDF report of an auction or a valuation (the PDF is generated on the website).
get_saved_search_matches
ClaudeThe auctions matching a saved search, newest first, marking the ones not seen yet. Rendered as an interactive auction list.
get_search_options
ClaudeValues accepted by the auction search: courts, property categories (with open auction counts), notary sale sellers, or regions with their province codes. Free.
get_valuation
ClaudeFinal result or progress of a valuation: estimated value, range, price per m², market value and judicial discount (auctions), confidence, OMI zone quote, number and median of comparables, per-asset values for multi-asset lots, socio-economic context and warnings. Rendered as the valuation card.
get_valuation_ai_report
ClaudeThe 'Valutazione AI avanzata': an investment report written by AI on a completed valuation. Read-only: it returns the saved report, or its status (generating, not_generated, failed); generate_valuation_ai_report creates one. The report text is written by AI.
get_watchlist_updates
ClaudeChanges of the followed auctions in the last days: price, status, dates, files.
get_workspace
ClaudeOverview of one workspace: counts of auctions, saved searches, clients and members, new auctions in the last 24 hours, items assigned to the user and the members list (name, email, role). Accepts the workspace id or name.
get_workspace_calendar
ClaudeCalendar of a workspace for a period: client reminders of the workspace (all, assigned to me or mine) and sale dates and offer deadlines of the auctions in its watchlist.
immobilscan_help
ClaudeLists what can be done with ImmobilScan in this chat and which information each action needs. Without topic it returns every action, marking those that require an ImmobilScan account. With topic (a tool name or a few words such as "client", "reminder", "valuation") it returns the matching actions; for a single match it also returns the fields to provide and example requests. Rendered as an interactive guide.
invite_member
ClaudeInvites a person by email to a workspace with a role (admin, membro, lettore). It sends them an invitation email, which cannot be recalled, and adds a pending invite.
link_client
ClaudeConnect a client with a saved search (kind=saved_search) or with an auction of the watchlist (kind=watchlist, which also creates a proposal).
list_analyzable_documents
ClaudeThe appraisal (perizia) and sale notice (avviso) documents of a court auction that ImmobilScan can analyze with AI, which ones are preselected or already analyzed, and the expected cost (free if already analyzed, otherwise one 'perizie' quota unit).
list_clients
ClaudeList the user's CRM clients (personal and workspace clients they can see), or search them by name, email or phone with query. Filters: destination (personal, or a workspace id/name), stage, tags, assigned to me, archived. Each client has phone, email, stage, tags, next action and proposals, including phone numbers, emails and client ids. Rendered as an interactive list. Notes, contact logs and client replies are free text written by people.
list_my_invites
ClaudeList the pending invitations the user received to join workspaces.
list_notifications
ClaudeThe user's ImmobilScan notifications (client replies, new proposals, reminders, auction deadlines, assignments, mentions), unread first. Rendered as an interactive list.
list_proposals
ClaudeAuctions that ImmobilScan matched to the user's clients (from their search profiles), with match %, reasons, status (to approve, approved, discarded, withdrawn) and the client's reply. Filter by client, profile (e.g. 'casa al mare' of Pinco Pallino), status or workspace. Rendered as an interactive list. Notes, contact logs and client replies are free text written by people.
list_reminders
ClaudeThe user's agenda of client reminders (calls, visits, emails, messages, automatic auction deadlines) for a period: period (today, this_week, next_week...) or start/end dates, optionally for one client or one destination (personal or workspace). Default: this week, open reminders. Rendered as an interactive agenda with buttons to complete or postpone. Notes, contact logs and client replies are free text written by people.
list_saved_searches
ClaudeThe user's saved auction searches (personal or of a workspace) with criteria, number of matching auctions, new ones not yet seen and alert settings.
list_tags
ClaudeList the tags usable on clients (personal and workspace tags), with usage counts.
list_team_notes
ClaudeNotes written by the workspace team on a client, a followed auction or a saved search, with author and mentions. The note text is free text written by people.
list_valuations
ClaudeThe user's valuations (personal or of a workspace), auctions or properties, newest first, with status and estimated value.
list_watchlist
ClaudeThe auctions the user follows, personal or of a workspace, with prices, dates, status, notes and alert settings. Rendered as an interactive list.
list_workspaces
ClaudeList the ImmobilScan workspaces (agency teams) the user belongs to, with their role, members count and whether the CRM is active, plus pending invitations and the workspace ids. Rendered as an interactive list.
log_client_contact
ClaudeRecord a call, email, message or visit with a client in their activity log (records only: nothing is sent). occurred_at defaults to now and cannot be in the future.
mark_notifications_read
ClaudeMark some notifications (ids), a category, or all of them as read.
propose_auction_to_client
ClaudeAdds an auction to a client's proposals by hand. It starts as 'to approve' and nothing is sent to the client until review_proposal approves it.
remove_from_watchlist
ClaudeRemoves an auction from the watchlist, with its notes and alert settings.
remove_member
ClaudeRemoves a member from a workspace, or leaves the workspace when the member is the user. The items assigned to them are reassigned.
request_access
ClaudeSends an invitation request to the ImmobilScan team, for people who do not have an account yet. Required: first name, last name, email, user type and acceptance of the privacy policy, whose link is in the preview. The request cannot be withdrawn; the team reviews it and answers by email.
request_auction_valuation
ClaudeStart an ImmobilScan valuation of a judicial auction (estimated auction value, market value, judicial discount, range and confidence). Surface, category and location come from the auction; condition and floor make the estimate more precise. It uses one 'valutazioni_asta' quota unit, which is not refunded. It waits a few seconds and returns the final result, or status=running with the id for get_valuation.
request_property_valuation
ClaudeStart an ImmobilScan valuation of a property from its features. Required: surface_sqm and city; address and province make the estimate more precise. It uses one 'valutazioni_immobile' quota unit, which is not refunded. It returns the final result, or status=running with the id for get_valuation.
respond_to_invite
ClaudeAccepts or declines a pending workspace invitation (ids from list_my_invites). Accepting joins the workspace with the offered role; declining removes the invitation. Either way the invitation is consumed.
review_proposal
ClaudeSets the outcome of a proposal, replacing its current status. Approving sends the auction to the client by email when they gave consent; discarding and withdrawing only change the status.
search_auctions
ClaudeSearch Italian judicial real-estate auctions (court sales from pvp.giustizia.it and notary sales) that are currently open. Returns a page of 20 auctions with status, category, address, court, surface, base price, minimum offer and sale date, rendered as an interactive list. Free, no account needed: place (region, province, municipality, street), property categories, minimum-offer range, sorting by sale date, price, newest or offers deadline. With an ImmobilScan account: surface, bedrooms, bathrooms, vacant only, with photos, full ownership, offers deadline, keywords and sorting by judicial discount; results also show the judicial discount and the minimum raise. get_auction returns the full details of one result.
set_client_consent
ClaudeRecords that the client granted or revoked consent to receive auction proposals by email, replacing the previous consent state. It has legal value. The client must have an email address.
share_valuation
ClaudeMoves a personal valuation into a workspace (share), or copies a completed valuation to another destination. A copy is not recomputed and uses no quota. Sharing makes the valuation visible to the workspace members.
start_document_analysis
ClaudeStart the AI analysis of the auction documents (by default the preselected ones; or pass documents ids from list_analyzable_documents). It extracts occupancy, enforceable title, regularization and amnesty costs, condo fees, appraisal value and issues, and compares appraisal and notice. It uses one 'perizie' quota unit unless the documents were already analyzed, and the quota is not refunded. Scanned PDFs can take minutes: it returns status=running, and get_document_analysis reads the result. The analysis text is extracted by AI from third-party court documents.
suggest_addresses
ClaudeStreets of a municipality that have open auctions, as the court writes them, with the number of auctions: use one as street in search_auctions. Free.
unlink_client
ClaudeRemove the link between a client and a saved search or watchlist auction.
update_client
ClaudeChange a client's details in one call: name, email, phone, notes, stage, tags (replaces the set), archive or restore, private flag, whether members can edit, match threshold. Pass only what changes; an empty string clears a text field.
update_member_role
ClaudeChanges the role of a workspace member (owner/admin only), replacing their current role and the permissions that come with it.
update_notification_preferences
ClaudeTurn in-app and/or email notifications on or off for some types. Types: cliente_risposta, nuove_proposte, portale_aperto, promemoria_scadenza, asta_in_scadenza, assegnazione, menzione.
update_reminder
ClaudeChanges a reminder (title, date, type, note), marks it as done (completed=true, optionally with the outcome in contact_note, which logs a contact) or postpone it (postpone_days or new due_at). Automatic auction reminders can only be completed.
update_saved_search
ClaudeRename a saved search, pause or resume it, change email and in-app alerts.
update_search_profile
ClaudeChange a search profile: name, criteria (the given criteria replace the saved ones), must-have and nice-to-have fields, tolerances, or pause it (active=false).
update_tag
ClaudeChange the name or the color of a tag.
update_watchlist_item
ClaudeChange the note, auto-follow or the email alerts of a watchlist item.
update_workspace
ClaudeChange name, description, city, color or sharing rule of a workspace (owner/admin).