# atlas2-mcp — project notes

## Goal
Implement the **atlas2 resolution** tool as an MCP server.

## Tool contract (resolve)
Based on `resolve_scheme.md`:
1) Input: `resolve("Joe Biden")`
2) Cache lookup: alias index + identifier index
3) If hit:
   - load RDF -> Python model
4) If miss:
   - call Wikidata
   - build Entity
   - store in RDF
   - update cache
5) Return JSON

## Where code lives
- `app/mcp_server.py` — MCP tool registration (`resolve`)
- `app/main.py` — FastAPI + HTTP/SSE mount at `/mcp`
- `app/resolve.py` — resolve service (currently stubbed)
- `app/atlas_store.py` — SPARQL persistence (SPARQL endpoint OR Virtuoso MCP tools)

## Next steps
1) Replace the stub in `app/resolve.py` with the cache + resolve flow.
2) Implement alias/identifier indexes.
3) Wire Wikidata calls + RDF storage using `atlas_store.py`.