Skip to main content
Glama

mcp-impo

MCP server for IMPO Uruguay datos abiertos API with SQLite caching.

PyPI Python

Install

pip install mcp-impo

Related MCP server: Spanish Public Data MCP

Usage

from mcp_impo import get_schema, get_norma, search_normas, get_base_info

# Get schema
schema = get_schema()

# Get specific norm
norma = get_norma("ley", 2024, "19850")

# Search
results = search_normas("seguridad social", tipo="ley", limit=10)

# Get available bases
bases = get_base_info()

CLI

mcp-impo --help

MCP Tools

  • schema - Retrieve IMPO JSON schema documentation

  • norma - Get a specific norma or aviso

  • search - Search normas/avisos

  • bases - Get information about available bases

Cache

The server uses SQLite caching with configurable TTL:

  • Schema: 24 hours

  • Base info: 1 hour

  • Norma data: 1 hour

  • Search results: 10 minutes

Override TTL per request by passing ttl parameter (seconds).

mcp-name: io.github.daedalus/mcp-impo

Development

git clone https://github.com/daedalus/mcp-impo.git
cd mcp-impo
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Available Tools

4 tools
basesA

Get information about available bases in IMPO.

Returns metadata about the available databases and their structure from IMPO's datos abiertos service.

Inputs: ttl. Returns: result

normaC

Get a specific norma or aviso from IMPO.

Retrieves detailed information about a specific legal norm or notice from IMPO's database in JSON format.

Inputs: tipo (required), anio (required), nro (required), sec, +1 more. Returns: result

schemaA

Retrieve IMPO JSON schema documentation.

Returns the JSON schema defining the structure for normas and avisos from IMPO's datos abiertos API. This schema describes all available fields for Uruguayan legislation and official notices.

Inputs: ttl. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: 'bases' retrieves database metadata, 'schema' provides the data structure, 'search' performs queries, and 'norma' fetches a specific record. No overlap or ambiguity.

    Naming Consistency5/5

    Tool names are all single lowercase nouns (bases, norma, schema, search), following a consistent, predictable pattern without mixing conventions.

    Tool Count5/5

    Four tools is well-scoped for a legislation/norm search service: metadata, schema, search, and retrieval cover the core functionality without excess or deficiency.

    Completeness4/5

    The set covers key operations: explore databases, understand schema, search, and retrieve specific items. Missing a direct 'list all normas' endpoint, but search can approximate it, so minor gap.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server deployed on Cloudflare Workers that provides access to Uruguayan legislation from the official IMPO database. It enables users to search for legal norms, retrieve full texts, and query specific articles from laws, decrees, and the constitution.
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Spanish government open data APIs including grants, legislation, company registry, statistics, and open data catalog. Enables LLMs to access Spanish public information on-the-fly.
      26
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables searching and retrieving judicial decisions from the Uruguayan National Public Jurisprudence Database (BJN).
      -