LatLong Maps
Turn CSV or Excel data into styled choropleth and categorical maps of India from plain language.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"map-mcp": {
"url": "https://geocp.latlong.ai/mcp/"
}
}
}원격 엔드포인트
https://geocp.latlong.ai/mcp/streamable-http할 수 있는 일
도구 목록
도구 (5)
🟡geocode(file_key, address_column, address_columns, compose_columns, sheet, ...)
Geocode addresses from an uploaded CSV or XLSX file into latitude/longitude. Pass a file_key from upload_file. Column selection: if you know it, pass address_column (or address_columns for several). Otherwise the server asks the geo-match service to detect it. When the answer is not unambiguous — several address columns, a weak match, or only structured columns like District/State/PIN that must be combined — the response is status=clarification_required with candidates and ready-to-fire guidance actions. Present the choice to the user and re-call with their answer; never invent a column name. The result overwrites the same file_key as a new version, plus a small preview, not the full rows. Pass that file_key to question_to_map to map the coordinates, or hand the user file_url (a signed download link, when present) to fetch the file directly.
입력 스키마
{
"type": "object",
"properties": {
"file_key": {
"type": "string"
},
"address_column": {
"type": "string"
},
"address_columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"compose_columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"sheet": {
"type": "string"
},
"job_id": {
"type": "string"
},
"force_new": {
"type": "boolean"
}
},
"additionalProperties": false
}🟢get_capabilities
Return the server's capability matrix: supported map types, geo types, output formats, classification methods, and the list of tools available in this process (which varies by configuration). Call this first to discover what the server can do.
입력 스키마
{
"type": "object",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"map_types": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"geo_levels": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"output_formats": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"default_output": {
"type": "string"
},
"classification_methods": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"available_indices": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"index_modes": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"geo_detection": {
"type": "boolean"
},
"auto_level_detection": {
"type": "boolean"
},
"svg_default": {
"type": "boolean"
},
"png_supported": {
"type": "boolean"
},
"stateless_only": {
"type": "boolean"
},
"available_tools": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"guidance": {
"type": [
"null",
"object"
],
"properties": {
"next_actions": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments_from": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
},
"reason": {
"type": "string"
}
},
"required": [
"id",
"label",
"tool"
],
"additionalProperties": false
}
},
"allow_freeform": {
"type": "boolean"
},
"next_steps_text": {
"type": "string"
}
},
"required": [
"next_actions",
"allow_freeform",
"next_steps_text"
],
"additionalProperties": false
}
},
"required": [
"map_types",
"geo_levels",
"output_formats",
"default_output",
"classification_methods",
"available_indices",
"index_modes",
"geo_detection",
"auto_level_detection",
"svg_default",
"png_supported",
"stateless_only",
"available_tools"
],
"additionalProperties": false
}🟡question_to_map(question, data, file_key, sheet, geo_column, ...)
Render a geographic map from your data. Call upload_file first to ingest a CSV/XLSX file, then pass the returned file_key: {"question": "show total by pincode", "file_key": "mcp-uploads/2026/01/15/<uuid>.csv"}. The file_key is reusable — for additional questions on the same file, pass the same file_key again without re-uploading. Alternatively, pass rows directly as 'data' (e.g. from the upload_file preview): {"question": "show total by pincode", "data": [<rows>]} geo_column and value_column are preferred if easily identifiable from the column names, but not required — the server auto-detects them using a geo-match service that matches your data against known Indian geographies (states, districts, ACs, PCs, pincodes, RTOs, cities). Hints: geo_column usually contains place names (state, district, city, pincode, constituency) or numeric codes (pincode=560049); value_column usually contains the metric to plot (sales, count, total, percentage) or a category (party affiliation, status, type). If value_column is 'total' and doesn't exist in data, all numeric columns are summed automatically. String value columns render as categorical maps (each distinct value gets its own color, e.g. party affiliation). If the server cannot determine which columns to use, it returns a 'clarification_required' response with suggested columns and guidance — pick a geo_column and value_column from the suggestions and re-call. Supported geo types: state, district, pincode, rto, city, ac, pc. Points mode: if your file has latitude/longitude columns (e.g. from a prior geocoding step, or coordinates you already had) and your question asks to plot/pin/mark locations ("plot my stores", "show me the outlet locations", "mark these points"), the server detects the coordinate columns automatically and renders markers instead of shaded regions — no geo_column/value_column needed. The boundary lines drawn beneath the markers and how far the map zooms are chosen automatically from where the points actually fall (tightens to a state or district for a local cluster, falls back to all-India for a nationwide spread); you can also name a level explicitly ("plot by assembly constituency", "rto wise") to force it. A response may report points that fall outside every boundary (e.g. offshore or swapped lat/lon) — check for that in the warnings.
입력 스키마
{
"type": "object",
"properties": {
"question": {
"type": "string"
},
"data": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"additionalProperties": true
}
},
"file_key": {
"type": "string"
},
"sheet": {
"type": "string"
},
"geo_column": {
"type": "string"
},
"value_column": {
"type": "string"
},
"table": {
"type": "string"
},
"enrich_with": {
"type": [
"null",
"object"
],
"properties": {
"table": {
"type": "string"
},
"columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"join_on": {
"type": "string"
}
},
"required": [
"table",
"columns"
],
"additionalProperties": false
},
"detected_geo": {
"type": [
"null",
"object"
],
"properties": {
"column": {
"type": "string"
},
"geo_type": {
"type": "string"
},
"confidence": {
"type": "number"
},
"matched_count": {
"type": "integer"
},
"total_count": {
"type": "integer"
},
"parent": {
"type": "string"
}
},
"required": [
"column",
"geo_type",
"confidence",
"matched_count",
"total_count"
],
"additionalProperties": false
},
"render_params": {
"type": "object",
"additionalProperties": true
},
"output_format": {
"type": "string"
},
"style": {
"type": "object",
"additionalProperties": true
},
"geo_level": {
"type": "string"
},
"map_type": {
"type": "string"
},
"state_hint": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"question"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"mode": {
"type": "string"
},
"resolved_params": {
"type": [
"null",
"object"
],
"properties": {
"map_type": {
"type": "string"
},
"geo_type": {
"type": "string"
},
"geo_column": {
"type": "string"
},
"value_column": {
"type": "string"
},
"state_hint": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"style": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"map_type",
"geo_type",
"geo_column",
"value_column"
],
"additionalProperties": false
},
"resolution_method": {
"type": "string"
},
"confidence": {
"type": "number"
},
"map": {
"type": [
"null",
"object"
],
"properties": {
"url": {
"type": "string"
},
"html_url": {
"type": "string"
},
"format": {
"type": "string"
},
"render_id": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"dimensions": {
"type": [
"null",
"object"
],
"properties": {
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
"join_summary": {
"type": [
"null",
"object"
],
"properties": {
"matched": {
"type": "integer"
},
"unmatched": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"matched",
"unmatched",
"total"
],
"additionalProperties": false
},
"title": {
"type": "string"
},
"subtitle": {
"type": "string"
},
"total_value": {
"type": "string"
},
"active_count": {
"type": "integer"
},
"total_count": {
"type": "integer"
},
"value_label": {
"type": "string"
},
"geo_scope": {
"type": "string"
},
"svg_url": {
"type": "string"
},
"preview_image_base64": {
"type": "string"
},
"mime_type": {
"type": "string"
}
},
"required": [
"url",
"format",
"render_id"
],
"additionalProperties": false
},
"computed_data": {
"type": [
"null",
"object"
],
"properties": {
"columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"rows": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"additionalProperties": true
}
},
"total_rows": {
"type": "integer"
},
"returned_rows": {
"type": "integer"
},
"sort_column": {
"type": "string"
},
"sort_order": {
"type": "string"
}
},
"required": [
"columns",
"rows",
"total_rows",
"returned_rows"
],
"additionalProperties": false
},
"aggregation_applied": {
"type": [
"null",
"object"
],
"properties": {
"original_rows": {
"type": "integer"
},
"aggregated_rows": {
"type": "integer"
},
"method": {
"type": "string"
},
"grouped_by": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"original_rows",
"aggregated_rows",
"method",
"note"
],
"additionalProperties": false
},
"level_resolution": {
"type": [
"null",
"object"
],
"properties": {
"datasets": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"source": {
"type": "string"
},
"level": {
"type": "string"
},
"geo_col": {
"type": "string"
},
"rows": {
"type": "integer"
}
},
"required": [
"source",
"level",
"geo_col",
"rows"
],
"additionalProperties": false
}
},
"resolved_level": {
"type": "string"
},
"method": {
"type": "string"
},
"aggregations": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"dataset": {
"type": "string"
},
"from_level": {
"type": "string"
},
"to_level": {
"type": "string"
},
"method": {
"type": "string"
},
"columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"dataset",
"from_level",
"to_level",
"method",
"columns"
],
"additionalProperties": false
}
},
"reason": {
"type": "string"
},
"alternatives": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"datasets",
"resolved_level",
"method"
],
"additionalProperties": false
},
"guidance": {
"type": [
"null",
"object"
],
"properties": {
"next_actions": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments_from": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
},
"reason": {
"type": "string"
}
},
"required": [
"id",
"label",
"tool"
],
"additionalProperties": false
}
},
"allow_freeform": {
"type": "boolean"
},
"next_steps_text": {
"type": "string"
}
},
"required": [
"next_actions",
"allow_freeform",
"next_steps_text"
],
"additionalProperties": false
},
"usage": {
"type": [
"null",
"object"
],
"properties": {
"this_call": {
"type": "integer"
},
"breakdown": {
"type": "object",
"additionalProperties": {
"type": "integer"
}
},
"month_used": {
"type": "integer"
},
"month_limit": {
"type": "integer"
},
"month_remaining": {
"type": "integer"
}
},
"required": [
"this_call",
"breakdown",
"month_used",
"month_limit",
"month_remaining"
],
"additionalProperties": false
},
"clarification": {
"type": [
"null",
"object"
],
"properties": {
"status": {
"type": "string"
},
"message": {
"type": "string"
},
"columns": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"class": {
"type": "string"
}
},
"required": [
"name",
"type",
"class"
],
"additionalProperties": false
}
},
"suggested_geo_columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"suggested_value_columns": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"guidance": {
"type": [
"null",
"object"
],
"properties": {
"next_actions": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"tool": {
"type": "string"
},
"arguments_from": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
},
"reason": {
"type": "string"
}
},
"required": [
"id",
"label",
"tool"
],
"additionalProperties": false
}
},
"allow_freeform": {
"type": "boolean"
},
"next_steps_text": {
"type": "string"
}
},
"required": [
"next_actions",
"allow_freeform",
"next_steps_text"
],
"additionalProperties": false
}
},
"required": [
"status",
"message",
"columns",
"suggested_geo_columns",
"suggested_value_columns"
],
"additionalProperties": false
},
"warnings": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"points_plotted": {
"type": "integer"
},
"points_rejected": {
"type": "integer"
},
"rejected_rows": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
}
},
"required": [
"mode"
],
"additionalProperties": false
}🟡reverse_geocode(file_key, latitude_column, longitude_column, latlong_column, coordinate_pairs, ...)
Turn latitude/longitude coordinates in an uploaded CSV or XLSX into addresses. Pass a file_key from upload_file. Column selection: pass latitude_column and longitude_column, or latlong_column for a single combined column, or coordinate_pairs for several sets. Otherwise the server detects them. When the answer is not unambiguous — several coordinate columns, a weak match, coordinates outside the supported region, or coarse whole-number values — the response is status=clarification_required. Present the choice to the user and re-call with their answer. Results are written back into the uploaded file: the response carries file_key, a signed file_url, and a small preview. Each pair adds address, pincode, landmark and status columns.
입력 스키마
{
"type": "object",
"properties": {
"file_key": {
"type": "string"
},
"latitude_column": {
"type": "string"
},
"longitude_column": {
"type": "string"
},
"latlong_column": {
"type": "string"
},
"coordinate_pairs": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"latitude_column": {
"type": "string"
},
"longitude_column": {
"type": "string"
},
"latlong_column": {
"type": "string"
}
},
"additionalProperties": false
}
},
"sheet": {
"type": "string"
},
"accept_low_precision": {
"type": "boolean"
},
"job_id": {
"type": "string"
},
"force_new": {
"type": "boolean"
}
},
"additionalProperties": false
}🟡upload_file(file_name, file_size, question, sheet, file_key)
Upload a CSV or XLSX file for server-side ingestion under policy (auth, size cap, malware scan, injected-intent scan) and receive a file_key. This is the first step before calling question_to_map with your own data. Step 1: Call upload_file with file_name, file_size, and question. The response contains a signed upload_url and a curl command — run the curl command to POST the file bytes. The curl response contains file_key, columns, a row preview, and optionally 'intent' (geo-match service detected geo_column, geo_level, value_column, map_type, confidence) and 'guidance' (a ready-to-fire question_to_map action with all detected parameters pre-filled). Forward the intent fields into question_to_map to skip auto-detection and render immediately. For multi-sheet XLSX: the curl response is 'sheet_selection_required' with a file_key and sheets list. Pass file_key and sheet to question_to_map (or any other tool that accepts file_key) — do not call upload_file again. After upload, pass the returned file_key to question_to_map to render a map from the full dataset. The file_key is reusable — for additional questions on the same file, pass the same file_key again without re-uploading. When the upload response includes 'guidance', use its next_actions directly for a zero-round-trip render.
입력 스키마
{
"type": "object",
"properties": {
"file_name": {
"type": "string"
},
"file_size": {
"type": "integer"
},
"question": {
"type": "string"
},
"sheet": {
"type": "string"
},
"file_key": {
"type": "string"
}
},
"required": [
"file_name",
"file_size"
],
"additionalProperties": false
}권장 프롬프트
get_capabilitiesget_capabilities커뮤니티
증거