✓ Verified 🛒 E-commerce ✓ Enhanced Data

Geomanic

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

Rating: 4.4 (206 reviews)
Downloads: 1,032 downloads
Version: 1.0.0

Overview

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

Complete Documentation

View Source →

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:

bash

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:

bash

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.

bash

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").

bash

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.

Installation

Terminal bash


openclaw install geomanic

Copied!

💻Code Examples

-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{...}}}'

--d-jsonrpc20id1methodtoolscallparamsnametoolnamearguments.txt

## 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:

-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"}}}'

--d-jsonrpc20id1methodtoolscallparamsnamegetstatisticsargumentsfrom2026-02-22t000000zto2026-02-22t235959z.txt

### get_date_range
Get the earliest and latest waypoint dates for the user. No parameters required.

-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_date_range","arguments":{}}}'

--d-jsonrpc20id1methodtoolscallparamsnamegetdaterangearguments.txt

### 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").

example.sh

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":{...}}}'

example.sh

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"}}}'

example.sh

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":{}}}'

example.sh

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}}}'