# Engineering — geolocal.io

Architecture, technical roadmap, and implementation.

## Files

| File | Description |
|------|-------------|
| [Technical Roadmap](./technical%20roadmap.md) | 12-week phased plan: MVP → V1 → Scale |

## Code

The MCP server implementation lives in the repo root [`code/`](../../code/) directory:

- **`src/index.ts`** — Server entry point (stdio transport)
- **`src/mcp-server.ts`** — Tool registration (5 MCP tools)
- **`src/tools/`** — Individual tool implementations
- **`src/db/`** — PostgreSQL schema + seed data
- **`src/manifest-generator.ts`** — `/.well-known/mcp-server` JSON manifest
- **`railway.json`** + **`Dockerfile`** — Deployment config

Every technical decision must trace back to [NORTH_STAR.md](../../NORTH_STAR.md).