Skip to content
MCP server for Austrian geodata

MCP server for Austrian geodata

The mapx MCP server gives an AI assistant 23 tools for Austrian geodata: address search, routes, public transport, heights, cadastral parcels, traffic and weather. It uses the Model Context Protocol (MCP), so any MCP client can connect. All tools are read-only, the data covers Austria only and comes from official open data, and every answer names its source.

Endpointhttps://mcp.mapx.at/mcp
TransportStreamable HTTP, POST only, stateless
Protocol versions2026-07-28 and older ones from 2024-11-05
AuthenticationEither sign in with your mapx account (OAuth 2.1 with PKCE, just enter the address) or a token of type “AI assistant (MCP)”, prefix mx_mcp_, in the header Authorization: Bearer …

Set up

There are two ways. Signing in with your account is the simpler one: you only enter the address and do not copy a token. The token way works with any MCP client.

Sign in with your account

  1. Add https://mcp.mapx.at/mcp as an MCP server in your application (see below).
  2. The assistant sends you to account.mapx.at. Sign in or register.
  3. The consent page shows the application, the redirect target, your account and what the access allows: read-only tools only, calls count towards your usage, no access to your account or your other tokens. Confirm the connection.
  4. Ask a question that needs Austrian data, for example “How do I get by bike from Melk station to Melk Abbey, and how long does it take?”.

The connection then appears at account.mapx.at → Tokens as “connected via ”. Each application can hold up to five connections at the same time, for example browser, desktop and phone. The connection does not expire on its own.

These applications are approved for signing in with your account:

  • claude.ai (web, desktop, mobile): under Connectors in the settings, add a custom connector and enter the address. The exact menu path depends on your plan and changes over time; it is described in Anthropic’s help. On Team and Enterprise plans an owner adds the connector first.
  • Claude Code: claude mcp add --transport http mapx https://mcp.mapx.at/mcp, then enter /mcp in Claude Code and start the sign-in for mapx.
  • ChatGPT: connectors or apps with your own MCP address, available depending on plan and settings (sometimes only in developer mode). Steps and availability are in OpenAI’s help.

Signing in with your account is limited to known applications. For all other clients use the token way; further applications can be enabled on request (support@mapx.at).

With a token

  1. Create a token at account.mapx.at/tokens/new?kind=mcp. Choose the type AI assistant (MCP), give it a name and optionally an expiry date. The token is shown once; copy it then.
  2. Add the server to your client (see below) and paste the token where the examples say YOUR_MCP_TOKEN.
  3. Ask a question that needs Austrian data.

The token works only at the MCP server. It has no domain or IP binding, can have an expiry date, and you can block or rotate it at any time in your account.

Clients for the token way

These clients take a fixed header, so the token goes straight into the configuration.

claude mcp add --transport http mapx https://mcp.mapx.at/mcp --header "Authorization: Bearer YOUR_MCP_TOKEN"

Disconnect

At account.mapx.at → Tokens every connection made through your account is listed as “connected via ”. Disconnect ends it; Block rejects it immediately and can be undone. The assistant then gets 401 and asks you to sign in again when needed.

For developers

The MCP server follows MCP authorization (OAuth 2.1):

  • Protected resource metadata: https://mcp.mapx.at/.well-known/oauth-protected-resource/mcp
  • Authorization server: https://account.mapx.at (metadata at /.well-known/oauth-authorization-server)
  • Authorization code with PKCE (S256); public clients identify themselves through Client ID Metadata Documents, there is no dynamic registration.
  • Scope mcp. The access token does not expire and there is no refresh token; revocation happens in the account.

Limits, counting and tools are the same for both ways.

Tools

The assistant picks the tools itself. Coordinates are {lon, lat} in WGS84; geocode turns a place name into coordinates for the other tools.

