Connect Mapulus to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the update location tool in Mapulus
Use the add travel boundary tool in Mapulus
Use the get map tool in Mapulus
Use the search nearby locations tool in Mapulus
Use the list maps tool in Mapulus
Use the lookup territory tool in Mapulus
Supported Tools
update_location
Update Location
Update an existing location in Mapulus. Any provided fields will be updated; omitted fields remain unchanged. Can update coordinates, address, title, label, layer assignment, custom attributes, external ID, and travel boundary.
add_travel_boundary
Add Travel Boundary
Add a travel boundary (isochrone) to an existing location. Travel boundaries visualize the area reachable from a location within a given travel time, useful for service area analysis, delivery zones, and coverage planning.
get_map
Get Map
Retrieve a specific map by its ID, including its layers. Use this to get detailed information about a map and its layer structure.
search_nearby
Search Nearby Locations
Find locations near a given point within a map. Provide either coordinates (latitude/longitude) or an address to search around. Returns up to 24 nearest locations. A radius filters these results by the direct geographic distance, so it may not include every location within the radius.
list_maps
List Maps
Retrieve the first page of maps in your Mapulus account, optionally including their layers. Use this to discover available maps and their layer structure before working with locations.
lookup_territory
Lookup Territory
Find all locations within a specific Australian territory or boundary on a map. Supports official boundary types including suburbs, postcodes, and Local Government Areas (LGAs). Useful for territory management, regional analysis, and identifying which locations fall within a given area.
create_location
Create Location
Create a new location on a specific layer in Mapulus. Locations can include coordinates, addresses, custom attributes, and an optional travel boundary (isochrone). If custom attributes are provided that don't yet exist on the layer, enable **createMissingCustomAttributes** to auto-create them.
delete_location
Delete Location
Permanently delete a location from Mapulus. This removes the location and all associated data including travel boundaries and custom attributes.
find_locations
Find Locations
Search for locations in Mapulus by various criteria. Filter by map, layer, address, coordinates, location ID, or external ID. Returns the first page of matching locations. Address and coordinate filters retain their existing behavior but are not documented in the current API reference.
get_location
Get Location
Retrieve a location by its ID, including its coordinates, layer, custom attributes, and travel boundary configuration.
Enable Mapulus in Metorial. In your Metorial portal, enable the Mapulus MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Mapulus tools.
Enable Mapulus in Metorial. In your Metorial portal, enable the Mapulus MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Mapulus tools.
Enable Mapulus in Metorial. In your Metorial portal, enable the Mapulus MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Mapulus tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Mapulus in Metorial. In your Metorial portal, enable the Mapulus MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Mapulus tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Mapulus in Metorial. In your Metorial portal, enable the Mapulus MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Mapulus tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Mapulus through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Mapulus and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Mapulus tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Plot and manage locations on maps with geographic coordinates, addresses, and custom attributes. Create and organize maps and layers, search for nearby locations by address or coordinates, and define travel boundaries (isochrones) around locations. Look up territories and boundaries to identify which locations fall within specific regions, including Australian suburbs, postcodes, and LGAs. Visualize data through heat maps, clustering, and demographic overlays. Collect and enrich location data from end users via an embeddable widget with demographic, travel, and competitive insights delivered in real-time via webhooks. Bulk import large datasets and trigger workflows when new locations or maps are created.
Frequently asked questions
Common questions about connecting Mapulus to AI agents with Metorial.
How many tools does the Mapulus MCP server have?
The Mapulus MCP server exposes 10 tools, including Update Location, Add Travel Boundary, Get Map. Each one is governed and traced through Metorial.
Does the Mapulus MCP server support triggers?
Mapulus exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Mapulus MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Mapulus MCP server through the same Metorial URL.
How do I give only some teams access to Mapulus?
Use role-based access control to decide which teams, users, and agents can use Mapulus and which of its tools they can call.
Can I self-host the Mapulus MCP server?
Yes. Metorial is open source, so you can run the Mapulus MCP server yourself or use the hosted gateway.
Connect Mapulus to production AI agents
See how Metorial gives your team governed access to Mapulus, with tracing and security controls built in.