# geolith API

> Geocoding API over OpenStreetMap and Overture Maps data: forward search, autocomplete, structured search, reverse geocoding and place outlines, served as GeoJSON over REST, a remote MCP server and an A2A agent.

Authenticate with an API key (free plan: 100,000 requests a month) or an OAuth 2.1 access token from https://console.geolith.app.

## API

- [OpenAPI 3.1](https://docs.search.geolith.app/openapi.json): every REST route and parameter
- [API reference](https://docs.search.geolith.app): human-readable docs
- [API catalog](https://api.geolith.app/.well-known/api-catalog): RFC 9727 linkset

## Agents

- [How to geocode with geolith](https://api.geolith.app/.well-known/agent-skills/geolith-geocoding/SKILL.md): REST, MCP and A2A in one page
- [MCP server card](https://api.geolith.app/.well-known/mcp/server-card.json): https://api.geolith.app/mcp, Streamable HTTP
- [A2A agent card](https://api.geolith.app/.well-known/agent-card.json): https://api.geolith.app/a2a, JSON-RPC
- [auth.md](https://api.geolith.app/auth.md): agent registration with OAuth 2.1

## Console

- [Sign up](https://console.geolith.app/signup): free account and API keys
- [Pricing](https://console.geolith.app/pricing): plans and quotas
- [Live demo](https://demo.geolith.app): search on a map