MCP App Store
by KeenEthics
Mapsemble icon

Mapsemble MCP Server for ChatGPT

By Mapsemble

Overview

Mapsemble turns your places into an interactive map for your website: the map with a scrollable list of photo cards beside it, filters and a search box, the way a store locator or a holiday-rental site shows its listings. It is made for browsing many places, from a few dozen to thousands of shops, holiday homes, hotels, routes or points of interest. Every map is saved in your Mapsemble account. Come back to it in a later conversation or in the Mapsemble builder, change it, and the map on your website follows. Build it from a conversation: ask ChatGPT for a map of the best coffee spots in town, paste a list of addresses, share a Google Sheet or point it at a GeoJSON file of hiking routes. A live preview shows the map in the chat after each round of changes. What you can ask: - Create a map and add places by address or coordinates, lines and areas, with photos. - Import a CSV, a public Google Sheet or a data file on the web. - Design the cards and popups, color pins by a field and give them icons or photos. - Add filters, a name search and a sort order for the list. - Get the code for your website, whether you built it with ChatGPT, WordPress or any other CMS, or a link to share. Mapsemble is a map builder for websites: tourism boards, holiday parks, shops with many branches and anyone with a list of places to show. You need a Mapsemble account. ChatGPT works only on your own maps. Maps aren't deleted from the chat.

How to connect

  1. ChatGPT: Open the Mapsemble listing in the ChatGPT app directory and choose Connect. ChatGPT listing Mapsemble exposes 23 tools here.

Tools

add_fields

ChatGPT
Add fields to a map: information each location can have besides its name, such as a price, opening hours or a category, up to 8 at a time. A new single_select or multi_select field may come without options: add_locations and import_csv add the values its locations have as its choices. A single_select or multi_select field the map has already, named by its label, gains the options passed that it doesn't have yet; a field keeps its type (edit_fields changes a type), and nothing is removed. The cards and popups are left as they are, so they show a new field once their HTML is changed with update_card_design or in the builder. The result lists each change, each part skipped with its reason, notes on what a change leaves as it is and a link to the builder's fields panel; its alreadySo is true when nothing changed.

add_locations

