Tools and outputs

This page lists the tools an AI assistant such as Claude or ChatGPT can call once it is connected to Ploti. You ask in plain language and the assistant picks the tools, so you never need to call one by name. The list is here for when you want to know what your assistant can do, or are building an agent of your own. Each tool is labeled by its effect: whether it only reads, saves something in your workspace (your team’s Ploti account), or reaches an outside address. No tool runs code on your computer. Reads run on Ploti’s servers and need no map. Heavier analysis runs in a map’s worker, a private database that belongs to one map.

Tool reference

The tools are grouped by topic. Query Ploti directly explains the reads in full. Data Feeds, the subscription that keeps a copy of the data in your own system, has no tools here.

Find datasets

See Find datasets.

Tool	What it does	Effect
`places_list`	Lists the places your workspace covers	Read only
`topics_list`	Lists the topics datasets are filed under	Read only
`datasets_search`	Searches the layers, tables, documents, scanned maps and collections that can answer a question	Read only
`datasets_list`	Lists every dataset in a place, of any kind, unranked, with paging	Read only
`datasets_get`	Describes a dataset’s columns	Read only
`datasets_values`	Lists the codes a coded column takes, such as land use or flood zone	Read only
`datasets_profile`	Shows how full a column is and what it holds	Read only
`datasets_provenance`	Says where a dataset’s values come from	Read only
`geocode`	Turns an address into coordinates, or coordinates into an address	Read only
`guides_read`	Reads Ploti’s task guidance	Read only

Read rows

See Read rows.

Tool	What it does	Effect
`datasets_rows`	Reads a page of a dataset’s rows in a place, with conditions	Read only
`datasets_aggregate`	Counts and totals a dataset’s rows	Read only
`datasets_estimate`	Sizes up a read before anything moves	Read only
`datasets_lookup`	Finds rows by id, parcel number or owner name anywhere in coverage	Read only
`datasets_related`	Finds what overlaps, touches or lies near one row, such as a parcel	Read only

Documents and collections

See Documents and collections.

Tool	What it does	Effect
`documents_search`	Searches ordinances, codes and other documents Ploti holds	Read only
`documents_read`	Reads one section of a document, in pages when it is long	Read only
`documents_outline`	Lists a document’s sections and tables, in order	Read only
`documents_tables_list`	Lists the tables found in a document	Read only
`documents_tables_read`	Reads one table’s rows, in pages	Read only
`collections_documents_list`	Lists the documents in a collection	Read only
`collections_documents_search`	Searches inside a collection’s documents and names the page of each match	Read only
`collections_documents_read`	Reads one document from a collection	Read only
`datasets_files_get`	Returns a dataset’s stored file, such as an ordinance’s PDF, with a download link	Read only

Municipal codes

See Municipal codes.

Tool	What it does	Effect
`municode_search`	Finds a place’s code on Municode and searches it	Read only
`municode_read`	Reads a section of that code	Read only

Maps

See Show results on a map.

Tool	What it does	Effect
`maps_create`	Makes a map in your workspace that you can open in Ploti	Creates a map
`maps_list`	Lists the maps you made, most recently used first	Read only
`maps_get`	Reports a map’s view and its Ploti link	Read only
`maps_navigate`	Moves the map you see to a place or coordinate	Changes the map’s view
`maps_datasets`	Lists what the map offers at its current view	Read only
`maps_snapshots_create`	Saves a set of places by id, from the worker, or by conditions	Saves to the workspace
`maps_snapshots_delete`	Deletes a snapshot made on the map, unless a saved filter uses it	Deletes a snapshot
`maps_filters_create`	Saves a live view of layers and snapshots	Saves to the workspace
`maps_filters_update`	Saves a new version of a filter	Saves to the workspace
`maps_files_export`	Saves a dataset’s rows as a CSV, GeoJSON or Parquet file on a map	Saves to the workspace
`maps_outputs_list`	Lists saved snapshots, filters, and files	Read only
`maps_outputs_show`	Returns a bounded preview and an interactive map or table	Grants you a view of the output
`maps_outputs_share`	Makes a public view-only link that lasts 7 days	Shares an output
`files_get`	Returns fresh links to a saved file, by its id	Read only

Analysis on a map

See Show results on a map.

Tool	What it does	Effect
`maps_tables_load`	Copies a dataset’s rows into the map’s worker	Changes the map’s worker
`maps_tables_documents_load`	Copies documents into the map’s worker	Changes the map’s worker
`maps_tables_compute`	Runs one read-only DuckDB query over the worker’s tables	Changes the map’s worker
`maps_tables_analyze`	Runs a statistical or spatial method on a worker table	Changes the map’s worker
`maps_tables_methods`	Lists the methods `maps_tables_analyze` offers	Read only
`maps_tables_list`	Lists the worker’s tables and how much room is left	Read only
`maps_tables_drop`	Removes a worker table	Changes the map’s worker
`maps_tables_export`	Saves a worker table as a file, with a download link	Saves to the workspace
`maps_storage_get`	Reports the worker’s disk use	Read only
`maps_storage_free`	Frees room on the worker’s disk	Changes the map’s worker
`jobs_get`	Reports a long step’s progress or result, by its job id	Read only
`jobs_cancel`	Stops a long step, by its job id	Stops a job

Knowledge graph

Ploti’s knowledge graph links the parcels, people, companies, addresses and recorded events found across the datasets in your coverage areas. Each answer names the source row behind it. Each entity has a public id that the other graph tools take.

