Geomanic

Query and manage GPS travel data from Geomanic — your privacy-first GPS tracking platform.

Install

openclaw skills install geomanic

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.