ChatGPT
Add locations to a map, up to 100 per call. Each needs a name and lat and lng, an address (looked up, counted against the plan's address lookups) or a geometry: a line or an area as GeoJSON or WKT. Values are keyed by the field's label as get_map lists it. Give each a stable key, a slug of its name and street or town: sent again, a key finds its location, so a retried call doesn't add it twice and values sent with it are added; a key whose location has another name, or is more than 100 m away, fails (update_locations changes a location). Photos are https URLs, copied to Mapsemble in the background; find_locations says which couldn't be. A map at its plan's limit of locations takes no new ones. The result lists every location as added, updated (with what changed), unchanged or failed with the reason, the choices added to fields, notes on what the lists leave out, and a link to the builder's locations panel; its alreadySo is true when nothing changed.

connect_google_sheet

ChatGPT
Connect a Google Sheet shared with "Anyone with the link" to a map and import its rows as the map's locations. Every column of the sheet is mapped (preview_google_sheet lists them): to a field of the map by its label, to the location's name, to its address (looked up, counted against the plan's address lookups) or to its latitude and longitude, or ignored. A field the map hasn't got yet is added with add_fields first. The map's locations are replaced by the sheet's rows, and from then on the sheet is where they are edited: the location tools here no longer change them. On paid plans the map follows the sheet automatically; otherwise it is re-synced from the builder. A private sheet, a large one (over 250 rows placed by address, or 5,000 rows) and other layouts are connected in the Mapsemble builder. Returns how many rows were imported, the rows skipped and why, how the map follows the sheet, and a link to the locations panel of the builder.

create_map

ChatGPT
Create a new map for the signed-in user, without locations: its title, what one location is called ("campsite", "store"), up to 8 fields besides the name every location has, and, only when the user asks for a look, a style preset, base map and layout. A new map starts with the fields Description, Image and Call to action, plus a Category tag field when no fields are given. A Category asked for is made with the type asked for; a field asked for under one of the other three labels stays the field the map has. A single_select or multi_select field may come without options: add_locations and import_csv make its locations' values its choices. Every location gets the same plain pin, the map has no filters, and it loads 50 locations at a time; colored pins, filters, styles and card designs each have their own tool, for when the user asks. Returns the new map as get_map describes it, a link to edit it in the builder, and a note on any field not added as asked.

delete_locations

ChatGPT
Delete locations from a map by their id (from find_locations) or their key, up to 500 of each per call. This can't be undone: the builder's Undo button doesn't cover locations, and the photos copied to Mapsemble for a deleted location are deleted with it, unless another location uses the same file. There is no 'delete all': every location is replaced by connecting a sheet with connect_google_sheet, or by importing a file in the Mapsemble builder. An id or key that names none of this map's locations is listed in notFound (already deleted, or never on it), so a repeated call deletes nothing more. Returns how many were deleted and the first 100 of them, those not found, and a link to the locations panel of the Mapsemble builder.

edit_fields

ChatGPT
Rename fields of a map, change their type, or remove them, when the user asks, each named by its label as get_map lists it, up to 8 of each at a time. A renamed field keeps its values, and a filter with its label is renamed with it. A type changes only among single_select, multi_select and tag, and between text and multiline_text; among the first three it rewrites the value stored on every location: to single_select each keeps its first choice or tag, and to tag the choices no location holds go. Removing a field takes it off the map with its filter, the pin colors and pin rules by it, the pin text or images from it and the list order by it; its values stay stored with the locations and are still in the map's location data. The cards and popups are left as they are. The result lists each change, each part skipped with its reason, notes on what it does to the locations and leaves alone and a link to the builder's fields panel; its alreadySo is true when nothing changed.

find_locations

ChatGPT
Find a map's locations by text in their name, by the value of a field, or both, in name order, 10 a page unless limit asks for up to 50; without either it lists them all. Values come whole, so a page holds fewer locations when their texts are long. A field is named by its label as get_map lists it: a choice field takes the choice's label, a multiple-choice or tag field one choice or tag, a yes/no field true or false, a number field a number, and a text field text it contains; date, call-to-action and image fields can't be searched. fields keeps only those fields' values. Returns how many match in all, this page with each location's id, key, name, address, lat and lng, for a line or an area its shape and lengthKm or areaKm2 (not its coordinates), values by field label and photos (imagesCopying or imagesNotCopied: how their copy went), and nextOffset for the next page (null on the last). A location as given here can be sent back to update_locations: a value left out is no change.

find_settings

ChatGPT
Search a map's settings by what they do, in a few words ("slideshow on phones", "group nearby pins", "number format"). The words are matched against each setting's name, description, path and place in the builder, without case or accents and with plurals and word endings left off. Returns the best matches first, each with its path, name and description, the values it takes (its type, choices or range), whether it is one setting for the whole map or one per field, filter or pin rule (and on which types), and how it is changed: update_map_config's settings with that path, another tool and its parameter, or its place in the Mapsemble builder. With a mapId it also gives the current value of each map-wide match. Returns how many settings matched in all; settings the builder has no place for are left out.

get_card_design

ChatGPT
The HTML of a map's cards and popups, as update_card_design takes it: the four slots (the card in the list and the popup, each on desktop and on a phone) with what each one is and what shows when it is empty; the tokens that print a location's name and fields, with what each prints and the condition that tests whether it is empty; the rules the HTML follows on this map; the fonts the templates use (fonts), and any of them that aren't Google Fonts; and a link to the design panel of the Mapsemble builder. Long slots that don't fit in one answer are listed under more, to ask for by name with slots.

get_embed_code

ChatGPT
The HTML snippet that puts this map on a website (paste it where the map should appear), the same one the Share panel in the Mapsemble builder gives with its defaults: 90% of the screen high, the list scrolling with the page on phones. Also designSnippet: the same code with a placeholder inside it (a blurred drawing of the map and a note that the live map appears once published), for designs, mockups and artifacts made in Claude, whose previews block outside sites; on a website, the live map replaces it. Also the map's share link, on park maps a second snippet for the page about the surroundings (it opens the map at the surrounding area), and a note when the embedded map will show an upgrade notice or example locations. For another height or scroll behavior, or step-by-step help for a website builder, use editUrl, which opens the Share panel.

get_map

ChatGPT
One map as it is now: title, what a location is called, its fields (with the choices of choice fields; choice lists are cut at 30, the builder shows all), filters, sort orders, how it looks (colors, pins, base map, layout, custom CSS), how many locations it has against the plan's limit (count null when they come live from another site; limit null means unlimited) and how many are lines and areas, where its data comes from and whether its locations can be changed from here, and a link to edit it in the Mapsemble builder. With includeSettings it also lists every setting update_map_config can change, with the current value of each map-wide one. A map’s custom CSS is changed in the Mapsemble builder: Design › Colors & buttons › Custom CSS, shown with Developer mode on.

import_csv

ChatGPT
Add locations to a map from CSV text: up to 2,000 rows the chat writes or the user pastes (a Google Sheet is connected with connect_google_sheet, a file on the web imported with import_data_url). The first row names the columns; the delimiter is detected. Each column is mapped to a field by its label, to the name, the address (looked up, counted against the plan's address lookups), latitude and longitude, a geometry (a line or area as WKT or GeoJSON), a key, or ignored. A row whose key a location has updates that location, so the same CSV again changes nothing; without a key column, only a location an earlier import_csv added from the same name and place is updated, and others are added. A blank cell leaves the field's value as it is, and a column mapped to "ignore" keeps its values; update_locations clears a value. Nothing is deleted (delete_locations deletes). Returns the rows added, updated, unchanged and failed (by row number, with why) and a link to the builder.

import_data_url

ChatGPT
Copy a data file on the web into a map as locations: a GeoJSON FeatureCollection (a WFS's GeoJSON answer included) or CSV/TSV text, up to 5,000 features or rows and 300,000 points. Mapsemble fetches it on its server, so this works when the chat can't reach the address itself; preview_data_url shows what the file holds. A feature's geometry becomes its location's: a point, a line or an area (one of more than 1,500 points is simplified, keeping its shape). A CSV row is placed by a geometry column (WKT or GeoJSON), latitude and longitude, or an address (looked up, counted against the plan's address lookups). Every property or column is mapped, as in import_csv. With keyProperty or a "key" column, importing again updates the locations made before. The map keeps a copy and doesn't follow the address. Returns the features or rows added, updated, unchanged and failed (with the reason), the shapes simplified, and a link to the builder.

list_maps

ChatGPT
The signed-in user's Mapsemble maps, newest created first, at most 50; pass query to find any map by its title. For each: id, title, number of locations (null when they come live from another site), where the locations come from, when its settings were last changed and a link to edit it in the Mapsemble builder.

preview_data_url

ChatGPT
Read a data file on the web before importing it: a GeoJSON FeatureCollection (a WFS service's GeoJSON answer included) or CSV/TSV text, whose columns may hold WKT or GeoJSON geometry, latitude and longitude, or an address. Mapsemble fetches it on its server, so this works when the chat can't reach the address itself; public https addresses only, up to 25 MB. Returns the format, how many features or rows it has, their geometry types and points (on import, a line or area of more than 1,500 points is simplified), the coordinate system (longitude and latitude are needed), each property or column with a few of its values, how many different values it has, its longest value's length and the field type its values fit (suits: make its field that type, or values that don't fit fail on import), those whose values tell every feature apart (keyCandidates), whether a chat can import it and why not, and what import_data_url needs for it. Changes nothing.

preview_google_sheet

ChatGPT
Read a Google Sheet shared with "Anyone with the link" before connecting it to a map: its columns (named from its first row), its first 5 rows as {column: value} and how many rows it has below the first. The link may name a tab (#gid=…); otherwise the first tab is read. A sheet larger than 5 MB, or one that isn't link-shared, is connected in the Mapsemble builder instead. Changes nothing. connect_google_sheet then connects the sheet, with each column mapped.

set_feature_style

ChatGPT
Change how a map's locations look, when the user asks: pins (a plain marker, an icon, or each location's photo from an image field; color and size) and lines and areas (outline color, width and dash; fill). defaultStyle is the look of every location nothing else styles; pins styled by a field or by rules follow its marker, size and outline where they looked like it, and keep their colors. styleBy gives each value of a field a color of its own, valueStyles style some of its values, and rules style the locations they match ("Price is more than 100"), before the map's own rules. Only what is passed changes. replace: true first removes the styles set by a field or by rules; rules the owner made or changed in the builder stay, and the result names them. Values are matched exactly. Text pins, hover styles and area labels are set in the builder. The result lists each change, each part skipped with its reason and a link to the builder's design panel; its alreadySo is true when nothing changed.

show_map

ChatGPT
Show a map to the user as a live, interactive preview in the conversation, as it is now: its pins, filters, cards and popups as visitors see them. The preview is for the conversation. Returns the map's title, its number of locations (null when they come live from another site), a link to edit it in the Mapsemble builder, and under embed what get_embed_code gives: the HTML snippet that puts the map on a website, its share link and where to paste it.

update_card_design

ChatGPT
Replace the HTML of a map's cards and popups (Tailwind classes, Twig field tokens). Call get_card_design first for the current HTML, the tokens and the rules. Only the slots passed change unless replaceAll is true, which clears every slot not passed (selectedDesktop is then passed too, if only as "" for no popup); an empty string clears one slot. Every new slot is checked before anything is written, and nothing changes when one is refused with its reason: scripts, style attributes, event handlers and unknown tokens are refused, and fixed positioning, a z-index above 50, popovers, dialogs and selects are refused or removed. HTML the map has already is no change. The result lists the slots changed, cleared and left as they were, notes on what shows in place of a cleared slot and on anything else the change switched, the fonts in use (fonts, fontsNotFound), and a link to the builder's design panel; its alreadySo is true when nothing changed.

update_filters

ChatGPT
Add, rename or remove the filters visitors narrow the locations with when the user asks, up to 8 of each at a time. add takes fields, by their label as get_map lists the fields; each gets a filter with its label and the widget that fits it (a dropdown for single_select, checkboxes for multi_select and tag, a range slider for number, a date range, a yes/no switch, a search box for text), and only choice, tag, number, date, yes/no and text fields can have one. rename and remove take filters, by their label as get_map lists the filters, which may differ from the field's. Removing a filter takes the whole filter off the map with its settings, a search box across several fields too; the fields and their values stay. A filter's type and its other settings are changed with update_map_config. The result lists each change, each part skipped with its reason, notes on what a change leaves as it is and a link to the builder's filters panel; its alreadySo is true when nothing changed.

update_locations

ChatGPT
Change locations of a map, up to 100 per call, each found by its id (from find_locations) or its key: only what is sent changes, and null clears a value. A new address or lat and lng moves the location; an address is looked up and counted against the plan's address lookups. A geometry (GeoJSON or WKT) replaces the location's point, line or area. Photos sent replace the location's photos and are copied to Mapsemble in the background. A location that matches none on the map fails; nothing is added. A location as find_locations gives it can be sent back with only the values to change changed. The result lists every location as updated (with what changed), unchanged or failed with the reason, the choices added to fields, notes on what the lists leave out, and a link to the builder's locations panel; its alreadySo is true when nothing changed.

update_map_config

ChatGPT
Change a map's configuration when the user asks: its title, what one location is called, the order of the list, loading the list in batches, the zoom buttons, how far visitors can zoom in, keeping a visitor's filters in the page address, and in settings, by path (find_settings finds one by what it does; get_map with includeSettings lists them all): the base map's saturation, brightness, contrast and hue, the item count, grouping nearby pins, popups (on hover, a close button, their background, a slideshow on phones), the filter bar's look, the buttons' hover color, a number field's format, prefix and suffix, whether an image field holds several photos, a button's text, and a filter's type, range and placeholder. Only the parameters passed change. Look: update_map_design; how locations look: set_feature_style. The result lists each change, what was skipped and why, notes on what it leaves alone and a link to the builder's settings panel; its alreadySo is true when nothing changed.

update_map_design

ChatGPT
Change how a map looks, when the user asks for it: a style preset, the base map, button and background colors, corner roundness, list or map-only layout, and cards per row. Only the parameters passed change; a preset is applied first, so anything else passed with it wins. How the locations look (their pins, icons, photos, outlines and fills) is changed with set_feature_style, and card and popup content with update_card_design. The result lists each change, each part skipped with its reason, notes on what a change leaves as it is and a link to the builder's design panel; its alreadySo is true when nothing changed.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/mapsemble"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/mapsemble)