About co-eli-mcp
co-eli-mcp is an MCP server for legal researchers querying Colombian Constitutional Court decisions in datos.gov.co. It verifies citations and returns metadata and public source links, but does not retrieve full decision texts.
Key features
- 01Free-text decision search
- 02Exact citation lookup and verification
- 03Decision metadata and source links
- 04Coverage and gap reporting
Use cases
- 01Check whether a decision citation exists
- 02Find decisions by reporting judge or case type
- 03Review case metadata and open the public decision page
MCP support
The server exposes decision search, exact lookup, and coverage tools to MCP clients. Responses include citations and public source links.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | max results (default 20). |
| query | string | Yes | free text (e.g. part of a magistrado's name, or "tutela"). |
Details
From the project READMEco-eli-mcp
MCP server for the datos.gov.co open-data record of decisions (sentencias) by the Colombian Constitutional Court (Corte Constitucional). Verifies whether a citation exists and returns its metadata.
What this is not
This dataset (v2k4-2t8s, "Sentencias proferidas por la Corte Constitucional")
has no full-text field - only metadata: proceso, expediente, magistrado
ponente, sala, and date. source_url points to the public relatoria page
where the full decision text lives, but this connector does not fetch it.
Tools
| Tool | Purpose |
|---|---|
co_search_sentencias | Free-text search (e.g. by magistrado name or proceso type) |
co_get_sentencia | Exact lookup by citation, e.g. "T-012/92" - verifies it exists |
co_coverage | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |
Every response carries lex_uri and source_url (the public
corteconstitucional.gov.co relatoria page) and human_readable_citation
(the citation itself, e.g. "T-012/92" - already the form used in practice,
so no separate identifier scheme is needed here).
Install
pip install co-eli-mcp
Windows 11 with Smart App Control
Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe
and the co-eli-mcp.exe launcher that pip writes at install time. The python.exe and
py.exe from the python.org installer are signed by the Python Software
Foundation, so running the module through the interpreter works:
python -m pip install co-eli-mcp
python -m co_eli_mcp
pip.exe is blocked for the same reason, so install with python -m pip, not
pip install. If python is not on PATH, use the Windows launcher: py -3 -m co_eli_mcp.
{ "mcpServers": { "co-eli-mcp": { "command": "python", "args": ["-m", "co_eli_mcp"] } } }
Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.
Configuration
| Env var | Default |
|---|---|
CO_ELI_CACHE_DIR | ~/.matematic/cache/co-eli |
CO_ELI_AUDIT_DIR | ~/.matematic/audit |
CO_ELI_BASE_URL | https://www.datos.gov.co/resource/v2k4-2t8s.json |
License
Apache-2.0 (code). datos.gov.co data is open data (see SOURCES.md).
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.