Augmap MCP
An official MCP server for Augmap that enables AI agents to create, search for, and save travel trips and maps across the continental United States. It supports anonymous planning and authenticated sessions via OAuth 2.1 PKCE for saving maps to user accounts, allowing agents to manage itineraries and place data programmatically.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
asking to save the trip (map_save) starts OAuth 2.1 sign-in (Authorization Code + PKCE S256; device flow is not supported)sign the MCP connection in to the owning account (OAuth 2.1 PKCE or an app key from Settings → Connected apps → Add an app)
MCP endpoint (Streamable HTTP)
https://mcp.augmap.ai/mcpWhat its tools do
10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (3)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to augmap.ai ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Create a new travel trip or map
- Search for places across the continental US
- Save a trip to an Augmap account via OAuth
- Resume an existing saved trip using map_id
Source and maintenance
Vendor evidenceRegistry 1.0.0
Protocol and capabilities
- Server
- augmap-map 1.0.0+ae8f6ea3
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 10 advertised
- Resources
- 4 advertised
- Resource templates
- 5 advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
10 advertised
map_create — Create map
Create a map of places in the continental US. Returns map_id and map_url.
map_create input schema
{
"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
}map_create output schema
{
"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": {}
}map_create annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}map_get_state — Get map state
Advertised read-only
Read a map: lists, places, save_state, version, pending_changes.
map_get_state input schema
{
"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
}map_get_state output schema
{
"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": {}
}map_get_state annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}map_update — Update map settings
Advertised destructive
Change a map's title, context, travel mode, interests, day noun or whether it routes between stops.
map_update input schema
{
"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
}map_update annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}map_set_view — Move map view
Pan/zoom the live map.
map_set_view input schema
{
"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
}map_set_view annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}map_edit_places — Edit places
Advertised destructive
Add, update, move, remove (park in rejected) or restore places. Each op result has the list_id and kind of the list it used.
map_edit_places input schema
{
"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
}map_edit_places annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}map_edit_lists — Edit lists
Advertised destructive
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.
map_edit_lists input schema
{
"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
}map_edit_lists annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}map_search_places — Search places
Advertised read-only
Find places and street addresses in the continental US for an existing map_id. Returns places and fields_granted per query.
map_search_places input schema
{
"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
}map_search_places annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}map_save — Save map to account
Save a map to the traveler's account.
map_save input schema
{
"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
}map_save annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}map_list — List saved maps
Advertised read-only
List the traveler's saved maps, and maps shared with them, with their map_id and map_url.
map_list input schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
}
},
"additionalProperties": false
}map_list annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}map_share — Share map
Advertised destructive
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.
map_share input schema
{
"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
}map_share annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}Prompts
Not advertised
Resources
4 advertised
account-maps
account-maps URI
map://mapspresets
presets URI
map://presetsvocab
vocab URI
map://vocabversion
version URI
map://versionmap-lists
map-lists URI template
map://{map_id}/listsmap-list
map-list URI template
map://{map_id}/lists/{list_id}map-state
map-state URI template
map://{map_id}/statemap-context
map-context URI template
map://{map_id}/contextmap-history
map-history URI template
map://{map_id}/history90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1192 ms
- 95th percentile latency
- 1192 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1192 ms · metadata changed · 10 tool(s), 4 resource(s), 5 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http augmap-mcp https://mcp.augmap.ai/mcpCodex
Codex configuration
codex mcp add augmap-mcp --url https://mcp.augmap.ai/mcpCursor
Cursor configuration
{
"mcpServers": {
"augmap-mcp": {
"url": "https://mcp.augmap.ai/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"augmap-mcp": {
"type": "streamableHttp",
"url": "https://mcp.augmap.ai/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"augmap-mcp": {
"type": "http",
"url": "https://mcp.augmap.ai/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http augmap-mcp https://mcp.augmap.ai/mcpClaude Desktop
Claude Desktop configuration
https://mcp.augmap.ai/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"augmap-mcp": {
"serverUrl": "https://mcp.augmap.ai/mcp"
}
}
}Let your agent find its tools
Find servers like Augmap MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run Augmap MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.