Integration · Company data

Connect Claude & ChatGPT to Mapulus

Ask your AI which suburb, postcode or LGA a location falls in, or what the census says about the people living there. It can list your Mapulus maps and locations, add and update locations on a layer, find the locations nearest an address and read incidents such as emergency events. Demographics come for a point, a boundary or a custom area.

Connect Mapulus free

Free plan, no credit card. Takes about a minute.

Try asking

“Which boundaries does -33.87, 151.21 fall in?”
The AI finds the statistical and administrative boundaries at that point, such as suburb, postcode and LGA.
“What does the census say about age and income in postcode 2000?”
It searches the demographic fields for age and income, then reads the census values for that postcode.
“Add our new store at 12 George Street, Sydney to the Stores layer.”
It finds the layer ID on your map and creates the location with the address and a title.

What your AI can do

Maps and locations

List maps and their layers, and read, add, update and delete locations. Find locations by map, layer, external ID or nearest to an address.

Boundaries

List boundary types such as SA2, LGA and postcode, read boundaries and find the ones that contain a point.

Census demographics

Get census demographics for a point, boundaries or a custom polygon, filtered by topic, age range and sex, and enrich up to 100 locations at once.

“Which of our locations are closest to Parramatta station?”
It lists the locations nearest to that address.
“Are there any active emergency incidents in NSW?”
It lists incidents filtered by state and status, with type and severity.
“Add the LGA and demographic data to these 40 locations.”
It enriches the locations with the boundaries they fall in and demographic or fundraising datapack values. It is a lookup and changes nothing.

33 tools for Mapulus

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_geojsonVisible to othersCreate a new geojson. Required: boundary ids. Search geojsons first to avoid duplicates. Has effects visible outside this system. API summary: Batch export boundaries as GeoJSON.
create_locationChanges dataAdd a location to a map layer by `layer_id`, with an address or lat/lon, title, label and custom attributes.
create_projectChanges dataCreate a new project. Required: boundary id. API summary: Create async targeting job.
delete_locationDeletesPermanently delete a location by ID. This cannot be undone.
enrich_locationsChanges dataEnrich up to 100 locations with the boundaries they fall in and demographic or fundraising datapack values. Read-only lookup.
find_boundaries_at_pointFind the statistical and administrative boundaries (suburb, postcode, LGA, etc.) that contain a lat/lng point.
get_boundaryGet one boundary by type and code.
get_demographicsGet census demographics for a point (lat/lng), one or more boundary IDs, or a boundary type, with optional topics, age range and sex filters.
get_demographics_for_areaChanges dataGet census demographics for a custom GeoJSON polygon, optionally aggregated across the boundaries it covers.
get_fieldGet one field by api path. API summary: Get field metadata.
get_healthGet one health. API summary: Sync source health.
get_incidentGet one incident by ID.
get_locationGet one location by ID.
get_mapGet one map by ID.
get_projectGet one project by project id. API summary: Poll targeting job status.
list_boundaries_of_typeList boundaries of one type (e.g. lga or poa), paginated.
list_boundary_geojsonsList geojsons for a boundary. Optional filters: simplify. API summary: Export a single boundary as GeoJSON.
list_boundary_typesList the available boundary types (e.g. sa2, lga, poa) that other boundary and demographic tools accept.
list_demographic_topicsList the demographic topics (e.g. age, income) you can request.
list_derivedsList deriveds. API summary: List derived percentage fields.
list_healthsList healths. API summary: Service health check.
list_incidentsList incidents (e.g. emergency events), filtered by type, status, state or severity.
list_locationsList locations, filtered by `map_id`, `layer_id` or `external_id`, or find the nearest locations to a lat/lon or address.
list_mapsList your Mapulus maps. Set `expand` to include each map's layers (needed for a layer ID when adding locations).
list_metaList meta. Optional filters: boundary id, radius unit, mode or nocache. API summary: Generate Meta Ads targeting circles.
list_sourcesList sources. API summary: List incident sources.
list_summariesList summaries. Optional filters: type, event type, event subtype, status, state or severity. API summary: Incident summary counts.
list_tile_pbfsList pbfs for a tile. API summary: Vector tile for a boundary layer.
search_boundaries_searchChanges dataSearch boundaries. Use this to find existing boundaries before creating a new boundary. API summary: Batch lookup boundaries.
search_boundary_geojsonsSearch geojsons for a boundary by simplify, state, contained by, intersects, search or code prefix. Use this to find existing geojsons before creating a new geojson. Results are paginated. API summary: Export all boundaries of a type as GeoJSON.
search_demographic_fieldsSearch demographic fields by topic or keyword to find the field paths to request.
search_incidentsChanges dataSearch incidents. Use this to find existing incidents before creating a new incident. API summary: Search incidents by polygon.
update_locationChanges dataUpdate a location by ID (`layer_id` required): address, coordinates, title, label or custom attributes.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Mapulus from the app list.
2
Paste your key
Paste a Mapulus API key. In Mapulus open Profile > API Keys and create a key. You can limit it to specific resources and set an expiry date. Copy the key.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Mapulus?

The AI can read maps, layers, locations, boundaries, incidents and census demographics. It can add and update locations, enrich up to 100 locations with boundaries and demographic values, and delete a location if you switch that tool on.

Does the AI see my Mapulus API key?

No. Your Mapulus API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting a location is permanent and can require your approval before it runs. You can also limit the API key to specific resources in Mapulus. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Mapulus account.

Which demographic data can the AI use?

Mapulus has Australian boundary and census demographics data. The AI can list the topics you can request, such as age and income, and search the fields to find the exact values. It can read them for a point, one or more boundaries, a boundary type or a custom polygon.