Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Horizun PBI MCP

PYPI · HORIZUN-PBI-MCP

Build, audit and repair Power BI Desktop models and PBIP reports with DAX, TMDL and PBIR.

Available components

+15 this week 90 Trust /100

Last scanned (2 hours ago)

Scores higher than 93% of PyPI servers

Category Data and Analytics

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 2 of 43 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to HorizunGroup/horizun-pbi-mcp). View diagnostics → Pass
  • Clear OSI-approved license (Apache-2.0).Pass
  • Actively maintained (last published 0 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability60
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 24637 tokens (~175/item across 140 items; 140 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage71
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 140 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 5 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 4 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Package version: 2.1.3 → 2.2.0 functional
  • 2 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
    • Stability: 0.97 → pass security
  • 1 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 31 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
    • Security disclosure: unverified → pass ▲ functional
    • Stability: pass → 0.93 functional
  • 30 Oct 26 0
    • Security disclosure: pass → unverified ▼ functional
  • 20 Oct 26 0
    • Package version: 2.1.2 → 2.1.3 functional
  • 19 Oct 26 0
    • Stability: 0.97 → pass security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Analysed pypi/horizun-pbi-mcp@2.2.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo HorizunGroup/horizun-pbi-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/HorizunGroup/horizun-pbi-mcp/.github/workflows/release.yml@refs/tags/v2.2.0
Rekor log index 3685553063
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:02669576f7f98e0299da3e0cd8dbe083c610ddaa8f71aaf19131770338edb76f

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted setuptools.build_meta

Background: Why install scripts are a supply-chain risk →

Dependencies 43 packages
Packages resolved 43
Stale 2
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 140 exposed · ~24,637 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
pbi_add_custom_visual ~75

Registra un custom visual de AppSource en el informe (publicCustomVisuals). Sin argumentos registra "HTML Content" (renderiza HTML/SVG desde una medida DAX). Power BI Desktop lo descarga de AppSource al abrir el informe.

NameTypeReqDescription
request_idstring––
visual_id–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_add_image_resource ~129

Incrusta una imagen en el informe y la deja lista para usar. La copia a StaticResources y la declara en report.json: sin las dos cosas Power BI no la encuentra y el visual sale vacio sin dar ningun error. Devuelve `item_name`, que es lo que se le pasa al visual de tipo 'image' en options.resource. `path`: archivo local (.png .jpg .gif .bmp .svg).

NameTypeReqDescription
name–––
overwriteboolean––
pathstringyes–
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_add_table_from_file ~1,026

Carga un archivo al modelo como lo haria una persona: abrir, transformar, cargar. El mismo recorrido de Power Query —Obtener datos, promover encabezados, cambiar tipos, Cargar— pero escrito directo en el proyecto. Los pasos de la consulta se llaman como los pone Power BI ('Origen', 'Encabezados promovidos', 'Tipo cambiado'), asi que se puede abrir y editar en el editor sin que desentone. Admite .csv, .txt, .tsv, .xlsx, .xlsm, .json, .html/.htm y '.xls'. Sin dependencias nuevas: el .xlsx se lee como lo que es, un zip con XML, y el HTML con `html.parser` de la biblioteca estandar. Un '.xls' NO se toma por la extension: se mira la firma real del archivo. En la practica, casi ningun '.xls' que exportan los ERPs es el binario OLE2 que la extension promete -- es una tabla HTML con esa extension porque Excel la abre igual. Si de verdad es OLE2 (Excel 97-2003), se rechaza con un mensaje claro en vez de leerlo mal; si es un .xlsx renombrado, se lee como .xlsx. Para HTML: si el archivo trae varias `<table>`, se elige la mas grande y se avisa (usa `table_id` para elegir una en concreto, el `id` HTML de la tabla). Los encabezados solo se promueven si la tabla usa `<th>`; un reporte sin esa marca (el caso normal en un reporte de ERP, donde la fila 1 es el titulo del reporte, no un encabezado) carga con columnas 'Column1', 'Column2'... **La cultura se deduce del archivo**, mirando como escribe los decimales, y se emite SIEMPRE explicita en la consulta. Asumir la del modelo es lo que convierte 10527.52 en diez millones sin que nada falle: un informe que abre, pinta y miente. `culture` permite forzarla. Lo escrito se valida antes de darlo por bueno: si el TMDL generado no pasara `pbi_validate_tmdl`, se aborta en vez de dejar un proyecto que no abre. **Filas de basura antes del encabezado**: es el patron de export mas comun de un ERP -fila 1 con el titulo del reporte y el resto de la fila vacia, encabezado real en la fila 2-. Por defecto se AUTODETECTA la primera fila que pu…

NameTypeReqDescription
culturestring––
descriptionstring––
dry_runboolean––
keep_summary_rowsboolean––
overwriteboolean––
pathstringyes–
request_idstring––
sheetstring––
skip_rows–––
table_idstring––
table_namestring––
text_columns–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_add_table_from_source ~413

Crea una tabla apuntando a una BASE DE DATOS o API externa. `source`: sqlserver | postgresql | odata | web_json. - sqlserver/postgresql: `server` + `database` + (`schema`/`source_table` o, solo en sqlserver, `native_query` con plegado activado). - odata: `url` del ENTITY SET (…/odata/Presupuestos), no la raiz. - web_json: `url` que devuelve un array de objetos; `json_path` desciende hasta el (["data","rows"]). Tipado con cultura en-US fija: JSON escribe numeros sin cultura, y la del sistema es el bug del 10527.52 que se vuelve diez millones. `columns` ([{name, type}]) es OBLIGATORIO: sin credenciales no se puede leer el esquema de la fuente, y las columnas no se inventan. **La verdad de las credenciales, por delante**: la consulta queda escrita y validada, pero el PRIMER refresh lo completa una persona en Desktop —pedira credenciales y nivel de privacidad, que viven en Desktop, no en el .pbip—. Hasta entonces la tabla existe sin datos y este servidor no puede verificar la conexion. Prometer otra cosa seria mentir. Escribe TMDL: requiere el proyecto CERRADO en Desktop.

NameTypeReqDescription
columnsarrayyes–
databasestring––
descriptionstring––
dry_runboolean––
json_path–––
native_query–––
overwriteboolean––
request_idstring––
schemastring––
serverstring––
sourcestringyes–
source_tablestring––
table_namestringyes–
urlstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_align_visuals ~81

Alinea varios visuales por un borde. `edge`: left | right | top | bottom | center_h | center_v. Determinista: la misma entrada produce siempre la misma salida.

NameTypeReqDescription
edgestring––
pagestringyes–
request_idstring––
visual_idsarrayyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_analyze_model_quality ~64

Detecta problemas tipicos del modelo (calidad). Revisa medidas sin carpeta, DAX muy largo, relaciones bidireccionales/ inactivas, columnas calculadas, IDs visibles, ausencia de calendario, etc.

NameTypeReqDescription
sourcestring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_apply_audit_fixes ~94

Aplica las acciones devueltas por pbi_plan_audit_fixes. Requiere confirm=true. Cada accion se aplica por su propia via segura (transaccion, verificacion y rollback); si una falla, se reporta sin detener las demas y sin ocultarlo.

NameTypeReqDescription
actionsarrayyes–
confirmboolean––
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_apply_design_system ~123

Aplica el sistema al informe y devuelve su rejilla. Escribe el tema y lo declara en `report.json`. Devuelve el lienzo, la rejilla (columnas, margen y medianil) y la escala tipografica, para que lo que se coloque a mano despues use las mismas guias que `pbi_compose_page`. Escribe en el informe (PBIR): conviene tener el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
request_idstring––
systemstringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_apply_page_spec ~372

Materializa el spec como una pagina PBIR, en UNA transaccion. Cuatro desenlaces explicitos: `create` (no existe), `update` (existe y el spec cambia algo), `no_change` (ya coincide) y `conflict` (el nombre no identifica una sola pagina). `page`: id o nombre visible de la pagina a actualizar. Si se omite, se usa el nombre del spec. Al actualizar se CONSERVAN el id de la pagina y el de cada visual que siga representando lo mismo. `sync_mode`: `merge` (por defecto) anade y actualiza pero no borra lo que el spec no menciona; `replace` ademas elimina los visuales ausentes. El defecto es conservador para que un spec parcial no pueda vaciar una pagina por omision. `interactions`: que le hace un visual a otro al seleccionar en el. Cada visual del spec se puede senalar por su POSICION en `visuals` (0, 1, 2...), por el `id` que se le ponga en el spec, o por su titulo; no hace falta conocer los ids finales, que se generan aqui. Tipos: `Default`, `DataFilter`, `HighlightFilter`, `NoFilter` (tambien valen `filter`, `highlight` y `none`). `dry_run=true` devuelve un plan con `plan_token` y no escribe nada; aplicalo despues con pbi_apply_plan.

NameTypeReqDescription
dry_runboolean––
pagestring––
request_idstring––
seedstring––
specobjectyes–
sync_modestring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_apply_plan ~207

Aplica un plan calculado con pbi_plan_change o con un dry_run. Verifica que el proyecto siga en el estado sobre el que se planifico; si cambio, rechaza el plan en vez de aplicar algo distinto de lo aprobado. `expected_operation` es opcional: si lo indicas, el plan solo se aplica si fue generado para esa operacion (`plan_operation_mismatch` si no). **Exige `confirm=true`.** Hasta 2.0.0 el default era `True`, o sea que omitir el parametro APLICABA: un gate que viene abierto no es un gate, y ademas rompia la simetria con las otras ocho tools con `confirm`, que es justo la inconsistencia que hace que un agente generalice mal.

NameTypeReqDescription
confirmboolean––
expected_operationstring––
plan_tokenstringyes–
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_apply_theme ~416

Aplica un tema de colores al informe .pbip activo. Escribe el JSON del tema en StaticResources/RegisteredResources y lo declara en report.json (themeCollection + resourcePackages). Sin las tres cosas Power BI Desktop lo ignora en silencio. `preset`: ver pbi_list_themes. `data_colors`: sustituye la paleta de series por la tuya (#RRGGBB); ojo, entonces el orden deja de estar verificado contra daltonismo. `name`: nombre visible del tema. `theme_json`: un tema COMPLETO tuyo (el objeto JSON), que se escribe tal cual — para tipografia corporativa o formatos que los presets no cubren, sin tener que sobrescribir el archivo a mano despues. Cuando lo pasas, `preset` no se usa; `data_colors` y `fonts` se aplican encima. `fonts`: {'title'|'body'|'callout': 'Familia'} fija las fuentes via textClasses, sobre el preset o sobre tu theme_json. `patch`: cambios PARCIALES sobre el tema que el informe YA tiene, sin reenviar el tema completo (p.ej. {"visualStyles": {...}} para retocar un estilo). Los dicts se fusionan en profundidad; las listas se reemplazan enteras. Con `patch`, el resto de parametros no se usa y hace falta que el informe ya tenga un tema propio. Si el informe ya tenia un tema con contenido DISTINTO (p.ej. editado a mano), se reemplaza avisandolo en `warnings`; la version anterior queda recuperable en el backup de la transaccion. Requiere el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
data_colors–––
fonts–––
name–––
patch–––
presetstring––
request_id–––
theme_json–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_arrange_visuals ~111

Reorganiza los visuales de una pagina. `layout`: grid | dashboard | executive_summary | custom. `visual_ids`: subconjunto opcional (por defecto todos). `custom`: mapa visual_id -> {x,y,width,height} para layout 'custom'.

NameTypeReqDescription
canvas–––
custom–––
layoutstring––
pagestringyes–
request_idstring––
spacingnumber––
visual_ids–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_audit_model ~119

Audita el modelo semantico con reglas de identificador estable. Cada hallazgo trae `rule`, `severity`, `object`, `evidence`, `recommendation` y `auto_fix_available`. Ninguna heuristica se presenta como certeza: la evidencia acompana siempre al hallazgo. `rules`: subconjunto de reglas (ver pbi_list_audit_rules). `min_severity`: info | warning | error.

NameTypeReqDescription
min_severitystring––
rules–––
sourcestring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_audit_project ~215

Auditoria integral: modelo semantico + informe + layout. Devuelve puntaje global y por dominio, resumen ejecutivo, hallazgos priorizados con evidencia y recomendacion, y que reglas tienen correccion automatica. `formats`: ['markdown','html'] escribe tambien esos informes en outputs/ y devuelve sus rutas. `rules` y `min_severity` acotan. `compact=true` devuelve la MISMA auditoria sin repetir texto: cada hallazgo lleva un `finding_id`, `priority` pasa a ser la lista de esos identificadores en orden en vez de copias completas, y `groups` agrupa las repeticiones por regla con su recuento y una muestra. Los puntajes y recuentos por dominio no cambian. Los informes de `formats` se escriben siempre completos.

NameTypeReqDescription
compactboolean––
formats–––
min_severitystring––
rules–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_audit_report_only ~63

Audita solo el informe PBIR (sin las reglas del modelo semantico). Cubre paginas vacias, visuales sin titulo, campos rotos, duplicados, tamanos de lienzo inconsistentes y la geometria de cada pagina.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_backup_pbip_project ~68

Crea un backup con timestamp del proyecto .pbip activo. `mode`: folder | zip. `scope`: report | model | both. Devuelve la ruta.

NameTypeReqDescription
modestring––
request_idstring––
scopestring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_build_dashboard ~121

Construye un dashboard completo desde un objetivo, no desde primitivas. Analiza el modelo, compone el spec segun el preset, calcula el layout, genera preview, aplica en una transaccion y verifica el resultado. `dry_run=true` (por defecto) se detiene tras el preview.

NameTypeReqDescription
category–––
dry_runboolean––
measuresarrayyes–
namestringyes–
presetstring––
request_idstring––
seedstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_build_evm_page ~99

Pagina EVM (Earned Value Management). Espera medidas del tipo PV, EV, AC, CPI y SPI; si no las reconoce, lo avisa en vez de generar una pagina que no significa nada.

NameTypeReqDescription
category–––
dry_runboolean––
measuresarrayyes–
namestring––
request_idstring––
seedstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_build_executive_page ~70

Pagina de resumen ejecutivo: fila de KPIs y grafico protagonista.

NameTypeReqDescription
category–––
dry_runboolean––
measuresarrayyes–
namestring––
request_idstring––
seedstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_capabilities ~71

Que puede hacerse AHORA MISMO, y que no, con el motivo. Un agente deberia consultarla antes de planificar: dice si la capa en vivo esta disponible, si se puede escribir en el .pbip, y que capacidades dependen de la version del motor.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_check_contract ~211

Valida contra el contrato del puerto: un archivo entrante o el modelo. Con `source_path` (+ `dataset`): el export de Revit/Navisworks/Project ANTES de cargarlo — columnas que faltan, tipos incompatibles, llave ausente. Chequeo ESTRUCTURAL y honesto: unicidad y huerfanas de la llave exigen los datos completos, y eso es pbi_diagnose_data con la tabla ya cargada; la respuesta lo dice en `not_checked`. Sin `source_path`: el MODELO activo contra el contrato entero, y el circulo que cierra todo: `suggested_critical_fields` — las llaves del puerto listas para pbi_define_brief, de modo que el diagnostico las trate como criticas del dueño sin teclearlas dos veces.

NameTypeReqDescription
datasetstring––
request_idstring––
source_pathstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_close_desktop ~395

Cierra la instancia de Power BI Desktop que sirve ESE proyecto. Es la salida que faltaba del ciclo editar-abrir-mirar-editar: escribir el TMDL exige Desktop cerrado, y no habia forma de cerrarlo desde aqui -tocaba matar el proceso a mano en PowerShell-. Cierra SOLO la instancia con ese archivo abierto, verificando la identidad del proceso (nombre + hora de arranque, nunca el PID a secas). Al final re-comprueba que el archivo ya no este abierto y lo dice en `verified_closed`. DESTRUCTIVA: los cambios SIN GUARDAR de esa ventana se pierden -y en un .pbip eso incluye los datos refrescados de la sesion-. Por eso exige `confirm=true`. Si el archivo no estaba abierto, no hace nada y lo dice (`was_open: false`). `path` (o `pbip_path` / `project_path`) se puede omitir: se cierra el proyecto activo, que es el que el servidor ya conoce. **Tras `pbi_export_pbix(leave_open=true)`** la ventana queda sobre el archivo exportado y ya no responde a la ruta del .pbip original. Pasa `desktop_pid` y `desktop_started` tal cual los devuelve `desktop_session` de la exportacion: se cierra exactamente esa instancia, verificando nombre del proceso y hora de arranque (nunca el PID a secas, que Windows recicla). Con `path` ademas se exige que la ventana no este sirviendo demostrablemente otro documento.

NameTypeReqDescription
confirmboolean––
desktop_pid–––
desktop_started–––
path–––
pbip_path–––
project_path–––
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_column_dependencies ~64

Que usa una columna: medidas, columnas calculadas, relaciones y jerarquias. Util antes de ocultar o eliminar una columna: dice si algo se rompe.

NameTypeReqDescription
columnstringyes–
sourcestring––
tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_compare_live_to_pbip ~60

Compara el modelo EN VIVO con el TMDL del disco. Util para saber si hay cambios en memoria sin guardar: lista tablas y medidas que solo estan en un lado, y medidas cuyo DAX difiere.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_compose_page ~426

Compone una pagina entera sobre la rejilla del sistema de diseno. Se describe la INTENCION y el servidor decide la geometria: - `title` / `subtitle`: banda de cabecera, con el tamano y el color del sistema y la altura minima que el texto necesita para no cortarse. - `kpis`: lista de campos (`"[Medida]"` o `{"field":..., "title":...}`). Se reparten la fila entera sin dejar huecos. - `hero`: el grafico protagonista. `{"type":"lineChart", "category":"T[C]", "values":["[M]"], "title":...}`. - `supports`: los que van apilados a su derecha, mismo formato. - `detail`: tabla al pie. `{"values": [...], "title": ...}`. La composicion es siempre la misma de arriba abajo, a proposito: la coherencia entre paginas sale de que ninguna pueda inventarse su propio orden. Si algo no cabe se dice con la cuenta hecha, en vez de encogerlo hasta que no se lea. El COLOR del texto sale del tema que el informe tiene puesto, no del sistema: un informe solo admite un tema, y escribir el color del sistema pintaba el titulo casi invisible en cuanto los dos no coincidian. La geometria si es de la pagina. Si no cuadran se avisa. `dry_run=true` devuelve el spec con todas las posiciones y no escribe. Aplica el mismo camino que `pbi_apply_page_spec`, asi que pasa por la misma validacion y la misma transaccion.

NameTypeReqDescription
detail–––
dry_runboolean––
hero–––
kpis–––
page_namestring––
request_idstring––
subtitlestring––
supports–––
systemstringyes–
titlestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_convert_pbix_to_pbip ~409

Convierte uno o varios .pbix en proyectos .pbip (PBIR + TMDL). El informe sale del propio archivo: si el .pbix ya guarda PBIR se copia tal cual, y si trae el formato heredado se traduce pagina a pagina. El modelo NO se puede leer del archivo (es un backup comprimido del motor), asi que se ABRE EL .pbix EN POWER BI DESKTOP y se serializa a TMDL desde ahi. Cuenta con eso: cada archivo tarda lo que tarde Desktop en cargarlo. Si el informe ya esta abierto se reutiliza esa sesion; si lo abre esta tool, lo cierra al terminar (`close_desktop`). El .pbix original nunca se modifica. `path`: un .pbix o una CARPETA (`recursive` incluye subcarpetas). `out_dir`: carpeta donde crear el proyecto; se crea una subcarpeta por informe. Los dos son obligatorios y esos son sus nombres: `pbix_path` y `output_dir` NO existen como alias, porque un parametro obligatorio del contrato congelado no se puede sustituir por otro nombre. `include_model=false` genera solo la mitad del informe, sin tocar Desktop. `dataset_connection_string` es obligatorio para informes con conexion en vivo (los que no llevan modelo propio). Devuelve, por archivo, que se escribio y —lo importante— los avisos y lo que se quedo por el camino (`dropped`), como los marcadores.

NameTypeReqDescription
close_desktopboolean––
dataset_connection_string–––
desktop_timeoutinteger––
include_modelboolean––
out_dirstringyes–
overwriteboolean––
pathstringyes–
project_name–––
recursiveboolean––
request_id–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_copy_visual_format ~111

Copia el formato de un visual a otros DEL MISMO TIPO. Se copia el formato pero no el texto del titulo, que es contenido. Copiar entre tipos distintos se rechaza: la estructura de formato no es intercambiable y Power BI podria rechazar el informe.

NameTypeReqDescription
request_idstring––
source_pagestringyes–
source_visualstringyes–
target_pagestringyes–
target_visualsarrayyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_bookmark ~180

Crea un marcador: un estado del informe al que volver con un boton. Escribe el archivo del marcador Y lo mete en el indice: sin el indice Power BI no lo muestra aunque el archivo exista. `page`: id o titulo de la pagina que activara. `filters`: filtros a guardar, con la misma forma que en un page spec. `target_visuals` limita a que visuales afecta. Devuelve `usage`, listo para pasarselo a un boton con action='bookmark'.

NameTypeReqDescription
display_namestringyes–
filters–––
name–––
overwriteboolean––
pagestringyes–
request_idstring––
suppress_databoolean––
suppress_displayboolean––
target_visuals–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_calculated_column ~174

Crea una columna calculada (DAX) en una tabla del modelo .pbip. `data_type`: string | int64 | double | decimal | boolean | dateTime. `summarize_by`: como se agrega por defecto; 'none' para clasificaciones y textos, que es lo que casi siempre se quiere. Escribe en TMDL: requiere el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
data_typestring––
description–––
display_folder–––
expressionstringyes–
format_string–––
is_hiddenboolean––
namestringyes–
overwriteboolean––
request_idstring––
summarize_bystring––
tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_calculated_table ~205

Crea una tabla calculada (DAX) en el modelo .pbip. Resuelve el caso tipico de tener diez metricas guardadas en diez COLUMNAS en vez de en filas: con una tabla calculada que las dinamice se obtiene una matriz de verdad, en lugar de escribir una medida por columna. TMDL exige declarar las columnas y no se pueden adivinar leyendo el DAX: si no pasas `columns`, se deducen EJECUTANDO la expresion contra el modelo abierto en Power BI Desktop y leyendo el esquema que devuelve el motor. Para eso hace falta el modelo abierto Y seleccionado. Escribe en TMDL: requiere el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
columns–––
description–––
expressionstringyes–
namestringyes–
overwriteboolean––
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_hierarchy ~143

Crea una jerarquia sobre columnas de la misma tabla. `levels`: nombres de columna de MAYOR a MENOR granularidad (p.ej. ['Anio','Mes','Dia']). El orden es el de profundizacion y se respeta tal cual: no se ordena ni se deduplica porque es informacion. Escribe en TMDL: requiere el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
description–––
display_folder–––
levelsarrayyes–
namestringyes–
overwriteboolean––
request_idstring––
tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_html_visual ~139

Crea un visual "HTML Content" que renderiza el HTML/SVG devuelto por una medida. `html_measure`: medida cuyo resultado es HTML (p.ej. "[HTML Panel EVM]"). Registra el custom visual en el informe si aun no esta. La medida se crea aparte con pbi_create_measure (el HTML se arma en DAX, tipicamente con VARs y CONCATENATEX sobre los datos del modelo).

NameTypeReqDescription
html_measurestringyes–
pagestringyes–
positionobjectyes–
request_idstring––
title–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_measure ~256

Crea (o reemplaza con overwrite=true) una medida DAX. Valida que la tabla exista y que la medida no exista salvo overwrite. `data_category`: opcional, p.ej. "ImageUrl" para medidas que devuelven un data-URI SVG (Power BI las renderiza como imagen en tablas/matrices). Devuelve el diff antes/despues. mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip', o usa 'auto' y se mira el estado para elegir. Si estas construyendo desde cero, 'auto' o 'pbip': el defecto es 'live' y exige Desktop abierto.

NameTypeReqDescription
data_category–––
description–––
display_folder–––
expressionstringyes–
format_string–––
modestring––
namestringyes–
overwriteboolean––
request_idstring––
tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_page_from_spec ~113

Crea una hoja (pagina) PBIR completa a partir de un spec. `spec`: {page_name, canvas?, layout?(grid|dashboard|executive_summary), visuals:[{type,title,fields:{rol:refs},position?}]}. Clona visuales existentes del mismo tipo como plantilla. Hace backup. Omite 'position' en un visual para que se auto-acomode con 'layout'.

NameTypeReqDescription
request_idstring––
specobjectyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_pbip_project ~305

Crea un proyecto .pbip vacio pero valido, y lo deja activo. Por defecto escribe out_dir/name/name.pbip. Con subfolder=false (o si out_dir ya termina en .pbip) escribe out_dir/name.pbip con sus carpetas al lado, como Desktop, sin reemplazar nada que ya exista. Es el punto de partida para armar un tablero solo con rutas de archivos: crear el proyecto, cargarle los datos con pbi_add_table_from_file y componer las paginas, sin abrir Power BI Desktop hasta el final. Escribe el minimo que Power BI acepta —informe y modelo semantico apuntandose entre si— con la referencia en ruta RELATIVA: una absoluta ataria el proyecto a esta maquina. Incluye una pagina, porque un informe sin ninguna no abre. No declara `sourceQueryCulture` a proposito: la cultura se fija en cada consulta, que es lo unico que no obliga a suponer como escribe los decimales cada origen.

NameTypeReqDescription
culturestring––
heightinteger––
namestringyes–
open_projectboolean––
out_dirstringyes–
overwriteboolean––
page_namestring––
request_idstring––
subfolderboolean––
widthinteger––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_relationship ~186

Crea una relacion entre dos columnas del modelo .pbip. Por defecto muchos-a-uno con filtro en un sentido: es lo que crea Power BI y lo unico que no introduce ambiguedad. `cross_filtering` 'bothDirections' resuelve casos concretos y complica el modelo entero, asi que conviene justificarlo. Escribe en TMDL: requiere el proyecto CERRADO en Power BI Desktop.

NameTypeReqDescription
cross_filteringstring––
from_cardinalitystring––
from_columnstringyes–
from_tablestringyes–
is_activeboolean––
name–––
overwriteboolean––
request_idstring––
to_cardinalitystring––
to_columnstringyes–
to_tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_create_visual ~879

Crea un visual PBIR en una pagina. `visual_type` acepta: actionButton, areaChart, barChart, button, card, cardVisual, clusteredBarChart, clusteredColumnChart, columnChart, donut, donutChart, funnel, gauge, htmlContent, htmlContent443BE3AD55E043BF878BED274D3A6855, image, kpi, lineChart, matrix, multiRowCard, navigation, pageNavigator, pieChart, pivotTable, rectangle, ribbonChart, scatterChart, shape, slicer, table, tableEx, text, textbox, treemap, waterfall y waterfallChart. Para visuales con datos, valida antes de escribir los roles obligatorios, la cardinalidad maxima de cada rol y el tipo de campo admitido: dimension (`Grouping`), medida (`Measure`) o cualquiera de ambos (`GroupingOrMeasure`). Los elementos decorativos (texto, forma, imagen, navegador y boton) rechazan `fields` porque no llevan consulta. `fields`: rol -> campos, p.ej. {"category":"Tabla[Col]", "values":["[Medida]"], "legend":"Tabla[Col]"}. El rol se reconoce escrito como sea: el logico (`values`), el nombre que usa PBIR y que devuelve `pbi_list_visuals` (`Values`, `Y`, `Category`, `Data`) o un sinonimo (`measure`, `axis`). Cada campo puede ser `"Tabla[Campo]"` o el objeto que devuelve `pbi_list_visuals`, para poder leer una pagina y rehacerla sin traducir nada. Un rol que ese tipo de visual no tiene se RECHAZA con la lista de los validos. Antes se descartaba en silencio y el visual salia sin datos. `options`: formato adicional. Llaves reconocidas (una clave no reconocida se ignora, no se rechaza; ver `pbi_get_visual` para comprobar que quedo escrito): - `background_color`, `border_color` ('#RRGGBB'), `background_transparency` (0-100), `border_radius` (px): el marco de CUALQUIER visual (panel General > Efectos de Desktop). Sin `background_color`/`border_color` no se toca el marco. - `card`/`cardVisual`: `show_category_label`, `value_font_size`, `bold_value`, `value_color`. - `shape`: `fill`, `transparency`, `text`, `font_size`, `text_color`. - `textbox`: `text`, `font_size`…

NameTypeReqDescription
fieldsobjectyes–
options–––
pagestringyes–
positionobjectyes–
request_idstring––
title–––
visual_typestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_define_brief ~352

Escribe el BRIEF DE INTENCION del tablero: para que existe. Es la pieza que gobierna a las demas: la propuesta de paginas, el sistema de diseño y las auditorias leen este artefacto para servir a un proposito en vez de deducirlo todo del modelo. **Las respuestas son del HUMANO, no tuyas.** Antes de llamar, pregunta en conversacion: ¿para que quieres este tablero? ¿quien lo va a mirar? ¿que decisiones debe sostener? ¿como se va a ver (sala, escritorio, PDF, movil)? Un brief inventado por el agente es peor que ninguno: fija en un archivo con autoridad lo que nadie dijo. `delivery`: pantalla_sala | escritorio | lectura_pdf | movil — decide el sistema de diseño recomendado (legibilidad fisica, no estetica). `critical_fields`: [{field, why, min?, max?}] — que campos son criticos y sus umbrales; los usara el diagnostico de datos. Se guarda como `pbi-brief.json` JUNTO al .pbip (fuera de .Report/ .SemanticModel, que Desktop reescribe al guardar): versionado con el proyecto y editable en cualquier momento. Reescribirlo es normal: los tableros cambian de proposito.

NameTypeReqDescription
audiencestringyes–
critical_fields–––
decisions–––
delivery–––
key_questions–––
non_goals–––
purposestringyes–
request_idstring––
update_cadence–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_define_port_contract ~212

Escribe el CONTRATO del puerto del ecosistema (pbi-port-contract.json). El puerto NO es un bus de APIs entre Revit/Navisworks/Project —eso es fragil sin arreglo—: es un contrato de datos. Cada herramienta EMITE un dataset normalizado con una llave compartida, y este MCP lo valida y lo consume. `datasets`: [{name, key, columns: [{name, type, required?}], emitted_by?, description?}]. La llave es obligatoria: es lo que permite cruzar los datasets entre si (p.ej. HRZ_COD_PRES entre el modelo BIM, el presupuesto y el cronograma). Vive versionado junto al .pbip, como el brief. Se valida con pbi_check_contract: archivos entrantes antes de cargar, y el modelo activo despues.

NameTypeReqDescription
datasetsarrayyes–
namestring––
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_delete_bookmark ~51

Borra un marcador y lo quita del indice. Destructiva: confirm=true.

NameTypeReqDescription
confirmboolean––
namestringyes–
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_delete_measure ~161

Elimina una medida. Operacion destructiva: requiere confirm=true. mode='both' esta temporalmente deshabilitado bajo la politica estricta: 'live' necesita Power BI Desktop abierto y 'pbip' lo necesita cerrado, asi que una sola llamada aplicaria solo uno de los dos destinos. Elige 'live' o 'pbip', o usa 'auto' y se mira el estado para elegir. Si estas construyendo desde cero, 'auto' o 'pbip': el defecto es 'live' y exige Desktop abierto.

NameTypeReqDescription
confirmboolean––
modestring––
namestringyes–
request_idstring––
tablestringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_delete_page ~74

Elimina una pagina y actualiza el orden y la pagina activa. Destructiva: requiere confirm=true. Se niega a borrar la ultima pagina del informe, porque un informe sin paginas no abre.

NameTypeReqDescription
confirmboolean––
pagestringyes–
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_delete_visual ~68

Elimina un visual. Operacion destructiva: requiere confirm=true. Devuelve la definicion previa, y el journal permite restaurarla.

NameTypeReqDescription
confirmboolean––
pagestringyes–
request_idstring––
visual_idstringyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_detect_layout_issues ~92

Diagnostica la geometria de una pagina (o de todas). Solo lectura. Detecta solapamientos, visuales fuera del lienzo, tamanos demasiado pequenos, margenes, separaciones inconsistentes, orden Z duplicado o ausente, paginas vacias y paginas saturadas. Cada hallazgo trae su evidencia geometrica.

NameTypeReqDescription
page–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_diagnose_data ~336

Diagnostico de CONTENIDO contra el modelo VIVO: lo que rompe tableros y ningun metadato ve. Cuatro chequeos deterministas, cada uno con la consulta DAX que lo demuestra y muestras de los valores culpables: - **claves_huerfanas**: filas del lado muchos cuya clave no existe en el lado uno (caen al Blank de la relacion; los totales cuadran de menos sin error). Incluye claves EN BLANCO. - **grano_duplicado**: el lado uno con claves repetidas (todo se multiplica al cruzar). - **calendario_con_huecos**: dias faltantes en la tabla de fechas. - **umbral_del_brief_violado** y **campo_critico_inexistente**: los `critical_fields` del brief contra los datos reales. La severidad la decide el dueño: lo que declaro critico sale como `error`. No hay heuristicas "inteligentes" de outliers ni escalas: lo generico es determinista y lo subjetivo viene del brief. Un chequeo que no se pudo correr sale en `skipped` con su motivo — "no se comprobo" y "esta bien" no son lo mismo. Requiere el modelo ABIERTO en Desktop (consulta datos, no archivos). `tables` acota a las relaciones que tocan esas tablas.

NameTypeReqDescription
request_idstring––
tables–––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_diff_page_spec ~67

Compara el spec con una pagina existente antes de aplicarlo. Dice que visuales se anadirian, cuales sobrarian y cuantos quedan igual. Si la pagina no existe, informa que se creara.

NameTypeReqDescription
page–––
specobjectyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_disable_auto_date_time ~88

Activa/desactiva 'Auto fecha y hora' (solo modo pbip). Desactivarlo aligera el modelo: al reabrir el .pbip, Power BI elimina las tablas de fecha automaticas (LocalDateTable_*). Requiere proyecto .pbip activo.

NameTypeReqDescription
enabledboolean––
request_idstring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_distribute_visuals ~78

Reparte visuales con separacion uniforme. `axis`: horizontal|vertical. Necesita al menos tres visuales: con dos, la separacion ya es la que hay.

NameTypeReqDescription
axisstring––
pagestringyes–
request_idstring––
visual_idsarrayyes–
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_document_model ~68

Genera documentacion completa del modelo en Markdown. Incluye resumen, tablas, columnas, medidas, relaciones, jerarquias, roles (RLS) y advertencias de calidad. Guarda el archivo en outputs/.

NameTypeReqDescription
include_qualityboolean––
sourcestring––
NameTypeReqDescription
resultobjectyes–

No examples provided.

pbi_document_report_layout ~27

Genera documentacion Markdown del layout del informe (paginas y visuales).

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultobjectyes–

No examples provided.

Install

How do I install the Horizun PBI MCP server?

Horizun PBI MCP runs locally as a PyPI package, launched with uvx horizun-pbi-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · horizun-pbi-mcp

# add to Claude Code
claude mcp add horizungroup-horizun-pbi-mcp -- uvx horizun-pbi-mcp
Common questions

What is the Horizun PBI MCP server?

Horizun PBI MCP is listed in the public MCP registry as io.github.HorizunGroup/horizun-pbi-mcp. Build, audit and repair Power BI Desktop models and PBIP reports with DAX, TMDL and PBIR. This page covers its PyPI package (horizun-pbi-mcp).

Is the Horizun PBI MCP server safe to use?

Horizun PBI MCP scores 90 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Horizun PBI MCP server expose?

Horizun PBI MCP exposes 140 tools: pbi_profile_data, pbi_audit_project, pbi_audit_report_only, pbi_plan_audit_fixes, pbi_apply_audit_fixes, and 135 more. Their descriptions and schemas cost roughly 24,637 tokens of context every time the server is loaded.

Is the Horizun PBI MCP server still maintained?

Horizun PBI MCP is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Horizun PBI MCP server under?

Horizun PBI MCP declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.