# GeoAgentic.app MCP Server: AI-Native Geospatial Interaction

A powerful Model Context Protocol (MCP) server providing real-time transit routing, open-source GIS / geographic intelligence, and specialized Slovenian geospatial lookup tools for AI agents and LLMs.

This open server liks AI agents to global mapping APIs (OpenStreetMap, Wikipedia, Transitous) alongside hyper-local Slovenian databases (Prevoz.org carpooling, GURS Cadastral municipal records, and WFS geographic infrastructure catalogs).

---

## 🗺️ Core Architecture & Routing Strategy

AI agents utilizing this server must distinguish between micro-local tasks and cross-regional transits. The toolkit divides these workflows dynamically:

```
                  🗺️ User Geographic Request
                             │
              ┌──────────────┴──────────────┐
              ▼                             ▼
    [ Local/Micro Scale ]       [ Intercity/Macro Scale ]
    • Distance < 10km           • Regional Transit (Slovenia) -> slovenia_car_ride
    • Walking/Biking/Driving    • Long-Distance Europe -> eu-transit-router
    • POI Searches (Cafes)
              │
              ▼
   global_geoagentic_cli

```

---

## 🛠️ Available Tools

### 1. `slovenia_car_ride`

Queries real-time intercity ride-sharing data from Slovenia's premier carpooling network, **Prevoz.org**.

* **Primary Use:** Finding community-driven car rides between Slovenian cities (e.g., Ljubljana, Maribor, Koper, Celje).
* **Key Features:** Implements a strict local time mandate (CET/CEST) for agent reliability. Includes a `dry_run` mode for query verification.
* **Required Parameters:** `from_city`, `to_city`

### 2. `slovenia-cadastre`

An interface to query official Slovenian cadastral data. It maps structural relationships between land parcels, physical building numbers, and surface street addresses.

* **Primary Use:** Property boundary discovery, cross-referencing street addresses to parcel numbers, and proximity searches.
* **Key Features:** Supports lookup by coordinates or named locations using regional Cadastral Municipality identifiers (`ko_id`), such as `1725` for Ljubljana Center.
* **Required Parameters:** `command` (`parcel`, `address`, `building`, `near-coords`, or `near-location`)

### 3. `eu-transit-router`

An EU-wide public intercity transit routing agent backed by the decentralized **Transitous** network.

* **Primary Use:** Generating multi-leg public transit itineraries (rail, bus, ferry, subway) across European regions.
* **Key Features:** Features internal geocoding—agents should pass literal human place names (e.g., `"Bled"`, `"Trieste, Italy"`) directly without lookup.
* **Required Parameters:** `from_place`, `to_place`

### 4. `slovenia-wfs-expert`

A multi-endpoint Web Feature Service (WFS) explorer built to browse and query live spatial databases hosted by the Slovenian national mapping agency (GURS) and municipal authorities.

* **Primary Use:** Dynamically fetching raw spatial layers, zoning codes, and utility infrastructure networks inside a bounding box.
* **Target Gateways:** 1. `1` - Slovenian Cadastral Portal (GURS KN)
2. `2` - Municipal Spatial Planning & Zoning (MNVP PA)
3. `3` - Cadastre of Economic Infrastructure (GURS KGI)

### 5. `global_geoagentic_cli`

A global utility knife for point-of-interest (POI) discovery, address handling, and routing over short distances using **OpenStreetMap (OSM)** and **Wikipedia**.

* **Modes Supported:** * `route`: Short-distance paths (walk, bike, drive under 10km).
* `osm`: Tag-filtered proximity queries (e.g., `{"amenity":"cafe"}`).
* `wikipedia`: Extracts geolocated historical/cultural landmarks.
* `geocode` / `reverse`: Coordinates translation.
* `isochrone`: Generates walking radii based on precise time limits.


* **Required Parameters:** `mode`

---

## 🚀 Installation & Configuration

To integrate this gateway endpoint into your local environment (such as Claude Desktop or Cursor), add the server configuration snippet to your configuration path.

### 1. Claude Desktop Integration

Add this snippet to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "geoagentic-spatial": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sse",
        "https://geoagentic.app/mcp"
      ]
    }
  }
}

```

### 2. Cursor Integration

1. Navigate to **Settings** > **Features** > **MCP**.
2. Click **+ New MCP Server**.
3. Fill out the configuration prompt:
* **Name:** `GeoAgentic`
* **Type:** `SSE`
* **URL:** `https://geoagentic.app/mcp`


---

## 🤖 Guardrails & Agent Instructions

When programming system prompts or deploying agent loops with this server, observe the following constraints:

1. **Short vs. Long Routing:** Never use `eu-transit-router` for local routes under 10km. Conversely, never use `global_geoagentic_cli` for multi-city travel across Europe.
2. **Failures are Terminal:** If `eu-transit-router` returns `LOCATION_NOT_FOUND` or `NO_ROUTES_FOUND`, stop execution and notify the user immediately. Do not alter parameters or try loop configurations without human intervention.
3. **Coordinates Handshake:** `global_geoagentic_cli` requires raw numerical latitude/longitude values for proximity metrics. If given a plain text landmark, use `mode: "geocode"` first to establish coordinates before querying nearby nodes.

### Learn More

* **Web**: [geoagentic.app](https://geoagentic.app)
* **Interaction**: Experience the GeoAgentic chatbot directly via our web interface.