# menjometre

Menjometre is an independent observatory of Catalan public spending. This MCP server gives any LLM client read-only access to the full dataset and the statistical scoring layer built on top of it.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add segellfosc-dev-ayfx/menjometre

# Browse available tools
npx -y @smithery/cli@latest tool list segellfosc-dev-ayfx/menjometre

# Get full schema for a tool
npx -y @smithery/cli@latest tool get segellfosc-dev-ayfx/menjometre search

# Call a tool
npx -y @smithery/cli@latest tool call segellfosc-dev-ayfx/menjometre search '{}'
```

## Direct MCP Connection

Endpoint: `https://menjometre--segellfosc-dev-ayfx.run.tools`

## Tools (48)

- `search` — Search across entities, politicians, contracts, grants, organs, and persons. Returns top matches with type, name, slug/…
- `list_filter_options` — Enumerate all valid filter values the other tools accept: departments, organs, finalitats, parties, comarques, vegueríe…
- `get_dataset_stats` — Global counts, EUR totals, and last-sync metadata across grants, contracts, entities, and persons.
- `get_entity` — Full entity profile plus Menjometre scores with natural-language explanations. Accepts slug or CIF. Returns null if ent…
- `get_entity_grants` — Grants awarded to the entity with filters (year range, min amount, department) and cursor pagination.
- `get_entity_contracts` — Contracts awarded to the entity with filters (year, min amount, organ, sole-source flag).
- `get_entity_financials` — Yearly financial timeline filed with the Generalitat registry of entities.
- `get_entity_risk_analysis` — Aggregated risk dossier: concentration, recurrence, sole-source, fragmentation, dependency, accountability — with textu…
- `get_rankings` — Parameterised top-N ranking across entities. `metric` ∈ total_public_funds | menjometre_score | total_grants | total_co…
- `compare_entities` — Side-by-side comparison of 2–5 entities (slug or CIF).
- `get_politician` — Profile, accumulated years, party, institution, salary, BORME vincles count.
- `get_politician_salary_history` — Detailed salary time-series across positions.
- `list_carrecs` — Positions filtered by institution, party, active status.
- `get_party` — Party aggregates: member count, total accumulated years, average salary.
- `get_politica_hub` — Global political dashboard: counts by institution, top earners, data coverage, last sync.
- `get_porta_giratoria` — Revolving door catalog. Filters: party, institution, min years of political service before pivot, sector.
- `get_politician_conflicts` — Declared + detected conflicts for one politician.
- `get_entity_conflicts` — Entity-side mirror of conflict detection — politicians linked to the entity.
- `analyze_conflict_of_interest` — Given a person name and an entity identifier, return every known link (BORME role, political position, declarations, gr…
- `detect_undisclosed_conflicts` — Proactive scan: politicians with BORME roles in entities receiving grants/contracts during their term but with no match…
- `get_lobby_meetings` — Lobby meetings from the Generalitat transparency portal. Filters: official name, interest group, date range.
- `get_organ` — Single contracting body profile: total contracts, total amount, % sole-source, % menor, % competitive, top-5 suppliers …
- `list_organs` — Contracting bodies catalog with filters (semaphore, search) and pagination.
- `get_ens_public` — Instrumental/public body profile including type (consorci, empresa pública, fundació) and parent administration.
- `list_ens_publics` — Instrumental public entities catalog filtered by type/comarca.
- `get_pressupostos_hub` — Generalitat budget dashboard for a single fiscal year: total, by department, execution rate if available.
- `get_budget_by_department` — Budget series by department with nominal or CPI-deflated (real) values.
- `get_budget_partides` — Line items within a department + year.
- `get_efficiency_analysis` — Cost-per-outcome analysis for selected programmes (EUR spent ÷ outputs where available).
- `get_fiscal_deficit` — Catalonia → Spain fiscal deficit for a year range using one of three academic methods: cash_flow | burden_benefit | con…
- `get_budget_transfers` — Admin → entity transfer flows with filters.
- `get_yearly_trends_budget` — Generic time-series of a budget dimension/metric (deflated or nominal).
- `get_xarxa_stats` — Global network metrics: node counts, edge counts, connectivity, top hubs.
- `get_xarxa_by_comarca` — Geographic breakdown of network density (edges per comarca).
- `get_person_network` — BFS from a single person up to a max depth (hard-capped at 3).
- `get_entity_network` — BFS from a single entity up to a max depth (hard-capped at 3).
- `find_shortest_path` — Bounded BFS shortest path between two graph nodes. Max depth hard-capped at 5 in the RPC.
- `get_network_hubs` — Highest-degree nodes filtered by type + metric.
- `detect_clusters` — Louvain communities computed nightly. Returns the top clusters by size.
- `investigate_cluster` — Full member list of a Louvain cluster with entity + person joins.
- `analyze_contract_network` — Contract graph for an organ or entity: sole-source patterns, repeat suppliers, fragmentation signals.
- `get_equivalencies` — Translate a EUR amount into public-service equivalents (teachers, nurses, daycare places, etc.).
- `get_yearly_trends` — Generic yearly time-series by dimension/metric (grants, contracts, entities).
- `export_data` — Bulk JSON export of grants/contracts/entities with filters. CSV is emitted as plain text for LLM consumption.
- `get_methodology` — Scoring methodology, data sources, last-sync timestamps, definitions. Citable for LLM outputs.
- `get_source_documents` — Enumerate every source URL attached to a single record. record_type ∈ grant | contract | conveni | politician_position …
- `list_documents_for_entity` — Every source document linked to any record touching the given entity.
- `fetch_source_document` — Server-side retrieval of an allowlisted source URL. Extracts plain text (first 64 kB) via pdf-parse/readability. SSRF-h…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get segellfosc-dev-ayfx/menjometre <tool-name>
```