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].text as a JSON string.
• Distance is in kilometers, speed in km/h, altitude in meters.