# geosearch

> UK place search API (towns, streets, postcodes, rivers, points of interest; typo-tolerant; "pubs in n5" style queries) with free self-hosted vector maps and an MCP server. A proof of concept by Dan Hartropp; keys from dan@danhartropp.com.

## Docs

- [API](https://geo.danhartropp.com/docs/api.md): /search, /suggest, /reverse, parameters, response fields, and how to read ties and confidence
- [MCP server](https://geo.danhartropp.com/docs/mcp.md): install commands and tools (search_places, describe_location, resolve_places, map_link)
- [Maps](https://geo.danhartropp.com/docs/maps.md): MapLibre setup with Protomaps tiles, fonts, sprites and colour overrides

## Optional

- [All docs in one file](https://geo.danhartropp.com/llms-full.txt)
- [OpenAPI spec](https://geosearch-tlm25zrwea-nw.a.run.app/openapi.yaml)
- [Agent skill](https://geo.danhartropp.com/skill/geosearch/SKILL.md): add UK place search and a map to an app