GroupToolPurposeMain inputs
SearchgeocodeCoordinates for an address, street, place, postcode, POI, parcel or road kilometerquery, near, types, limit
Searchreverse_geocodeNearest address or place for a coordinatelon, lat, radius_m, types
Searchvalidate_addressCheck an address against the official register and normalize itaddress or street, housenumber, postcode, place
Searchsearch_placesPoints of interest by category or namecategory, query, near, radius_m, limit
Searchlist_place_categoriesCategory ids usable in search_placesnone
RoutingrouteRoute by car, truck, bike or on foot with distance, time and instructionsprofile, waypoints (2 to 25), exclude, truck
RoutingisochroneArea reachable within given minutes or metersprofile, lon, lat, minutes, meters, depart_at
Routingtravel_matrixTravel times between 2 to 25 pointsprofile, points, sources, destinations
Routingoptimize_stopsFastest order of 2 to 25 stopsprofile, stops, roundtrip, start, end
Public transporttransit_routeConnections between two points from the scheduled timetablefrom, to, depart_at, arrive_by, access, connections
Public transportdeparturesNext scheduled departures at a stop or around a pointstop_id or near, time, limit
Public transportfind_stopsStops near a point or in a box, with stop_idnear, radius_m, bbox, limit
ElevationelevationHeight above sea level (terrain or surface model)points, model
Elevationelevation_profileAscent, descent, lowest and highest point along a linepath (2 to 200 points), samples, model
Parcelsparcel_at_pointCadastral parcel at a coordinatelon, lat, radius_m
Parcelsparcel_detailsParcel dossier: area, land use, buildings, slope, addressesparcel_id
Traffictraffic_incidentsAccidents, congestion, roadworks and closuresbbox, road, road_class, types, planned
Trafficspeed_limitsStatutory speed limits at a point, in a box or along a pathat, bbox, path, buffer_m
WeatherweatherCurrent observations, hourly forecast or nowcastlon, lat, kind, hours
Weatherweather_warningsOfficial weather warningsat, bbox, type, min_level, active_now
WeatherclimateLong-term climate facts, solar potentiallon, lat, sections
Weatherair_qualityAir quality index and pollutantslon, lat, hours
Mapstatic_mapMap image with pins and a linecenter, zoom, pins, line, style, width, height

search_places with free text and near searches only within radius_m (500 to 100000 meters, default 25000), sorts by distance and says so explicitly when it has to fall back to matches farther away. A category search always returns the nearest first and ignores radius_m.

Times in the answer text are Austrian local time with the offset, for example 2026-11-18T08:00+01:00; this applies to weather, warnings, air quality and traffic reports. Public transport times are local time as well. The structured part of the result (structuredContent) keeps the timestamps of the API.

Routing profiles are driving, driving-traffic, driving-truck, cycling, cycling-mtb and walking; isochrone also accepts transit.

Example questions

  • “Where is Herrengasse 13 in Vienna, and where is the nearest fuel station?”
  • “How long does a truck with 40 t take from Vienna to Linz, and are there closures on the way?”
  • “Which parts of Melk can I reach within 15 minutes on foot from the station?”
  • “What are the next departures at Melk Bahnhof?”
  • “How high is the Grossglockner area, and what does the profile of my hiking path look like?”
  • “Which parcel is at 16.3725, 48.2085, how large is it, and is it building land?”
  • “Will it rain in Innsbruck in the next three hours?”
  • “Plan the best order for these five delivery addresses and show them on a map.”

Limits and counting

Every tool call counts like an API call and appears in your usage view as MCP. Some tools make several API calls, for example free-text search in search_places (up to 11). The protocol messages themselves (each request to /mcp) are listed separately as product mcp; they do not use up the per-minute limit. The per-minute limit of your token (6000 by default) and the zone limits of the API apply, over MCP per token instead of per IP address (Access and limits). The MCP endpoint itself accepts 10 requests per second per IP address (burst 40) and request bodies up to 256 KB. Per token, at most 4 calls run at the same time; further ones wait or fail with a waiting time. If a limit is exceeded, the assistant gets an error message with a waiting time.

Errors

The assistant receives the error as text and can react to it. Error codes and causes are listed in Errors and limits, in particular mcp-token-only and mcp-token-required.

Limitations

  • Austria only; data comes from official open data, and each answer names the source.
  • All tools only read; nothing is changed or stored.
  • Public transport answers come from the scheduled timetable, without real-time data.
  • Climate, weather, warnings and air quality come from GeoSphere Austria, traffic reports from ASFINAG and EVIS.AT.
  • Long results are shortened.

Privacy

Your questions and the results pass through the provider of your assistant. mapx only sees the tool calls, like ordinary API calls.

Troubleshooting

SymptomCause and fix
401No or invalid token. With sign-in through your account, this makes the assistant start the sign-in; after you disconnect or block the connection it reports 401 and asks again. With the token way, check the Authorization: Bearer header and that the token was not deleted or expired.
Error page “Application not allowed”The application is not on the list of approved applications. Use the token way or write to support@mapx.at.
403 mcp-token-requiredA public (mx_pk_) or secret (mx_sk_) token was used at the MCP server. Create a token of type “AI assistant (MCP)”.
403 mcp-token-onlyAn mx_mcp_ token was used for a direct API call. Use a secret token (mx_sk_) there.
429A limit was exceeded. Wait the time stated in the message and make fewer calls in parallel.
403 for a browser clientThe Origin is not allowed. Browser clients must come from an allowed site; use a desktop client or the API.

Next