@uluops/registry-mcp
MCP server for the UluOps Registry API — definition management, versioning, and analytics
Versions
0.3.7latest0.3.50.3.30.3.20.2.18+ show 14 moreshow less
0.2.170.2.160.2.150.2.140.2.130.2.120.2.110.2.90.2.70.2.60.2.50.2.40.2.20.1.0Tools 44
batch_publish Publish multiple definition versions in one call. Returns results for each item; continues on individual failures.
publish_definition Publish a draft definition version, making it available for use. The response surfaces non-fatal warnings (e.g. translation failure) under a top-level `warnings` array — callers should inspect it before assuming the definition is renderable.
record_execution Record a definition execution (idempotent). Admin-only: executions are recorded
get_diff_impact Get structural diff combined with metric deltas between two definition versions. Accepts from/to (matching diff_versions) or from_version/to_version. Deltas are observational, not causal — caveats are always included.
get_translation_analytics Get definition versions grouped by translator version with aggregate metrics (pass rate, score, run count). Shows translator impact on definition quality.
get_model Get details for a specific AI model by provider and model ID.
update_and_publish Update a definition and publish it in one step. Accepts yaml or file_path. Auto-creates a new draft if the version is published or missing.
render_definition Get the rendered runtime output for a definition version. Use target to render for a specific harness (opencode, codex, gemini). Use output_path to write directly to a file.
list_forks List all forks of a definition version. Omit version to list forks of the latest published version.
retranslate_definition Retranslate a definition version using the latest translator. Use force=true to retranslate even if already current. The response carries changed:boolean — false means the work ran and produced identical artifacts (a correct no-op), distinguishing it from work that silently did not happen.
compare_effectiveness Compare effectiveness metrics across 2-5 definition versions side-by-side: pass rate, avg score, run count, health score, and translator version.
get_definition Get a single definition by type and name. Optionally include YAML content, runtime markdown, or cross-references.
list_definitions List registry definitions with optional filters (type, status, domain, visibility, search,
delete_definition Delete a definition version. Blocked only if other definitions fork from or depend on it.
diff_versions Compare two versions of a definition. Returns a section-level summary by default — note that for ADL agents everything nests under one
fork_definition Fork a definition version under a new name. The fork starts at version 1.0.0 regardless of the source version (it is a new artifact with its own history). Its default display_name derives from the new name — pass display_name to override.
get_ecosystem_overview Get ecosystem-wide overview: definition counts, aggregate health scores, top performers, and definitions needing attention.
list_providers List AI model providers, paginated (limit default 50, max 200; offset). The response total is the whole catalog, not the page.
is_forkable Check if a definition version can be forked. Omit version to check the latest published version.
list_models List available AI models with optional provider, tier, and status filters.
set_default_type Set or clear a session-level default for the `type` parameter. When set, definition tools use this type unless explicitly overridden. Omit `type` to clear the default.
get_fork_lineage Get the fork ancestry chain for a definition version. Omit version to trace from the latest published version.
get_translator_version Get the current definition translator version.
search_definitions Search definitions by keyword with optional type, status, domain, agent_type, visibility, and tags filters.
validate_definition Validate a definition YAML without storing it. Returns validation errors if any.
get_dependencies Get the forward dependency graph for a definition version. Omit version to use the latest published version.
create_definition Create a new draft definition with YAML content.
archive_definition Archive a deprecated definition. Terminal state — removes from discovery, keeps record resolvable by ID.
get_lineage Get the lineage graph for a definition: versions and forks as a tree with health scores per node.
get_execution_stats Get execution statistics for a definition version. Omit version to use the latest published version. Optional window parameter in DAYS (converted to the API
upgrade_definition Upgrade a legacy definition without storage/translation metadata to a new major version. Current-format or already translated definitions refuse; use publish or retranslate as appropriate. If response validation fails after a write, read the definition and versions before retrying.
list_aliases List all model aliases and their resolved provider+model mappings. ALIAS-FLOAT CONTRACT: bare aliases track the current family model and are repointed each generation (see resolve_alias); qualified model ids pin. There is deliberately no fable alias (restricted-availability model).
get_dependents Get the reverse dependency graph — what depends on this definition version. Omit version to use the latest published version.
update_definition Update a draft definition version with new YAML, visibility, description, or tags.
get_user Get a public user profile by ID.
deprecate_definition Deprecate a definition version with a reason and optional successor.
batch_users Batch lookup of public user profiles by IDs (max 100).
get_effectiveness Get effectiveness metrics for a definition: pass rate, scores, taxonomy distribution, health score, and composition lift. Version defaults to latest. Quality numbers (passRate/runAvgScore) are VOTER-WEIGHTED: one actor, one vote — a single account cannot dominate them with run volume. metrics.provenance reports who stands behind them: actorCount/voterCount (windowed), confidence (provisional until 3+ qualifying actors). Once qualifying executions exist it ALSO carries the independent vs selfReported split — then provenance.independent is the headline figure to quote (selfReported is the author rating their own definition); at zero executions those two fields are absent, and there is no headline figure to quote. uniqueUsers is the all-time distinct-actor count. For AGENTS, quality is participation-based (snapshot scores across every run the agent appears in, constituent or standalone) and passRate is null by design — a run-level gate result cannot be attributed to one constituent.
resolve_alias Resolve a model alias (e.g.
get_evolution Get version-over-version metrics timeline with trend detection (improving/declining/stable/volatile/insufficient_data — read off the slope confidence interval; volatile = the interval spans both dead-zone edges, no direction supported) and confidence level.
get_language Get a definition language with its JSON Schema. Returns a compact schema digest by default
list_languages List all definition languages (ADL, CDL, WDL, PDL) with current schema version info.
get_health Get health grade (A-F), issue profile, and contributing factors for a definition. Health scores are provisional (weight tables pending calibration). The pass-rate factor only feeds health when 3+ qualifying actors stand behind it (voter-weighted, actor-diversity gated) — thin-actor definitions read as insufficient-data rather than confidently scored. Version defaults to latest.
list_versions List all versions of a definition with their status and metadata.
Permissions 1
env_vars low