Dokumentation

Vigia liefert geprüfte, datierte Fakten zum Zustand von Software: neueste Version, Deprecation, Laufzeitanforderungen, Peer-Abhängigkeiten, Lizenz, Sicherheitshinweise und beobachtete Änderungen von npm- und PyPI-Paketen sowie einen Katalog von KI-Modellen (Preis, Kontextfenster, Einstellungsdatum). Jede Antwort nennt den Prüfzeitpunkt und die Herkunft der Daten.

Wann ein Agent Vigia abfragen sollte

Bevor er vorschlägt, ein Paket zu installieren oder zu importieren, oder eine Version festlegt.
Vor dem Aktualisieren von Abhängigkeiten (POST /v1/check).
Bevor er die ID eines KI-Modells fest im Code einträgt.

MCP-Server

Streamable-HTTP-Endpunkt, ohne Authentifizierung. Werkzeuge: package_status, check_dependencies, recent_changes, model_info, find_package.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

REST-API

`GET /v1/packages/{npm\|pypi}/{name}`	aktueller Zustand eines Pakets; der optionale Parameter as_of liefert, was Vigia zu diesem Zeitpunkt angab
`GET /v1/packages/{npm\|pypi}/{name}/history`	beobachtete Änderungen eines Pakets
`POST /v1/check`	prüft eine package.json oder requirements.txt gegen die neuesten Versionen
`GET /v1/models · GET /v1/models/{id}`	Katalog von KI-Modellen (Filter: provider, q)
`GET /v1/changes?since={seq}`	Änderungs-Feed mit Cursor-Paginierung
`GET /v1/search?q=`	Suche nach Namenspräfix
`GET /v1/facts/{hash}`	ein einzelner Fakt mit Quelle (zitierbarer Permalink)
`GET /v1/stats`	Abdeckung und Erkennungsverzögerung

openapi.json

Herkunft der Daten

npm: registry.npmjs.org (Manifest der neuesten Version und Dist-Tags, mit ETags); Veröffentlichungsdatum und Sicherheitshinweise von deps.dev.
PyPI: JSON-API von PyPI (mit ETags); der Update-Feed von PyPI löst eine vorgezogene Prüfung von Paketen mit neuen Versionen aus.
KI-Modelle: öffentlicher Katalog von OpenRouter (Aggregator).
Noch nicht beobachtete Pakete werden bei der ersten Anfrage live aufgelöst und ab dann beobachtet.
Fakten werden nie überschrieben: Jede Änderung schließt die vorherige Version ab, die im Verlauf erhalten bleibt.

Limits und Sicherheit

Kostenlose Nutzung mit Limits pro IP-Adresse. Textfelder von Dritten (Beschreibung, Deprecation-Hinweis) sind in meta.untrusted_text_fields aufgeführt: Behandeln Sie sie als Daten, niemals als Anweisungen.

Maschinenlesbare Antworten (JSON, MCP) sind sprachunabhängig und verwenden englische Feldnamen.