Tool	What it does	Effect
`graph_search_names`	Finds people and companies by a name in deeds, rolls or registries	Read only
`graph_search_address`	Finds an address	Read only
`graph_area`	Lists the parcels in an area	Read only
`graph_map_row`	Says what the graph made of one row of a layer	Read only
`graph_entity`	Reads one entity	Read only
`graph_lookup_key`	Finds a parcel by its number	Read only
`graph_parcel_story`	Tells a parcel’s history: owners, sales and recorded events	Read only
`graph_events_by_participant`	Lists the events a person or company took part in	Read only
`graph_event`	Reads recorded events	Read only
`graph_facts`	Reads the facts recorded for entities and events	Read only
`graph_encumbrances`	Lists the mortgages, liens and judgments recorded on parcels	Read only
`graph_control_parcels`	Lists the parcels a person or company owns or controls	Read only

Research requests

See Research requests.

Tool	What it does	Effect
`requests_create`	Asks Ploti to answer a question that needs data it does not have yet	Files a request; missing data uses credits as delivered
`requests_get`	Reports a research request’s status, report and answer	Read only
`requests_list`	Lists your research requests	Read only
`requests_questions_answer`	Sends the person’s answers to the request’s questions	Answers a request
`requests_gaps_file`	Files the missing data a request found, once the person agrees	Files data requests; uses credits
`requests_answer`	Closes a request with the assistant’s own answer	Answers a request
`requests_data_list`	Lists the workspace’s data requests, their status and delivered datasets	Read only

Watch for changes

See Watch datasets.

Tool	What it does	Effect
`datasets_watch`	Has Ploti tell your webhooks each time a dataset gets a new version	Adds a watch
`datasets_watches`	Lists the datasets you watch	Read only
`datasets_unwatch`	Stops watching a dataset	Removes a watch
`datasets_changes`	Lists the rows a dataset version added, changed or removed	Read only
`webhooks_create`	Has Ploti POST signed events to an https URL	Adds a webhook
`webhooks_list`	Lists your webhooks	Read only
`webhooks_test`	Sends a test event to a webhook	Reaches an external URL
`webhooks_delete`	Removes a webhook	Removes a webhook

Maps and boundaries

Reading needs no map. The read tools name a place and cover everything in your coverage areas, the counties your plan covers, wherever any map is looking. A connection reads for one Ploti workspace only. A map is what you open in Ploti. maps_create makes one and returns its id, the same id the Ploti app opens. The tools that save outputs, move the view or run analysis take that id. A map does not expire: ask for it tomorrow from another conversation, and the assistant finds it with maps_list and keeps working on it. Each map has a private worker for heavy analysis. A worker stops after 15 minutes idle and restarts with its tables when next used. After an hour unused, it is removed with its tables. The next call on the map starts a fresh worker, and maps_tables_load loads the tables again. Snapshots, filters and files saved on the map stay in the workspace either way.

Analysis and exports

Most questions need only datasets_rows and datasets_aggregate, which answer with a page of rows or a total at a time. Joins across layers, statistics and scoring move to a map’s worker. maps_tables_load copies in what is needed, and maps_tables_compute and maps_tables_analyze work on it there. Every worker reply says how much memory and disk are in use, so the assistant can work in smaller steps as it nears a limit. maps_files_export and maps_tables_export save rows in the workspace as a CSV, GeoJSON or Parquet file of up to 500 MB. Larger exports are split into several files. Each export returns two links: a download link that needs no sign-in and lasts 15 minutes, which an assistant that runs code can fetch, and a Ploti link for you. Coding agents can also download a dataset’s rows as GeoParquet files with the CLI or the Python library.

Interactive outputs

maps_outputs_show always returns a short text preview and a Ploti link. Some assistants, such as Claude Desktop, also show an interactive map or table in the chat. A map and its comparison table can appear as separate outputs. The assistant can page through the preview or narrow it instead of putting a whole dataset into the conversation. Use Filter rows to find entries in a table, Export CSV to download the result, or Open in Ploti to continue reviewing it in your workspace.

Interactive Ploti table with parcel owners, acreage, assessed values, cities, distance to I-4, and filter and export controls — Review parcel attributes in Claude Desktop using the table's filter, Export CSV, and Open in Ploti controls.

In an assistant that shows only text, the preview, the download links and the Open in Ploti link still work.

Requesting data

When Ploti does not have the data a question needs, the assistant files a research request with your question. Ploti checks which data it needs, finds the official sources, and collects what is missing for the places in your coverage areas. That usually takes hours to days. Ploti then runs the research and emails you the answer. The assistant can check on it with requests_get and requests_data_list. A delivered dataset can be searched and read like any other.

What the assistant can save

Snapshots: fixed sets of places that can be reviewed on a map or in a table
Filters: live layers on the Ploti map
Files: CSV, GeoJSON and Parquet exports with authenticated download links

Saved outputs are private to the workspace unless a member shares one. Security and privacy says who can reach them and how long they are kept.

Start here

Chat assistants

Coding agents

Always-on assistants

Reference

Tools and outputs

Tool reference

Find datasets

Read rows

Documents and collections

Municipal codes

Maps

Analysis on a map

Knowledge graph

Research requests

Watch for changes

Maps and boundaries

Analysis and exports

Interactive outputs

Requesting data

What the assistant can save

​Tool reference

​Find datasets

​Read rows

​Documents and collections

​Municipal codes

​Maps

​Analysis on a map

​Knowledge graph

​Research requests

​Watch for changes

​Maps and boundaries

​Analysis and exports

​Interactive outputs

​Requesting data

​What the assistant can save

Tool reference

Find datasets

Read rows

Documents and collections

Municipal codes

Maps

Analysis on a map

Knowledge graph

Research requests

Watch for changes

Maps and boundaries

Analysis and exports

Interactive outputs

Requesting data

What the assistant can save