# EPO Case Law MCP Server (epo-caselaw-mcp)

An open Model Context Protocol (MCP) server, REST API, and web interface analogous to [OpenCaseLaw.ch](https://opencaselaw.ch) for European Patent Office (EPO) Boards of Appeal (BoA) decisions.

## Overview

- **Data Source**: Official bi-yearly bulk dataset from the EPO Bulk Data Distribution Service (BDDS Product 14.6: Boards of Appeal decisions). Over 50,000 decisions from 1978 to present.
- **Backend & Protocol**: FastAPI application serving both standard REST endpoints (/docs) and MCP Server-Sent Events (SSE) protocol for AI assistants (Claude, Cursor, Antigravity, etc.).
- **Storage & Search**: PostgreSQL with pgvector for semantic vector search (Vertex AI multilingual embeddings) and 	svector for full-text keyword retrieval.
- **Citation Graph**: Extracted network of statutory EPC provisions (Articles and Rules) and cross-decision precedent citations (T, J, G, D, R, W decisions).
- **Web UI**: Fast server-rendered search interface built with FastAPI, Jinja2, and HTMX.

## Project Architecture & Roadmap

This project uses Wayfinder for phased delivery:
- Streaming XML parser for high-efficiency ingestion of EPO BDDS bulk datasets.
- Relational schema + vector embedding pipeline.
- MCP tool suite (search_decisions, get_decision, get_citations, ind_similar, lookup_statute).
- Cloud Run deployment configuration.