dvcrn Geomanic Skill
This skill connects to the Geomanic MCP API to query travel statistics, manage waypoints, and analyze journeys.
Authentication
The API key is stored in the environment variable GEOMANIC_TOKEN. All requests must include it as a Bearer token.
How to call the API
Use curl via the exec tool to send JSON-RPC requests to https://geomanic.com/api/v1/mcp:
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GEOMANIC_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{...}}}'
Available tools
get_statistics
Get aggregated travel statistics for a time period. Returns total distance (km), average/max speed (km/h), altitude, waypoint count, active days, and country breakdown with full/part days.
Required parameters: from (ISO 8601), to (ISO 8601).
Optional: suppress_flights (boolean, default true).
Example:
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GEOMANIC_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_statistics","arguments":{"from":"2026-02-22T00:00:00Z","to":"2026-02-22T23:59:59Z"}}}'
get_date_range
Get the earliest and latest waypoint dates for the user. No parameters required.
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GEOMANIC_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_date_range","arguments":{}}}'
list_waypoints
List waypoints with optional time range, pagination, and sorting.
Optional parameters: from, to (ISO 8601), limit (default 50, max 200), offset (default 0), order ("asc" or "desc", default "desc").
curl -s -X POST https://geomanic.com/api/v1/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GEOMANIC_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_waypoints","arguments":{"from":"2026-02-22T00:00:00Z","to":"2026-02-22T23:59:59Z","limit":10}}}'
get_waypoint
Get a single waypoint by UUID.
Required: id (string, UUID).
create_waypoint
Create a new GPS waypoint.
Required: timestamp_utc (ISO 8601), latitude (number), longitude (number).
Optional: speed_kmh, altitude, heading_deg, device_id.
update_waypoint
Update an existing waypoint by UUID.
Required: id (string, UUID).
Optional: latitude, longitude, speed_kmh, altitude, heading_deg, country_iso, place, device_id.
delete_waypoint
Delete a waypoint by UUID.
Required: id (string, UUID).
Important notes
- All dates must be in ISO 8601 format with timezone (use UTC with Z suffix).
- For "today" queries, use the current date with T00:00:00Z to T23:59:59Z.
- The response is JSON-RPC. The actual data is inside
result.content[0].textas a JSON string. - Distance is in kilometers, speed in km/h, altitude in meters.