Augmap is an MCP server published by ai.augmap, hosted at mcp.augmap.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including map_create, map_get_state, map_update, map_set_view, map_edit_places.
Make maps of places across the continental US with your AI assistant.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Create a map of places in the continental US. Returns map_id and map_url.
| Parameter | Type | Description |
|---|---|---|
| view | object | |
| title | string | Map title. |
| context | string | Traveler preferences and planning notes, e.g. seafood and playgrounds. Stored context is limited to 10,240 UTF-8 bytes. |
| app_name | string | Name shown for this app in the map sharing panel. |
| day_noun | string | The word the map numbers its days with, when they are not days: "House" for houses to tour gives House 1, House 2. Default "Day"; "" resets it. |
None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
| interests |
| array |
| request_id | string | Your id for this create: 1–64 letters, digits, hyphens or underscores. Signed in, a retry with the same id returns the same map; otherwise the retry is not charged twice. |
| destination | string | City or region in the continental US, e.g. Asheville, NC. |
| route_stops | boolean | Whether plan lists draw routes and travel times between their places. Default true; false is for lists that are not journeys, such as one list per area. |
| travel_mode | string | one of ["auto","bicycle","pedestrian"] |
| conversation_id | string | Your stable id for this conversation (≤64 chars, no ':', not 'user' or 'system'). With it, pending_changes lists only changes made by others. |
{
"name": "map_create",
"title": "Create map",
"description": "Create a map of places in the continental US. Returns map_id and map_url.",
"inputSchema": {
"type": "object",
"properties": {
"view": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"zoom": {
"type": "number",
"maximum": 16,
"minimum": 3
}
},
"additionalProperties": false
},
"title": {
"type": "string",
"description": "Map title."
},
"context": {
"type": "string",
"maxLength": 10000,
"description": "Traveler preferences and planning notes, e.g. seafood and playgrounds. Stored context is limited to 10,240 UTF-8 bytes."
},
"app_name": {
"type": "string",
"maxLength": 48,
"description": "Name shown for this app in the map sharing panel."
},
"day_noun": {
"type": "string",
"maxLength": 24,
"description": "The word the map numbers its days with, when they are not days: \"House\" for houses to tour gives House 1, House 2. Default \"Day\"; \"\" resets it."
},
"interests": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8
},
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Your id for this create: 1–64 letters, digits, hyphens or underscores. Signed in, a retry with the same id returns the same map; otherwise the retry is not charged twice."
},
"destination": {
"type": "string",
"description": "City or region in the continental US, e.g. Asheville, NC."
},
"route_stops": {
"type": "boolean",
"description": "Whether plan lists draw routes and travel times between their places. Default true; false is for lists that are not journeys, such as one list per area."
},
"travel_mode": {
"enum": [
"auto",
"bicycle",
"pedestrian"
],
"type": "string"
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64,
"description": "Your stable id for this conversation (≤64 chars, no ':', not 'user' or 'system'). With it, pending_changes lists only changes made by others."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"map_id",
"map_url",
"save_state"
],
"properties": {
"map_id": {
"type": "string"
},
"map_url": {
"type": "string"
},
"save_state": {
"enum": [
"unsaved",
"saved"
],
"type": "string"
},
"browser_url": {
"type": "string"
},
"draft_handle": {
"type": "string"
},
"draft_expires_at": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read a map: lists, places, save_state, version, pending_changes.
| Parameter | Type | Description |
|---|---|---|
| since | string | A version from an earlier response: pending_changes then lists others' changes after it. Default: since your own last change. |
| map_id | string | The map identifier from map_create or map_list. |
| share_url | string | A shared map's link (…/t/…), instead of map_id. Read-only. |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string |
{
"name": "map_get_state",
"title": "Get map state",
"description": "Read a map: lists, places, save_state, version, pending_changes.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"map_id"
]
},
{
"required": [
"share_url"
]
}
],
"oneOf": [
{
"required": [
"map_id"
]
},
{
"required": [
"share_url"
]
}
],
"properties": {
"since": {
"type": "string",
"maxLength": 64,
"description": "A version from an earlier response: pending_changes then lists others' changes after it. Default: since your own last change."
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$",
"description": "The map identifier from map_create or map_list."
},
"share_url": {
"type": "string",
"format": "uri",
"maxLength": 512,
"description": "A shared map's link (…/t/…), instead of map_id. Read-only."
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"map_url",
"title",
"save_state",
"travel_mode",
"day_noun",
"route_stops",
"lists",
"pending_changes"
],
"properties": {
"lists": {
"type": "array",
"items": {
"type": "object",
"required": [
"list_id",
"kind",
"name",
"places"
],
"properties": {
"kind": {
"enum": [
"plan",
"saved",
"rejected"
],
"type": "string"
},
"name": {
"type": "string"
},
"route": {
"type": "object",
"required": [
"distance_mi",
"duration_min"
],
"properties": {
"distance_mi": {
"type": "number",
"minimum": 0
},
"duration_min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"places": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry_id",
"name",
"place_id",
"point",
"status"
],
"properties": {
"name": {
"type": "string"
},
"point": {
"anyOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
},
"entry_id": {
"type": "string"
},
"place_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
},
"list_id": {
"type": "string"
},
"pinned_to": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
},
"title": {
"type": [
"string",
"null"
]
},
"access": {
"enum": [
"owner",
"editor",
"viewer"
],
"type": "string"
},
"map_id": {
"type": "string"
},
"map_url": {
"type": "string"
},
"version": {
"type": "string"
},
"day_noun": {
"type": "string"
},
"save_state": {
"enum": [
"unsaved",
"saved"
],
"type": "string"
},
"browser_url": {
"type": "string"
},
"route_stops": {
"type": "boolean"
},
"travel_mode": {
"enum": [
"auto",
"bicycle",
"pedestrian"
],
"type": "string"
},
"pending_changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"by",
"summary"
],
"properties": {
"by": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"changes_truncated": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Change a map's title, context, travel mode, interests, day noun or whether it routes between stops.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| map_id * | string | |
| context | object | Resulting stored context has a 10,240 UTF-8 byte limit. Retrying append repeats the text; replace is safe to retry. |
| day_noun | string | The word the map numbers its days with, when they are not days: "House" for houses to tour gives House 1, House 2. Default "Day"; "" resets it. |
| interests | array | |
| route_stops | boolean | Whether plan lists draw routes and travel times between their places. Default true; false is for lists that are not journeys, such as one list per area. |
| travel_mode | string | one of ["auto","bicycle","pedestrian"] |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string | |
| expected_version | string | The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version. |
{
"name": "map_update",
"title": "Update map settings",
"description": "Change a map's title, context, travel mode, interests, day noun or whether it routes between stops.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"title"
]
},
{
"required": [
"context"
]
},
{
"required": [
"travel_mode"
]
},
{
"required": [
"interests"
]
},
{
"required": [
"day_noun"
]
},
{
"required": [
"route_stops"
]
}
],
"required": [
"map_id"
],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"context": {
"type": "object",
"required": [
"text",
"mode"
],
"properties": {
"mode": {
"enum": [
"append",
"replace"
],
"type": "string"
},
"text": {
"type": "string",
"maxLength": 10240
}
},
"description": "Resulting stored context has a 10,240 UTF-8 byte limit. Retrying append repeats the text; replace is safe to retry.",
"additionalProperties": false
},
"day_noun": {
"type": "string",
"maxLength": 24,
"description": "The word the map numbers its days with, when they are not days: \"House\" for houses to tour gives House 1, House 2. Default \"Day\"; \"\" resets it."
},
"interests": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8
},
"route_stops": {
"type": "boolean",
"description": "Whether plan lists draw routes and travel times between their places. Default true; false is for lists that are not journeys, such as one list per area."
},
"travel_mode": {
"enum": [
"auto",
"bicycle",
"pedestrian"
],
"type": "string"
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
},
"expected_version": {
"type": "string",
"maxLength": 64,
"description": "The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Pan/zoom the live map.
| Parameter | Type | Description |
|---|---|---|
| zoom | number | |
| place | string | Existing entry_id or place name to center on; mutually exclusive with center. |
| center | any | Map center; provide exactly one of center or place. |
| map_id * | string | |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string |
{
"name": "map_set_view",
"title": "Move map view",
"description": "Pan/zoom the live map.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"center"
]
},
{
"required": [
"place"
]
}
],
"oneOf": [
{
"required": [
"center"
]
},
{
"required": [
"place"
]
}
],
"required": [
"map_id"
],
"properties": {
"zoom": {
"type": "number",
"maximum": 16,
"minimum": 3
},
"place": {
"type": "string",
"minLength": 1,
"description": "Existing entry_id or place name to center on; mutually exclusive with center."
},
"center": {
"anyOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"place_id"
],
"properties": {
"place_id": {
"type": "string",
"minLength": 1,
"description": "A returned place_id, including addr: ids."
}
},
"additionalProperties": false
}
],
"description": "Map center; provide exactly one of center or place."
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add, update, move, remove (park in rejected) or restore places. Each op result has the list_id and kind of the list it used.
| Parameter | Type | Description |
|---|---|---|
| ops * | array | |
| map_id * | string | |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string | |
| expected_version | string | The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version. |
{
"name": "map_edit_places",
"title": "Edit places",
"description": "Add, update, move, remove (park in rejected) or restore places. Each op result has the list_id and kind of the list it used.",
"inputSchema": {
"type": "object",
"required": [
"map_id",
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"op",
"place",
"to"
],
"properties": {
"op": {
"type": "string",
"const": "add"
},
"to": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"required": [
"new"
],
"properties": {
"new": {
"type": "string",
"minLength": 1,
"description": "Name of the list to create; an existing list of that kind and name is reused."
},
"kind": {
"enum": [
"plan",
"saved"
],
"type": "string",
"description": "plan (default): part of the map's plan, numbered and routed in order: days, tours, houses, venues or neighborhoods to visit or compare. saved: places kept aside as options, only when the traveler asks to save, keep or collect them (favorites, maybes, ideas)."
}
},
"additionalProperties": false
}
],
"description": "Destination: an existing list's list_id or name, or {\"new\": name} to create one."
},
"index": {
"type": "integer",
"minimum": 0,
"description": "Zero-based position in a plan list; omit to append."
},
"op_id": {
"type": "string",
"maxLength": 64
},
"place": {
"type": "object",
"anyOf": [
{
"required": [
"place_id"
]
},
{
"required": [
"point"
]
},
{
"required": [
"address"
]
},
{
"required": [
"geometry"
]
}
],
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"time": {
"type": "string"
},
"notes": {
"type": "string",
"maxLength": 2000
},
"phone": {
"type": "string",
"maxLength": 40
},
"point": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
"status": {
"enum": [
"tentative",
"confirmed",
"visited",
"skipped"
],
"type": "string"
},
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
},
"website": {
"type": "string",
"maxLength": 300
},
"category": {
"type": "string",
"maxLength": 100
},
"geometry": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "LineString"
},
"names": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
},
"description": "Optional: one name per line, in order; null for an unnamed line. The map labels each line."
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 2
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "MultiLineString"
},
"names": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
},
"description": "Optional: one name per line, in order; null for an unnamed line. The map labels each line."
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 2
},
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "Polygon"
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 4
},
"minItems": 1
}
},
"additionalProperties": false
}
],
"description": "GeoJSON [lng, lat] positions (optional altitude is discarded). Polygon rings close with the first position. At most 2000 positions total."
},
"place_id": {
"type": "string"
},
"duration_min": {
"type": "integer",
"minimum": 0
},
"travel_mode_to": {
"anyOf": [
{
"enum": [
"auto",
"bicycle",
"pedestrian"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"place",
"set"
],
"properties": {
"op": {
"type": "string",
"const": "update"
},
"set": {
"type": "object",
"anyOf": [
{
"required": [
"name"
]
},
{
"required": [
"point"
]
},
{
"required": [
"address"
]
},
{
"required": [
"geometry"
]
},
{
"required": [
"notes"
]
},
{
"required": [
"website"
]
},
{
"required": [
"phone"
]
},
{
"required": [
"time"
]
},
{
"required": [
"duration_min"
]
},
{
"required": [
"status"
]
},
{
"required": [
"travel_mode_to"
]
}
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"time": {
"type": "string"
},
"notes": {
"type": "string",
"maxLength": 2000
},
"phone": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
],
"description": "null removes the phone."
},
"point": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
"status": {
"enum": [
"tentative",
"confirmed",
"visited",
"skipped"
],
"type": "string"
},
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
},
"website": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
],
"description": "null removes the website."
},
"geometry": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "LineString"
},
"names": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
},
"description": "Optional: one name per line, in order; null for an unnamed line. The map labels each line."
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 2
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "MultiLineString"
},
"names": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
},
"description": "Optional: one name per line, in order; null for an unnamed line. The map labels each line."
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 2
},
"minItems": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"coordinates"
],
"properties": {
"type": {
"type": "string",
"const": "Polygon"
},
"coordinates": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 2,
"prefixItems": [
{
"type": "number",
"maximum": 180,
"minimum": -180
},
{
"type": "number",
"maximum": 90,
"minimum": -90
},
{
"type": "number"
}
]
},
"maxItems": 2000,
"minItems": 4
},
"minItems": 1
}
},
"additionalProperties": false
}
],
"description": "GeoJSON [lng, lat] positions (optional altitude is discarded). Polygon rings close with the first position. At most 2000 positions total."
},
{
"type": "null"
}
],
"description": "null removes the geometry."
},
"duration_min": {
"type": "integer",
"minimum": 0
},
"travel_mode_to": {
"anyOf": [
{
"enum": [
"auto",
"bicycle",
"pedestrian"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"op_id": {
"type": "string",
"maxLength": 64
},
"place": {
"type": "string",
"minLength": 1,
"description": "entry_id from map_get_state, or the place's name (a string)."
}
},
"additionalProperties": false
},
{
"type": "object",
"anyOf": [
{
"required": [
"to"
]
},
{
"required": [
"index"
]
}
],
"required": [
"op",
"place"
],
"properties": {
"op": {
"type": "string",
"const": "move"
},
"to": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"required": [
"new"
],
"properties": {
"new": {
"type": "string",
"minLength": 1,
"description": "Name of the list to create; an existing list of that kind and name is reused."
},
"kind": {
"enum": [
"plan",
"saved"
],
"type": "string",
"description": "plan (default): part of the map's plan, numbered and routed in order: days, tours, houses, venues or neighborhoods to visit or compare. saved: places kept aside as options, only when the traveler asks to save, keep or collect them (favorites, maybes, ideas)."
}
},
"additionalProperties": false
}
],
"description": "Destination: an existing list's list_id or name, or {\"new\": name} to create one."
},
"index": {
"type": "integer",
"minimum": 0,
"description": "Zero-based position in a plan list; omit to append."
},
"op_id": {
"type": "string",
"maxLength": 64
},
"place": {
"type": "string",
"minLength": 1,
"description": "entry_id from map_get_state, or the place's name (a string)."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"place"
],
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"op_id": {
"type": "string",
"maxLength": 64
},
"place": {
"type": "string",
"minLength": 1,
"description": "entry_id from map_get_state, or the place's name (a string)."
},
"reason": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"place"
],
"properties": {
"op": {
"type": "string",
"const": "restore"
},
"to": {
"type": "string",
"minLength": 1,
"description": "An existing list. Default: the list it came from; if gone, Unscheduled."
},
"index": {
"type": "integer",
"minimum": 0,
"description": "Zero-based position in a plan list; omit to append."
},
"op_id": {
"type": "string",
"maxLength": 64
},
"place": {
"type": "string",
"minLength": 1,
"description": "entry_id from map_get_state, or the place's name (a string)."
}
},
"additionalProperties": false
}
]
},
"maxItems": 50,
"minItems": 1
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
},
"expected_version": {
"type": "string",
"maxLength": 64,
"description": "The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create, update (rename, change kind, pin a saved list to a plan list) or delete lists. A plan list's date goes in its name ("Sat, Oct 3 · Acadia"). Deleting a list moves its places to Unscheduled or to. Each op result has the list_id and kind of the list it used.
| Parameter | Type | Description |
|---|---|---|
| ops * | array | |
| map_id * | string | |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string | |
| expected_version | string | The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version. |
{
"name": "map_edit_lists",
"title": "Edit lists",
"description": "Create, update (rename, change kind, pin a saved list to a plan list) or delete lists. A plan list's date goes in its name (\"Sat, Oct 3 · Acadia\"). Deleting a list moves its places to Unscheduled or to. Each op result has the list_id and kind of the list it used.",
"inputSchema": {
"type": "object",
"required": [
"map_id",
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"op",
"name"
],
"properties": {
"op": {
"type": "string",
"const": "create"
},
"kind": {
"enum": [
"plan",
"saved"
],
"type": "string",
"description": "plan (default): part of the map's plan, numbered and routed in order: days, tours, houses, venues or neighborhoods to visit or compare. saved: places kept aside as options, only when the traveler asks to save, keep or collect them (favorites, maybes, ideas)."
},
"name": {
"type": "string",
"minLength": 1
},
"op_id": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
{
"type": "object",
"anyOf": [
{
"required": [
"name"
]
},
{
"required": [
"kind"
]
},
{
"required": [
"pinned_to"
]
}
],
"required": [
"op",
"list"
],
"properties": {
"op": {
"type": "string",
"const": "update"
},
"kind": {
"enum": [
"plan",
"saved"
],
"type": "string",
"description": "Convert to this kind; list_id stays."
},
"list": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"description": "New name; list_id stays."
},
"op_id": {
"type": "string",
"maxLength": 64
},
"pinned_to": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
],
"description": "Saved lists: the plan list it belongs to; null unpins."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"list"
],
"properties": {
"op": {
"type": "string",
"const": "delete"
},
"to": {
"type": "string",
"minLength": 1,
"description": "An existing list for its places; default Unscheduled."
},
"list": {
"type": "string",
"minLength": 1
},
"op_id": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
}
]
},
"maxItems": 20,
"minItems": 1
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
},
"expected_version": {
"type": "string",
"maxLength": 64,
"description": "The version you planned this edit from. If someone else has since changed what it touches, nothing is applied and the result is a conflict with their changes and the current version."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Find places and street addresses in the continental US for an existing map_id. Returns places and fields_granted per query.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| queries * | array | |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
| conversation_id | string |
{
"name": "map_search_places",
"title": "Search places",
"description": "Find places and street addresses in the continental US for an existing map_id. Returns places and fields_granted per query.",
"inputSchema": {
"type": "object",
"required": [
"map_id",
"queries"
],
"properties": {
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"queries": {
"type": "array",
"items": {
"type": "object",
"anyOf": [
{
"required": [
"name"
]
},
{
"required": [
"place_id"
]
},
{
"required": [
"near"
]
},
{
"required": [
"text"
]
},
{
"required": [
"along_route"
]
}
],
"properties": {
"city": {
"type": "string",
"minLength": 1,
"description": "City for name or text search; text search covers a town-sized area about the city's center (scale changes it), not municipal boundaries."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Place-name lookup (partial names may match), optionally with city or near. Not combined with text, place_id or along_route."
},
"near": {
"anyOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"place_id"
],
"properties": {
"place_id": {
"type": "string",
"minLength": 1,
"description": "A returned place_id, including addr: ids."
}
},
"additionalProperties": false
}
],
"description": "Center for nearby/text search (takes precedence over city/state), or location bias for name lookup. Not combined with along_route."
},
"text": {
"type": "string",
"minLength": 1,
"description": "Ordinary place search, e.g. {\"text\":\"seafood restaurant\",\"city\":\"Portland\",\"state\":\"ME\"}. Provide city/state or near to locate the search; along_route is only for an actual route."
},
"label": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Maximum results, default 12, independent of requested fields. Search uses a bounded candidate pool, not an exhaustive catalog scan."
},
"scale": {
"enum": [
"neighborhood",
"town",
"area",
"region"
],
"type": "string",
"description": "Search size about near or the city: neighborhood (~3 km), town (~10 km, a city's default), area (~25 km, near's default), region (~75 km). A sparse text search widens and returns expanded:true. Not with radius_km."
},
"state": {
"type": "string",
"minLength": 1,
"description": "US state for name or text search, e.g. ME, to disambiguate the city. Coverage still depends on the server environment."
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Extra columns: 'hours', 'detail', 'amenity:pool', 'score', 'snippet'. Only these are supported; fields_granted lists what was returned."
},
"category": {
"type": "string",
"description": "Category for name or text search; not used by route, nearby-only or ID lookup."
},
"open_day": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string",
"description": "Excludes known-closed places that day, retaining unknown hours. Text, nearby or route search."
},
"open_now": {
"type": "boolean",
"description": "Excludes known-closed places; unknown hours remain. Text, nearby or route search, not name/ID lookup."
},
"place_id": {
"type": "string",
"minLength": 1,
"description": "Lookup by a returned place_id; not combined with other search selectors."
},
"radius_km": {
"type": "number",
"description": "Hard maximum distance from the resolved center for text or nearby search; not a route corridor width. Requires near or a city/map center. Not with scale.",
"exclusiveMinimum": 0
},
"along_route": {
"anyOf": [
{
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"type": "string",
"minLength": 1,
"description": "A plan list (list_id or name) with a computed route."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"anyOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"place_id"
],
"properties": {
"place_id": {
"type": "string",
"minLength": 1,
"description": "A returned place_id, including addr: ids."
}
},
"additionalProperties": false
}
],
"description": "{lat, lng}, {address} or {place_id}."
},
"start": {
"anyOf": [
{
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 300,
"minLength": 3,
"description": "Street address with house number, e.g. '233 S Wacker Dr, Chicago, IL'. Include town and state when known."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"place_id"
],
"properties": {
"place_id": {
"type": "string",
"minLength": 1,
"description": "A returned place_id, including addr: ids."
}
},
"additionalProperties": false
}
],
"description": "{lat, lng}, {address} or {place_id}."
}
},
"additionalProperties": false
}
],
"description": "Places within a 3 km corridor of an actual route, returned in route order. Exactly one form: an existing plan list, OR both endpoints. detour_mi is perpendicular offset, not additional travel distance. Omit entirely for ordinary text search; never send an empty object."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
},
"conversation_id": {
"type": "string",
"pattern": "^(?!user$|system$)[^:\\x00-\\x1f\\x7f-\\x9f\\u2028\\u2029]*$",
"maxLength": 64
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Save a map to the traveler's account.
| Parameter | Type | Description |
|---|---|---|
| map_id * | string | |
| draft_handle | string | The draft_handle map_create returned; unsaved maps only. |
{
"name": "map_save",
"title": "Save map to account",
"description": "Save a map to the traveler's account.",
"inputSchema": {
"type": "object",
"required": [
"map_id"
],
"properties": {
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"draft_handle": {
"type": "string",
"description": "The draft_handle map_create returned; unsaved maps only."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the traveler's saved maps, and maps shared with them, with their map_id and map_url.
| Parameter | Type | Description |
|---|---|---|
| limit | integer |
{
"name": "map_list",
"title": "List saved maps",
"description": "List the traveler's saved maps, and maps shared with them, with their map_id and map_url.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create, list or revoke links that let other people view a saved map or join it as editors, change a link's role, or list and manage the people who joined.
| Parameter | Type | Description |
|---|---|---|
| op * | string | one of ["create","list","revoke","set_role","list_members","remove_member","set_member_role"] |
| role | string | Required for set_role and set_member_role; optional for create (default viewer). viewer can look; editor invites people to edit once they sign in. |
| label | string | Who the link is for. create with the same label and role returns the same link. |
| map_id * | string | |
| link_id | string | Required for revoke/set_role: link_id returned by map_share list. |
| member_id | string | Required for remove_member/set_member_role: member_id from list_members. |
{
"name": "map_share",
"title": "Share map",
"description": "Create, list or revoke links that let other people view a saved map or join it as editors, change a link's role, or list and manage the people who joined.",
"inputSchema": {
"type": "object",
"anyOf": [
{
"required": [
"op"
],
"properties": {
"op": {
"const": "create"
},
"link_id": false,
"member_id": false
}
},
{
"required": [
"op"
],
"properties": {
"op": {
"const": "list"
},
"role": false,
"label": false,
"link_id": false,
"member_id": false
}
},
{
"required": [
"op",
"link_id"
],
"properties": {
"op": {
"const": "revoke"
},
"role": false,
"label": false,
"member_id": false
}
},
{
"required": [
"op",
"link_id",
"role"
],
"properties": {
"op": {
"const": "set_role"
},
"label": false,
"member_id": false
}
},
{
"required": [
"op"
],
"properties": {
"op": {
"const": "list_members"
},
"role": false,
"label": false,
"link_id": false,
"member_id": false
}
},
{
"required": [
"op",
"member_id"
],
"properties": {
"op": {
"const": "remove_member"
},
"role": false,
"label": false,
"link_id": false
}
},
{
"required": [
"op",
"member_id",
"role"
],
"properties": {
"op": {
"const": "set_member_role"
},
"label": false,
"link_id": false
}
}
],
"required": [
"map_id",
"op"
],
"properties": {
"op": {
"enum": [
"create",
"list",
"revoke",
"set_role",
"list_members",
"remove_member",
"set_member_role"
],
"type": "string"
},
"role": {
"enum": [
"viewer",
"editor"
],
"type": "string",
"description": "Required for set_role and set_member_role; optional for create (default viewer). viewer can look; editor invites people to edit once they sign in."
},
"label": {
"type": "string",
"maxLength": 48,
"description": "Who the link is for. create with the same label and role returns the same link."
},
"map_id": {
"type": "string",
"pattern": "^[a-z0-9_-]{1,64}$"
},
"link_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}$",
"description": "Required for revoke/set_role: link_id returned by map_share list."
},
"member_id": {
"type": "string",
"pattern": "^[0-9a-f]{16}$",
"description": "Required for remove_member/set_member_role: member_id from list_members."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Augmap makes maps of places in the continental United States (the lower 48 states and DC): restaurants, trails, lodging and street addresses, organized into lists and days. Planning a trip is one use. Use it only when a request needs places mapped, found, organized or shared, or an Augmap account action. General knowledge, weather-only questions and places outside the continental US (Alaska, Hawaii, other countries) need no Augmap calls. Reuse a known map. Find saved maps when the traveler refers to an earlier saved map; a new map needs no account lookup. For a new map call map_create, e.g. {"title":"Portland walk","destination":"Portland, ME","context":"Food and waterfront for two","travel_mode":"pedestrian"}. A place search also needs map_create first when no map_id is available. It returns map_id and map_url. Give the traveler map_url, keep map_id for calls, and never invent either. Include map_url when reporting a change. Results: structuredContent and the JSON text in content contain the same complete tool result. Read whichever your host provides; do not process both as separate results. Access: map_id is an identifier and grants nothing. Signed-in connections save new maps to the account at creation (request_id deduplicates retries) and need no draft_handle. Anonymous creation also returns draft_handle and draft_expires_at: the handle opens this unsaved map only. Pass it on every call for the map. The map opens until draft_expires_at, which edits do not extend; after that it is archived, and it opens again only once saved to an account. Tell the traveler that date when you give them map_url. Once the map is saved to an account, draft_handle stops working: sign-in decides, and a signed-in call ignores it. Explicit nonblank handles override X-Augmap-Draft-Handle; blank is absent, invalid explicit handles fail without fallback. Share links are for people, never credentials. To read a map from a share link the traveler gives you, call map_get_state with share_url instead of map_id: nothing is saved or copied. access viewer is read-only, without context or rejected places; if this account can already open the map, the result also has map_id for edits. Never publish draft_handle. browser_url is a private one-time editor handoff for your browser, valid five minutes; the traveler gets map_url. Resources: read map://maps to find saved account maps (sign-in required; map_list is the tool fallback). Read map://{map_id}/lists for list summaries and their resource URIs, then the needed map://{map_id}/lists/{list_id} instead of the whole map. State, context and history also have resources; presets/vocab describe supported values. Map resources require account access or X-Augmap-Draft-Handle; never put credentials in URIs. If your host cannot read resources or send that header, use map_get_state with draft_handle. Reads change nothing and are safe to repeat. Map responses carry version and pending_changes: others' changes since your last change, or since the version you pass as since. Mention others' changes before editing. Lists: each list has a kind. plan lists are the map's plan, numbered and routed in order: days, tours, venues to visit or compare, or one per house or neighborhood: the place plus what is around it (set day_noun, e.g. House 1, House 2). saved lists keep places aside as options; use saved only when the traveler asks to save, keep or collect places, such as favorites, maybes or ideas. When unclear, use plan. Every map has rejected; a deleted list's places go to Unscheduled. A string in to points at an existing list (list_id or name); to put a place in a new list, pass to:{"new":"<name>"} or to:{"new":"Maybe","kind":"saved"}. list_id is stable; use it once you have it. map_edit_lists creates, updates (name, kind, pinned_to) and deletes lists. Pin example: {"map_id":"<returned id>","ops":[{"op":"update","list":"rainy-day","pinned_to":"plan-2"}]}. Places: search first; add a result by its place_id and name, and the
Names, descriptions and schemas were written by the server and are shown as data.