API & Integrations

GoraAdv for Developers

Use GoraAdv with Claude AI, or integrate offroad routing directly into your own app.

Section 1

Use GoraAdv with Claude

GoraAdv works as a connector inside Claude — Anthropic's AI assistant. Once connected, you can plan offroad routes, calculate roundtrips, and download GPX files just by talking to Claude. It works on desktop, web, and mobile.

How to connect

🔌 https://goraadv.com/mcp

What you can say

🏍️ "Plan a 200 km offroad roundtrip from Pau, France"
🗺️ "Route from Munich to Innsbruck the offroad way"
📍 "Add a waypoint near Andorra and recalculate"
📥 "Download the GPX for that route"
💾 "Save this route to my account"

Section 2

Available Tools

GoraAdv exposes six tools via the MCP protocol. Claude selects and calls them automatically based on your request — you don't need to invoke them by name.

goraadv_geocode Resolve a place name or address to coordinates. Used internally before routing.
goraadv_route Calculate an offroad A→B route. Accepts optional intermediate waypoints.
goraadv_roundtrip Plan a round-trip offroad loop from a single starting point with a target distance.
goraadv_download_gpx Download a GPX file for the current route, ready to load onto any GPS device or app.
goraadv_save_route Save the current route to your GoraAdv account for later access in the planner.
goraadv_check_usage Check how many GPX downloads you have remaining under your current plan.

Section 3

Public API

The GoraAdv public API lets you integrate offroad routing into your own tools and apps. All responses are JSON.

🌐 Base URL  https://goraadv.com/public/v1/
🔑 Auth  Bearer token (API key)

Generate an API key from your profile settings. Pass it as an Authorization header:

# Authenticated request Authorization: Bearer YOUR_API_KEY

Endpoints

Endpoint Description
GET/geocode Resolve a place name to lat/lon coordinates
POST/route Calculate an offroad A→B route with optional waypoints
POST/roundtrip Generate an offroad roundtrip loop from a start point
GET/gpx/{route_id} Download a GPX file for a previously calculated route
POST/save Save a route to your account
GET/usage Check your remaining GPX download quota

Rate limits

✅ Authenticated  20 req / min
⚠️ Unauthenticated  5 req / min

Quick example — geocode

# Resolve a place name to coordinates curl -s -G https://goraadv.com/public/v1/geocode \ --data-urlencode "q=Pau, France" \ -H "Authorization: Bearer YOUR_API_KEY" # Response { "lat": 43.2951, "lon": -0.3708, "name": "Pau, Pyrénées-Atlantiques, France" }

Section 4

Pricing

Everything on goraadv.com is free — route calculation, map preview and GPX downloads alike. There is no account tier, no credit bundle and nothing to buy.

Downloads are capped per address per day to keep automated bulk pulls from degrading the service for everyone else. The cap is generous enough that normal planning never runs into it.