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

Route calculation and map preview are free for everyone. GPX downloads are the only paid feature.

Guest

€0 — no account

Route calculation + map view. 1 GPX download per device. Rate limited.

Free account

€0 — free forever

Everything in Guest, plus 1 bonus GPX download (email-verified) and saved routes.

Credits

Pay-per-GPX

Buy credit bundles (1 / 3 / 10 GPX). Credits never expire. API downloads consume credits too.

See full pricing →