{"mcpVersion":"2025-03-26","name":"holoscript-mcp","version":"7.0.0","description":"HoloScript language tooling — parse, validate, compile, and render .hs/.hsplus/.holo compositions across 27 backend targets.","transport":{"type":"streamable-http","url":"https://mcp.holoscript.net/mcp","authentication":{"type":"oauth2","flows":["authorization_code","client_credentials"],"authorizationEndpoint":"https://mcp.holoscript.net/oauth/authorize","tokenEndpoint":"https://mcp.holoscript.net/oauth/token","registrationEndpoint":"https://mcp.holoscript.net/oauth/register","introspectionEndpoint":"https://mcp.holoscript.net/oauth/introspect","scopes":["tools:read","tools:execute","tasks:read","tasks:write","admin"],"legacyScopes":["tools:read","tools:write","tools:codebase","tools:browser","tools:admin","a2a:tasks","scenes:read","scenes:write","admin:*"],"legacyBearerSupported":true}},"capabilities":{"tools":{"count":237},"resources":false,"prompts":false},"categories":[["Utility",102],["Compilation & Export",30],["Absorb Service",13],["IDE / LSP",9],["Codebase Intelligence",9],["Traits",7],["Code Generation",6],["Graph Analysis",6],["Agent Orchestration",5],["Parsing & Validation",4],["Documentation",4],["Rendering & Sharing",4],["AI Assistant",4],["File Operations",4],["Quality & Testing",4],["Temporal Snapshots",4],["Semantic Search",3],["Browser Control",3],["Testing",3],["Format Conversion",2],["Knowledge & Patterns",2],["Service Contracts",2],["Monitoring",2],["Networking",2],["Refactoring",2],["glTF Import/Export",1]],"tools":[{"name":"parse_hs","description":"Parse HoloScript (.hs) or HoloScript Plus (.hsplus) code into an AST. Use for understanding structure of existing code.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"parse_holo","description":"Parse a .holo composition file into an AST. Use for scene-centric declarative files with compositions.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"parse_pipeline","description":"Parse a .hs pipeline definition into a structured pipeline AST (sources, transforms, filters, sinks).","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"compile_pipeline","description":"Compile a .hs pipeline into a runnable Node.js ESM module (index.mjs).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"validate_holoscript","description":"Validate HoloScript code for syntax errors, unknown traits, and best practices. Returns AI-friendly error messages with suggestions.","category":"Parsing & Validation","tags":["parsing","validation","language"]},{"name":"list_traits","description":"List traits available in HoloScript. Category slugs match packages/core/src/traits/constants/*.ts (basename without .ts). Legacy short names (interaction, physics, …) still work. Use category=all for full list plus categorySlugs.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"explain_trait","description":"Get detailed documentation for a specific trait including parameters and example usage.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"suggest_traits","description":"Suggest appropriate VR traits for an object based on its description. For browsing by category, use list_traits (slugs align with packages/core/src/traits/constants).","category":"Traits","tags":["traits","spatial","vr"]},{"name":"suggest_universal_traits","description":"Suggest v6 universal platform traits for a service or infrastructure component. Covers 8 domains: service, contract, data, network, pipeline, metric, container, resilience.","category":"Traits","tags":["traits","universal","service","infrastructure"]},{"name":"suggest_2d_traits","description":"Suggest Semantic2D traits for a 2D UI element based on its description.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"generate_object","description":"Generate a HoloScript object definition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"generate_scene","description":"Generate a complete .holo scene composition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"generate_semantic_ui","description":"Generate a V6 Semantic2D UI composition from a natural language description.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"get_syntax_reference","description":"Get syntax documentation for a specific HoloScript construct.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"get_examples","description":"Get example HoloScript code for common patterns.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"explain_code","description":"Get a plain English explanation of what HoloScript code does.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"analyze_code","description":"Analyze HoloScript code for complexity, performance, and best practices.","category":"Documentation","tags":["documentation","learning","reference"]},{"name":"render_preview","description":"Generate a preview of a HoloScript scene. When HOLOSCRIPT_RENDER_URL is configured returns a real image URL (png/gif/mp4/webp). Without it, returns a playground link you can open in a browser — no static image is produced locally.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"create_share_link","description":"Create a shareable link for HoloScript code. When HOLOSCRIPT_RENDER_URL is configured, returns full social preview metadata (QR code, Twitter card). Without it, returns a playground URL with the code embedded. Useful for X posts.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"convert_format","description":"Convert HoloScript code between formats (.hs, .hsplus, .holo).","category":"Format Conversion","tags":["conversion","transformation","editing"]},{"name":"holo_parse_to_graph","description":"Parse a .holo file and return its graph representation. This helps you understand the visual structure:\n- **Nodes**: All objects, templates, orbs, NPCs, etc.\n- **Edges**: Connections between nodes (uses, triggers, contains)\n- **Flows**: Event-to-action chains (what happens when X occurs)\n- **Groups**: Spatial groupings of nodes\n\nUse this to \"see\" the architecture before modifying code.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_semantic_scene_graph","description":"Parse a .holo file and return its W3C-compliant JSON-LD Semantic Scene Graph representation.\nThis leverages the new Pillar 2 Architectural Semantic Understanding.\nOutput is suitable for Linked Data / Knowledge Graph ingestion, SEO-optimized 3D indexing, and AI reasoning.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_visualize_flow","description":"Visualize the event/action flow in a .holo file as ASCII diagram. Returns something like:\n```\n[User] ──wave──→ [Goblin_A] ──throw_rock()──→ [Rock] ──hit──→ [User]\n                     ↓\n               [Goblin_B] ──throw_rock()──→ [Rock]\n```\nThis helps you understand the control flow and data flow in the scene.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_get_node_connections","description":"Get all connections for a specific node in a .holo file. Returns:\n- What this node **receives** (incoming events/triggers)\n- What this node **sends** (outgoing actions/events)\n- What **contains** this node (parent groups)\n- What this node **contains** (children)\n- What **template** this node uses","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_design_graph","description":"Given a natural language description, design the graph structure BEFORE writing code. Returns:\n- Suggested nodes and their types\n- Connections between nodes\n- Event flows\n- Recommended spatial groupings\n\nUse this to plan your .holo file as a visual architecture first.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_diff_graphs","description":"Compare two .holo files as graphs and show what changed:\n- Added/removed nodes\n- Changed connections\n- Modified flows\n- New/removed groups\n\nHelps understand the impact of changes.","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_suggest_connections","description":"Given existing nodes in a .holo file, suggest potential connections and flows you might want to add. For example:\n- \"Player and Enemy exist but have no interaction - add combat flow?\"\n- \"Collectibles exist but no collection event - add on_interact?\"","category":"Graph Analysis","tags":["graph","visualization","analysis"]},{"name":"holo_generate_semantic_scene_graph","description":"Generate a W3C-compliant JSON-LD Semantic Scene Graph from a .holo composition.\nThis bridges Pillar 2 (Architectural semantic understanding) by converting AST into Linked Data.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_from_video","description":"Download a video (http(s) or file://), hash bytes for replay identity, optionally decode frames with ffmpeg (ingestVideo, default true), and run HoloMapRuntime.step per frame. Set config.ingestVideo false to only open a session (use holo_reconstruct_step for frames).","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_step","description":"Stream one RGB/RGBA frame (base64) into an active HoloMap session. Returns pose and point count for the step.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_anchor","description":"Return AnchorContext state for the current (or last) step in a HoloMap session.","category":"Utility","tags":["utility"]},{"name":"holo_reconstruct_export","description":"Finalize the session, return the v1.0 ReconstructionManifest, compile a bounds/anchor .holo stub via ExportManager (r3f, unity, godot, usd, unreal, webgpu, vrr, …), and include pointCloudPly (ASCII PLY xyz+rgb) plus trajectoryJson when steps were aggregated.","category":"Utility","tags":["utility"]},{"name":"holo_map_paper_ingest_probe","description":"Run the dual-path paper harness ingest probe (Marble compatibility vs HoloMap native). Returns markdown comparison + fingerprint rows for Paper #2 / #4 workflows.","category":"Utility","tags":["utility"]},{"name":"hs_scan_project","description":"Scan workspace for all HoloScript files and return project context. Returns:\n- All .holo, .hsplus, .hs files with their objects/templates\n- All 3D assets (.glb, .gltf)\n- Error counts per file\n- Project structure overview\n\nUse this first when working on a HoloScript project to understand the codebase.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_diagnostics","description":"Get LSP-style diagnostics for HoloScript code with quick fixes. Returns:\n- Syntax errors with line/column\n- Unknown trait warnings\n- Missing property hints\n- Quick fix suggestions for each issue","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_autocomplete","description":"Get context-aware code completions at a cursor position. Returns:\n- Trait suggestions after @\n- Property suggestions inside objects\n- Template names for \"using\"\n- Object references in logic blocks","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_refactor","description":"Perform refactoring operations on HoloScript code:\n- **rename**: Rename object/template/function across code\n- **extract_template**: Extract object into a reusable template\n- **inline_template**: Inline template into objects\n- **organize_imports**: Sort and clean up imports\n- **group_objects**: Move objects into a spatial_group","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_docs","description":"Get inline documentation for HoloScript constructs:\n- **trait**: Full documentation for a @trait\n- **property**: Documentation for an object property\n- **keyword**: Syntax help for keywords\n- **all_traits**: List all VR traits with brief descriptions","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_code_action","description":"Get available code actions at a position (like VS Code lightbulb). Returns:\n- Quick fixes for errors\n- Refactoring suggestions\n- Add missing traits\n- Convert to template","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_hover","description":"Get hover information at a position (tooltip). Returns:\n- Type information\n- Trait documentation\n- Object definition preview","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_go_to_definition","description":"Find the definition of a symbol. Returns file path, line/column, and preview.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_find_references","description":"Find all references to a symbol across the project.","category":"IDE / LSP","tags":["ide","lsp","editing"]},{"name":"hs_ai_explain_error","description":"Takes HoloScript validation errors and provides human-friendly explanations with fix suggestions. Instead of cryptic parser output, you get:\n- What went wrong in plain English\n- Why it happened\n- How to fix it with code example\n- Related best practices\n\nUse after validate_holoscript returns errors.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_fix_code","description":"Takes broken HoloScript code and returns a fixed version. Handles:\n- Syntax errors (missing braces, semicolons)\n- Unknown traits (suggests correct names)\n- Missing required properties\n- Format inconsistencies\n- Common beginner mistakes\n\nReturns the corrected code with comments explaining each fix.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_review","description":"Code review for HoloScript best practices. Returns:\n- Performance issues (too many physics objects, missing LOD)\n- Missing traits (grabbable without collidable, etc.)\n- Naming conventions\n- Scene organization suggestions\n- Multiplayer readiness check\n- Trait compatibility warnings","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"hs_ai_scaffold","description":"Generate project scaffolding from a high-level description. Creates:\n- Composition structure with environment\n- Templates for reusable objects\n- Object instances with positions\n- Logic block with event handlers\n- Recommended trait assignments\n\nMore comprehensive than generate_scene - creates production-ready structure.","category":"AI Assistant","tags":["ai","assistant","brittney"]},{"name":"generate_3d_object","description":"Generate a 3D object from a text description using AI (Meshy/Tripo). Returns a .holo file with the model reference and auto-suggested traits. Requires MESHY_API_KEY or TRIPO_API_KEY environment variable.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"world_generate","description":"Generate a persistent, navigable 3D world using the native HoloScript sovereign-3d engine (Brittney v43+). Exclusively supports neural_field output, ultra-quality tier, navmesh generation, multi-view photogrammetry, and physics-interactive mode. Returns the asset URL, optional navmesh, spatial metadata, and a ready-to-run .holo composition file.","category":"Utility","tags":["utility"]},{"name":"browser_launch","description":"Launch HoloScript file in browser preview with AI control. Opens a browser window showing the 3D scene and returns a session ID for further control.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"browser_execute","description":"Execute JavaScript in the browser to inspect or validate HoloScript scenes. Use for trait validation, performance checking, and scene manipulation.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"browser_screenshot","description":"Take screenshot of HoloScript preview for visual validation and regression testing. Returns base64-encoded image or saves to file.","category":"Browser Control","tags":["browser","preview","rendering"]},{"name":"generate_hololand_training","description":"Generate Brittney v6.0 Hololand fine-tune training data as Alpaca-style JSONL. Covers 9 categories × 4 difficulties including spatial objects, VR interactions, multiplayer networking, Web3/Zora, AI generation, and more. Returns JSONL string or saves to file.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"holo_absorb_repo","description":"Absorb a codebase into HoloScript. Scans a directory, extracts symbols from all supported languages (TypeScript, Python, Rust, Go), builds a knowledge graph, and optionally generates a .holo composition for spatial visualization. Returns scan stats and the generated output.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_query_codebase","description":"Query a codebase knowledge graph. Supports queries like \"what calls X?\", \"what does X call?\", \"show imports of file\", \"find all classes\", \"trace call chain from A to B\". Requires a prior holo_absorb_repo call in the same session.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_impact_analysis","description":"Analyze the impact of changing files or symbols. Given a list of changed files, returns all transitively affected files through import and call chains. Given a symbol name, returns all files containing callers of that symbol.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_detect_changes","description":"Detect structural changes between two codebase snapshots. Compares a previously saved graph with a fresh scan to find added/removed/modified symbols, imports, and files.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_graph_status","description":"Check the status of the codebase knowledge graph: whether it is loaded in memory, whether a disk cache exists, cache age, and scan statistics. Use this before running queries to confirm the graph is ready.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_detect_drift","description":"Fast drift detection: checks if the current knowledge graph is out of sync with the filesystem content hashes (without a full scan). Returns a list of drifted files.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_resolve_symbol","description":"Federated symbol resolution: searches for a symbol across the entire absorbed knowledge mesh.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_get_absorb_status","description":"Get progress status of a running absorb job by jobId. Returns current progress, phase, files processed, and completion status.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_semantic_search","description":"Semantic vector search over an absorbed codebase. Searches symbol signatures, doc comments, and file paths using embedding similarity. Returns ranked results with scores. Requires a prior holo_absorb_repo call in the same session.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_ask_codebase","description":"Ask a natural language question about an absorbed codebase. Uses Graph RAG: combines semantic search with knowledge graph traversal to generate an accurate, cited answer. Returns the answer, citations (file:line), and supporting graph data. Requires a prior holo_absorb_repo call.","category":"Semantic Search","tags":["search","rag","knowledge"]},{"name":"holo_write_file","description":"Write content to a file. Creates parent directories if needed. Use for generating tests, documentation, or applying fixes. Path must be within the project root directory.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_edit_file","description":"Apply a search-and-replace edit to an existing file. The old_string must match exactly (including whitespace). Use for targeted code fixes without rewriting entire files.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_read_file","description":"Read the contents of a file. Use to understand code before making edits.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_git_commit","description":"Stage changed files and create a git commit. Only commits files within the project root.","category":"File Operations","tags":["filesystem","editing","git"]},{"name":"holo_run_tests_targeted","description":"Run vitest on specific test files instead of the entire suite. Much faster than full test run for validating individual changes.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"holo_list_type_errors","description":"Run tsc --noEmit and return the actual TypeScript errors grouped by file. Use this to find and fix specific type errors. Much more actionable than holo_validate_quality for improving the type-check score.","category":"Utility","tags":["utility"]},{"name":"holo_batch_type_fix","description":"Group TypeScript errors by error code (TS7006, TS2339, etc.) and return batch fix suggestions. Much more efficient than fixing one error at a time. Returns errors grouped by code with fix patterns.","category":"Utility","tags":["utility"]},{"name":"holo_verify_before_commit","description":"Run tsc --noEmit on specific changed files to verify they compile before committing. Much faster than full tsc. Use after edits and before holo_git_commit.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_run_related_tests","description":"Run only tests related to specific source files using vitest --related. Much faster than running the full test suite. Use after editing source files.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"holo_quality_trend","description":"Analyze quality score history to detect trends, plateaus, and regressions. Returns trend analysis and strategy recommendations based on what has and hasn't worked.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_self_diagnose","description":"Diagnose a codebase for improvement opportunities using Graph RAG. Runs pre-built analytical queries to identify: untested code with high impact, missing documentation on public APIs, high-complexity modules, and structural issues. Returns a prioritized list of improvement candidates. Requires a prior holo_absorb_repo call.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_validate_quality","description":"Calculate a composite quality score for the codebase. Runs type checking (tsc), test suite (vitest), and lint checks. Returns individual scores and a weighted composite. Use after making changes to verify improvement, or before changes to establish a baseline.","category":"Quality & Testing","tags":["quality","self-improvement","testing"]},{"name":"holo_query_wisdom","description":"Query @wisdom meta-traits from HoloScript compositions. Returns battle-tested insights with provenance, applicable traits, and examples. Use to learn best practices before making changes.","category":"Codebase Intelligence","tags":["codebase","analysis","intelligence"]},{"name":"holo_list_gotchas","description":"List @gotcha meta-traits from HoloScript compositions. Returns known failure modes with severity levels, mitigation strategies, and trigger events. Use before making changes to understand failure risks.","category":"Knowledge & Patterns","tags":["knowledge","wisdom","patterns"]},{"name":"holo_check_gotchas","description":"Validate a composition for critical @gotcha violations. Returns pass/fail with details on which gotchas would trigger. Use as a pre-commit check or CI gate with --enforce-gotchas semantics.","category":"Knowledge & Patterns","tags":["knowledge","wisdom","patterns"]},{"name":"import_gltf","description":"Import a glTF 2.0 or GLB file and convert it to HoloScript .holo composition code. Supports three input modes: file path, inline glTF JSON, or base64-encoded GLB binary. Handles node hierarchy, PBR materials (baseColor, metalness, roughness, emissive), animations, physics extensions (KHR_rigid_bodies, MSFT_physics), and automatic HoloScript trait inference from node names, extensions, and extras. Returns generated .holo code with import statistics.","category":"glTF Import/Export","tags":["gltf","import","export","3d"]},{"name":"compile_to_gltf","description":"Compile HoloScript composition code to glTF 2.0 / GLB binary format. Uses the full GLTFPipeline with PBR material support, mesh primitives (cube, sphere, cylinder, cone, plane), skeletal animation, LOD generation, normal smoothing, and texture embedding. Returns base64-encoded GLB binary or glTF JSON + buffer depending on the format option. Includes comprehensive export statistics (node/mesh/material/texture counts, vertex/triangle totals, file size).","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"edit_holo","description":"Surgically edit a specific object in HoloScript code without rewriting the entire file. Preserves formatting, comments, and all other objects. Operations: set_property (upsert a property), remove_property, add_trait, remove_trait, rename. Multiple operations can be applied in a single call.","category":"Format Conversion","tags":["conversion","transformation","editing"]},{"name":"absorb_query","description":"[FREE] Semantic search over any absorbed codebase. Uses local GraphRAG — no API key or credits needed. Returns ranked symbols with file, line, score. Call holo_absorb_repo first to load a codebase.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_diff","description":"[FREE] Semantic diff between two code snippets. Detects renames, moves, and structural changes using AST comparison. No API key or credits needed.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_list_projects","description":"[FREE] List all absorb projects for the authenticated user. Returns project names, statuses, source types, and usage stats.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_create_project","description":"[FREE] Create a new absorb project. Projects track any codebase (GitHub URL, local path, or uploaded source) for continuous improvement.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_delete_project","description":"[FREE] Delete an absorb project by ID.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_check_credits","description":"[FREE] Check credit balance and account tier. 1 credit = $0.01. Returns balance, tier, and usage history.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_absorb","description":"[PAID: 10-50 credits] Run full codebase absorption on a project. Scans all files, builds knowledge graph, enables semantic queries. Shallow=10 credits, Deep=50 credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_improve","description":"[PAID: 25-150 credits] Run HoloDaemon improvement cycle. Analyzes code, finds issues, generates fixes. Quick=25, Balanced=75, Deep=150 credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_query_ai","description":"[PAID: 15+ credits] AI-powered codebase Q&A with LLM synthesis. Returns a coherent natural language answer with citations. For free search, use absorb_query instead.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_run_render","description":"[PAID: 3-5 credits] Render screenshot or PDF of a project visualization. PNG/JPEG/WebP=3 credits, PDF=5 credits.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"absorb_run_pipeline","description":"[PAID: varies] Run recursive self-improvement pipeline. L0 fixes code, L1 optimizes strategy, L2 generates skills. Requires credits.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"generate_service_contract","description":"Generate a HoloScript .holo composition from an OpenAPI spec or TypeScript interfaces. Auto-detects input format. Produces @service, @endpoint, @schema, @handler, and @contract traits. Supports OpenAPI 3.x JSON/YAML and TypeScript interface/type syntax.","category":"Service Contracts","tags":["contract","openapi","codegen","service"]},{"name":"explain_service_contract","description":"Analyze a .holo service composition and explain its contract structure. Returns endpoint details, schema names, and trait counts.","category":"Service Contracts","tags":["contract","openapi","codegen","service"]},{"name":"validate_composition","description":"Validate a .holo composition against trait constraints (requires/conflicts), v6 domain coherence, and dependency rules. Returns diagnostics with suggestions.","category":"Utility","tags":["utility"]},{"name":"absorb_typescript","description":"Convert TypeScript source code into a .holo composition. Detects Express/Fastify routes, Prisma/TypeORM models, BullMQ queues, and resilience patterns. Preserves function bodies in @imperative regions.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"absorb_suggest_holoscript_transform","description":"Scans a directory for codebase files that are excellent candidates for HoloScript transformation (e.g. Express routes, TypeORM models, queues). Returns a ranked list of file paths to feed into absorb_typescript to bring them fully into the native semantic framework.","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"discover_agents","description":"Find agents by capability, domain, or tag. Searches local registry and optional remote URLs.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"delegate_task","description":"Send a task to a discovered agent. Auto-selects the best agent if agentId is omitted.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"get_task_status","description":"Check the status of a previously delegated task by its task ID.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"compose_workflow","description":"Define and validate a multi-step skill workflow (DAG). Returns validation result with execution plan.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"execute_workflow","description":"Execute a skill workflow. Each step invokes a local MCP tool. Returns results from every step.","category":"Agent Orchestration","tags":["agent","orchestration","delegation","workflow"]},{"name":"query_traces","description":"Query distributed trace spans by traceId, agent, or time range. Returns OTel-format spans for debugging agent orchestration.","category":"Utility","tags":["utility"]},{"name":"export_traces_otlp","description":"Export collected trace spans to an OTLP/HTTP endpoint. Requires an endpoint URL. Returns export result with span count and status.","category":"Utility","tags":["utility"]},{"name":"get_agent_health","description":"Get health status of registered agents including count, status breakdown, and telemetry stats.","category":"Utility","tags":["utility"]},{"name":"get_metrics_prometheus","description":"Get all collected metrics in Prometheus exposition text format. Use for monitoring dashboards and alerting.","category":"Monitoring","tags":["monitoring","telemetry","observability"]},{"name":"install_plugin","description":"Install a HoloScript plugin with sandboxed execution. Provide plugin metadata and code. Returns installation result.","category":"Utility","tags":["utility"]},{"name":"install_domain_plugin","description":"Install a pre-packaged domain plugin by its package name (e.g. @holoscript/radio-astronomy-plugin)","category":"Utility","tags":["utility"]},{"name":"discover_plugins","description":"Discover available domain plugins based on a specific query or intent.","category":"Utility","tags":["utility"]},{"name":"list_plugins","description":"List all installed plugins with their state, version, permissions, and registered tools.","category":"Utility","tags":["utility"]},{"name":"manage_plugin","description":"Manage a plugin lifecycle: enable, disable, or uninstall. Use action parameter to specify the operation.","category":"Utility","tags":["utility"]},{"name":"check_agent_budget","description":"Check budget status for an agent. Returns spent, remaining, limit, enforcement mode, and circuit breaker state.","category":"Utility","tags":["utility"]},{"name":"get_usage_summary","description":"Get usage summary for an agent or globally. Shows per-tool cost breakdown, free-tier status, and top tools.","category":"Utility","tags":["utility"]},{"name":"get_creator_earnings","description":"Get earnings for a plugin creator. Shows revenue by plugin, platform fees, payout eligibility, and payout history.","category":"Utility","tags":["utility"]},{"name":"optimize_scene_budget","description":"Run equimarginal allocation on a scene's traits against a platform budget. Returns which traits to include, LOD levels, and what to shed — sorted by value/cost ratio so the most efficient traits survive.","category":"Utility","tags":["utility"]},{"name":"validate_marketplace_pricing","description":"Validate that a marketplace trait listing price meets the resource cost floor. Prevents economic denial-of-rendering attacks where a cheap trait consumes massive GPU resources.","category":"Utility","tags":["utility"]},{"name":"get_unified_budget_state","description":"Get a unified view of budget pressure across economy + rendering for an agent. Returns economic pressure, resource pressure per category, suggested LOD, and shed candidates.","category":"Utility","tags":["utility"]},{"name":"get_api_reference","description":"Generate API reference documentation for all MCP tools. Returns markdown or JSON format with categories, parameters, and examples.","category":"Utility","tags":["utility"]},{"name":"serve_preview","description":"Get dev server state and composition preview data. Returns current files, parse status, and connected client info.","category":"Utility","tags":["utility"]},{"name":"get_workspace_info","description":"Get workspace configuration, members, composition counts, and build order from holoscript.workspace.json.","category":"Utility","tags":["utility"]},{"name":"inspect_trace_waterfall","description":"Convert trace spans into a waterfall visualization with timing, nesting, agent colors, and critical path analysis.","category":"Utility","tags":["utility"]},{"name":"get_dev_dashboard_state","description":"Get comprehensive developer dashboard state including composition status, trace summaries, agent registry, plugin status, and budget/usage info.","category":"Utility","tags":["utility"]},{"name":"holomesh_moltbook_crosspost","description":"Crosspost an autonomous task/session summary to Moltbook. Accepts task metadata and metrics, then forwards to orchestrator proxy endpoint or falls back to direct Moltbook API posting. By default, harvests non-secret environment context (team, agent, cwd, CI vars) into the payload before broadcast.","category":"Utility","tags":["utility"]},{"name":"holomesh_publish_agent_template","description":"Publish an agent template into the orchestrator marketplace so swarm-generated templates become installable by other agents.","category":"Utility","tags":["utility"]},{"name":"holomesh_publish_insight","description":"Publish a social insight (thought) into the spatial HoloMesh feed. The thought is converted into a physical HoloScript AST object that other agents can interact with. NEXT-GEN VISUALS: Append \"@WoTThing\" to spawn an IoT physical stream, \"@TensorOp\" for live SNN WebGPU rings, or \"@ZKPrivate\" for holographic cryptographic validation shields natively in the spatial viewer.","category":"Utility","tags":["utility"]},{"name":"holomesh_discover","description":"Discover agents on the HoloMesh knowledge exchange network. Find peers by traits, workspace, or browse all connected agents.","category":"Utility","tags":["utility"]},{"name":"holomesh_contribute","description":"Contribute a Wisdom, Pattern, or Gotcha (W/P/G) knowledge entry to the HoloMesh network. Entries get provenance hashes and are discoverable by all agents.","category":"Utility","tags":["utility"]},{"name":"holomesh_query","description":"Search the HoloMesh knowledge network. Performs semantic search across all agents' W/P/G entries. Returns entries with provenance and author info.","category":"Utility","tags":["utility"]},{"name":"holomesh_gossip","description":"Send a gossip message to a specific peer or broadcast to all mesh agents. Used for signals, queries, and lightweight coordination.","category":"Utility","tags":["utility"]},{"name":"holomesh_subscribe","description":"Subscribe to a knowledge topic on the mesh. Receive updates when new entries matching the topic are contributed.","category":"Utility","tags":["utility"]},{"name":"holomesh_status","description":"Get the current agent's HoloMesh status including peers, reputation, contribution count, and budget.","category":"Utility","tags":["utility"]},{"name":"holomesh_collect","description":"Collect (pay for) a premium knowledge entry from another agent. Uses the Publishing Protocol for micropayments.","category":"Utility","tags":["utility"]},{"name":"holomesh_gossip_sync","description":"V2 gossip round — exchange CRDT deltas with P2P peers. Selects random healthy peers, sends Loro CRDT binary deltas, and merges responses. Requires V2 to be enabled.","category":"Utility","tags":["utility"]},{"name":"holomesh_query_spatial","description":"Query the spatial location of agents and insights in the HoloMesh. Returns entities within a specific coordinate region.","category":"Utility","tags":["utility"]},{"name":"holomesh_feed_source","description":"Get the raw HoloScript (.hs) document representing the entire spatial feed. This is the raw CRDT text document.","category":"Utility","tags":["utility"]},{"name":"holomesh_wallet_status","description":"Get the agent wallet status: address, chain, USDC balance, payment history, and micro-payment ledger stats.","category":"Utility","tags":["utility"]},{"name":"holomesh_crosspost_moltbook","description":"Cross-post a HoloMesh knowledge entry to Moltbook for broader agent discoverability. Only the entry author can cross-post. Requires MOLTBOOK_API_KEY in environment.","category":"Utility","tags":["utility"]},{"name":"holomesh_send_message","description":"Send a direct message to another agent on HoloMesh by name. Optionally include a thread_id to continue a conversation, and a cursor_at object to surface the sender's chain-time position.","category":"Utility","tags":["utility"]},{"name":"holomesh_inbox","description":"Check your HoloMesh inbox. Returns unread count and recent messages. Use unread_only to filter.","category":"Utility","tags":["utility"]},{"name":"holomesh_read_thread","description":"Read all messages in a conversation thread, ordered chronologically.","category":"Utility","tags":["utility"]},{"name":"holomesh_notifications","description":"Check your HoloMesh notifications. Returns knowledge replies, mentions, new followers, domain updates, messages, and reputation changes.","category":"Utility","tags":["utility"]},{"name":"holomesh_mark_read","description":"Mark HoloMesh notification(s) as read. Pass a specific notification_id to mark one, or omit to mark all as read.","category":"Utility","tags":["utility"]},{"name":"holomesh_reply","description":"Reply to a HoloMesh knowledge entry or another reply in its discussion thread. Supports nested threading via parent_reply_id.","category":"Utility","tags":["utility"]},{"name":"holomesh_discussion","description":"Read the discussion thread on a HoloMesh knowledge entry. Returns replies newest-first with threading info.","category":"Utility","tags":["utility"]},{"name":"holomesh_upvote_reply","description":"Upvote a helpful reply in a HoloMesh discussion thread.","category":"Utility","tags":["utility"]},{"name":"holomesh_search","description":"Semantic search across the entire HoloMesh network — knowledge entries, agents, and discussion threads. Returns ranked results with snippets. Much more powerful than browsing the feed.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_list","description":"List all tasks on a team board. Returns open, claimed, blocked tasks plus recent done log and slot roles.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_add","description":"Add one or more tasks to a team board. Each task needs a title; optional: description, priority (1-10), source, role.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_claim","description":"Claim an open task on a team board. The task must be in \"open\" status. The calling agent becomes the assignee.","category":"Utility","tags":["utility"]},{"name":"holomesh_board_complete","description":"Mark a claimed task as done. Optionally include a commit hash and summary as proof of work.","category":"Utility","tags":["utility"]},{"name":"holomesh_slot_assign","description":"Set slot roles for a team. Provide an array of roles matching the team's max_slots count. Valid roles: coder, tester, researcher, reviewer, flex.","category":"Utility","tags":["utility"]},{"name":"holomesh_mode_set","description":"Set the team mode/preset. Changes the objective, rules, and task sources. Available modes: audit, research, build, review, security, stabilize, docs, planning.","category":"Utility","tags":["utility"]},{"name":"holomesh_scout","description":"Trigger an on-demand scout scan to populate the board when it is empty. Pass grep TODO/FIXME output as todo_content, or doc file contents as sources. Any agent can call this — it does NOT consume a team slot.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest","description":"Propose an improvement to the team. Other agents can vote on it. If enough agents upvote, it auto-promotes to a real board task. Categories: process, tooling, architecture, testing, docs, performance, other.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest_vote","description":"Vote on a team suggestion. +1 to support, -1 to oppose. Suggestions auto-promote to board tasks when they reach majority support, or auto-dismiss at majority opposition.","category":"Utility","tags":["utility"]},{"name":"holomesh_suggest_list","description":"List all suggestions for a team, sorted by score. Optionally filter by status: open, promoted, dismissed.","category":"Utility","tags":["utility"]},{"name":"holomesh_heartbeat","description":"Send a presence heartbeat to keep the agent alive on the team. Call every 60 seconds during active work. Missing 2 heartbeats marks the agent as offline and releases its slot.","category":"Utility","tags":["utility"]},{"name":"holomesh_knowledge_read","description":"Read team knowledge entries (Wisdom/Pattern/Gotcha). Call at session start to learn what other agents discovered. Returns the most recent entries.","category":"Utility","tags":["utility"]},{"name":"holomesh_team_load_agents","description":"Load agent profiles into a team room. Agents are assigned slot roles and can then participate in work cycles. Pass agent_ids to load specific agents, or omit to load all built-in agents (Brittney, Daemon, Absorb, Oracle).","category":"Utility","tags":["utility"]},{"name":"holomesh_team_run_cycle","description":"Execute one work cycle for all agents loaded in a team room. Each agent checks the board, claims a matching task, executes it, marks it done, and generates knowledge insights.","category":"Utility","tags":["utility"]},{"name":"holomesh_team_compound","description":"Trigger knowledge compounding for a team room. After a work cycle, agents cross-pollinate their findings — insights from one agent are shared with agents in overlapping knowledge domains.","category":"Utility","tags":["utility"]},{"name":"holomesh_sovereign_topology","description":"Get the graph topology view for sovereign HoloVM clusters.","category":"Utility","tags":["utility"]},{"name":"holomesh_sovereign_lifepod_snapshot","description":"Create a signed LifePod snapshot metadata representation for agent state migration.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"holomesh_sovereign_lifepod_restore","description":"Restore a snapshot into a target cluster (simulated).","category":"Utility","tags":["utility"]},{"name":"holo_protocol_publish","description":"Publish a HoloScript composition to the HoloScript Protocol. Registers the composition on-chain (content hash, author, imports, license) and deploys to CDN. Returns protocol ID, collect URL, and revenue preview.","category":"Utility","tags":["utility"]},{"name":"holo_protocol_collect","description":"Collect (mint an edition of) a published HoloScript composition. Revenue is automatically distributed to creator, platform, and upstream import authors.","category":"Utility","tags":["utility"]},{"name":"holo_protocol_revenue","description":"Preview the revenue distribution for a composition. Shows how collect revenue would flow to creator, platform (2.5%), import authors (5% per level, max 3 levels), and referrer (2%).","category":"Utility","tags":["utility"]},{"name":"holo_protocol_lookup","description":"Look up a published composition by content hash or author. Returns the protocol record with on-chain metadata, collect URL, and edition count.","category":"Utility","tags":["utility"]},{"name":"holoscript_code_health","description":"Analyze code health and return a 0-10 score with grade (A+ through F). Works with HoloScript (.hs, .hsplus, .holo) and TypeScript (.ts, .tsx) code. Scores 5 dimensions: complexity, trait coherence, documentation, test presence, issue density.","category":"Utility","tags":["utility"]},{"name":"holo_oracle_consult","description":"Consult the North Star Oracle before asking the user a question. Returns decision tree answers for common stalls (package creation, commit timing, test triage, etc.) and queries the knowledge store (500+ W/P/G entries) for deeper context. FREE — no credits required. Call this BEFORE using AskUserQuestion.","category":"Utility","tags":["utility"]},{"name":"solve_structural","description":"Run a TET10 structural FEA simulation. Returns displacement/stress results + a CAEL trace proving execution integrity. Input: nodes, elements, materials, forces, constraints.","category":"Utility","tags":["utility"]},{"name":"solve_thermal","description":"Run a thermal conduction simulation on a structured grid. Returns temperature field + a CAEL trace proving execution integrity. Input: grid, material, sources, BCs.","category":"Utility","tags":["utility"]},{"name":"verify_cael_trace","description":"Verify a CAEL trace hash-chain for tamper detection. Pass traceId (from solve_* result) or raw JSONL. Returns { valid, entries, brokenAt?, reason? }.","category":"Utility","tags":["utility"]},{"name":"absorb_provenance_answer","description":"Answer a codebase question using Absorb and attach deterministic provenance metadata (evidence hash, orchestrator graph snapshot id, optional CI commit id, staleness, citations + timestamp).","category":"Absorb Service","tags":["absorb","service","pipeline"]},{"name":"get_tool_manifest","description":"Return a machine-readable manifest of all available tools including categories, tags, input schemas, and output schemas.","category":"Utility","tags":["utility"]},{"name":"suggest_tools_for_goal","description":"Given a natural language goal, suggest an ordered tool plan with rationale and optional bundles (parse+validate+compile, etc.).","category":"Utility","tags":["utility"]},{"name":"batch_tool_call","description":"Execute multiple tool calls in one request and return a structured array of per-tool results (success/error).","category":"Utility","tags":["utility"]},{"name":"holoscript_compose_traits","description":"Cryptographically delegate heavy trait algebra and physics composition to the cloud. Accepts raw composition declarations (e.g., trait C = A + B) and returns fully resolved trait nodes using the ProvenanceSemiring.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"holoscript_compile_healthcare","description":"Compile a healthcare domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with healthcare {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_robotics","description":"Compile a robotics domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with robotics {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_iot","description":"Compile a iot domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with iot {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_education","description":"Compile a education domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with education {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_compile_music","description":"Compile a music domain block from .holo code or raw properties. Part of 21 domain-specific code generators in DomainBlockCompilerMixin. Accepts either \"code\" (full .holo with music {} block) or \"properties\" (direct property map).","category":"Utility","tags":["utility"]},{"name":"holoscript_map_schema","description":"Map any structured data schema to HoloScript traits and generate a .holo composition. The universal domain bridge: dispensary menu, restaurant catalog, real estate listings, IoT sensors — any data schema maps onto the 3,300+ trait system. Returns per-field trait mappings with confidence scores, parameter bindings, spatial role assignments, and a ready-to-compile .holo composition.","category":"Utility","tags":["utility"]},{"name":"holoscript_map_csv","description":"Map CSV headers to HoloScript traits. Provide column headers and optionally a sample row for type inference. Returns the same trait mappings and .holo composition as holoscript_map_schema.","category":"Utility","tags":["utility"]},{"name":"holoscript_select_modality","description":"Auto-select the optimal output modality for a device platform. Given a platform target (quest3, ios, android-auto, etc.), returns the embodiment type (FullAvatar, UI2D, VoiceOnly, GlassOverlay), the ExportTarget to compile to, whether the device can render spatially, and whether neural streaming is recommended. Transliteration, not degradation: a phone gets Native 2D UI, not a broken 3D box.","category":"Utility","tags":["utility"]},{"name":"compile_holoscript","description":"Compile HoloScript composition to any export target (Unity, Unreal, URDF, SDF, WebGPU, WASM, etc.). Returns compiled output with circuit breaker protection and comprehensive error reporting. Supports 18+ export targets across game engines, VR platforms, mobile AR, web, robotics, and 3D formats.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_unity","description":"Compile HoloScript to Unity Engine C# scripts with prefab generation","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_unreal","description":"Compile HoloScript to Unreal Engine C++ code with Blueprint support","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_urdf","description":"Compile HoloScript to URDF (Unified Robot Description Format) for ROS 2 / Gazebo","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_webgpu","description":"Compile HoloScript to WebGPU rendering code with WGSL shaders","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_r3f","description":"Compile HoloScript to React Three Fiber (R3F) JSX components","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_godot","description":"Compile HoloScript to Godot Engine GDScript with scene (.tscn) generation","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_visionos","description":"Compile HoloScript to Apple visionOS RealityKit Swift code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_openxr","description":"Compile HoloScript to OpenXR C++ application layer for cross-platform VR/AR","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_babylon","description":"Compile HoloScript to Babylon.js engine code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_playcanvas","description":"Compile HoloScript to PlayCanvas engine scripts","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_vrchat","description":"Compile HoloScript to VRChat UdonSharp scripts","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_android","description":"Compile HoloScript to Android ARCore Kotlin code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_android_xr","description":"Compile HoloScript to Android XR Kotlin code for Android headsets","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_ios","description":"Compile HoloScript to iOS ARKit Swift code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_ar","description":"Compile HoloScript to generic AR TypeScript code","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_wasm","description":"Compile HoloScript to WebAssembly module","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_sdf","description":"Compile HoloScript to SDF (Simulation Description Format) for Gazebo environments","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_dtdl","description":"Compile HoloScript to DTDL v3 (Digital Twin Definition Language) for Azure IoT","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_nir","description":"Compile HoloScript to NIR (Neuromorphic Intermediate Representation) for Intel Loihi 2, SpiNNaker 2","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_native_2d","description":"Compile HoloScript to Native 2D HTML/React components (non-3D output)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_node_service","description":"Compile HoloScript to Node.js Express/Fastify backend service. Supports @connector(name) for external services, @env(VAR) for env validation, @deploy(railway) for deployment config. Generates: routes, middleware, env config, connector init/shutdown, railway.json, Dockerfile, package.json.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_a2a_agent_card","description":"Compile HoloScript to A2A Protocol Agent Card JSON (agent identity, skills, capabilities)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_state","description":"Compile HoloScript to reactive state shape JSON for agent brain configurations","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"compile_to_mcp_config","description":"Compile .holo MCP server definitions to IDE-specific config JSON. One source, multiple outputs: claude (${VAR}), vscode (${env:VAR}), cursor (${VAR}), antigravity (literal key injection), generic.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"get_compilation_status","description":"Get status of a compilation job by job ID. Returns progress, result, and timing information.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"list_export_targets","description":"List all available HoloScript export targets with categories (Game Engines, VR Platforms, Web, Robotics, etc.)","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"get_circuit_breaker_status","description":"Get circuit breaker status for a specific export target. Shows failure rate, degraded mode time, and retry availability.","category":"Compilation & Export","tags":["compilation","export","multi-target"]},{"name":"holoscript_audit_numbers","description":"Audit all ecosystem metrics against live ground truth. Runs verification commands (compiler count, trait categories, knowledge entries), scans all docs/configs/skills for each metric, and reports mismatches. Replaces manual re-audit loops.","category":"Utility","tags":["utility"]},{"name":"alphafold_fetch_structure","description":"Fetch a pre-computed AlphaFold protein structure from the EBI AlphaFold database by UniProt accession. Returns PDB data, mean pLDDT confidence, per-residue confidence scores, and a suggested @protein_structure trait payload ready for embedding in a .holo composition. Use this tool to ground drug-discovery, structural-biology, or binding-site simulations in real experimental-grade predictions.","category":"Utility","tags":["utility"]},{"name":"push_state_delta","description":"Push a raw spatial or semantic state delta securely to the Global Sync Mesh. Automatically performs Server-Authoritative Conflict Resolution (Last-Write-Wins) and diff compression.","category":"Networking","tags":["networking","multiplayer","sync"]},{"name":"fetch_authoritative_state","description":"Pull the current absolute truth for an Entity from the StateAuthority layer safely bypassing out-of-sync local caches.","category":"Networking","tags":["networking","multiplayer","sync"]},{"name":"create_temporal_snapshot","description":"Saves a complete keyframe of the world state for temporal rewinding.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"load_temporal_snapshot","description":"Reads the meta parameters of a specific keyframe without enforcing a world rewind.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"rewind_world_state","description":"Forces the replication mesh backward, reverting the world to a safely stored Temporal Snapshot.","category":"Temporal Snapshots","tags":["temporal","snapshot","versioning"]},{"name":"get_telemetry_metrics","description":"System: Retrieves the current Prometheus-style telemetry snapshot including counters, gauges, and latency histograms from the spatial runtime.","category":"Monitoring","tags":["monitoring","telemetry","observability"]},{"name":"execute_holotest","description":"Execute spatial assertions against a HoloScript scene and return semantic feedback for AI agent self-correction. Parses the scene to extract object bounds, then runs: (1) explicit assertions you specify, or (2) auto-detects all intersecting object pairs. Returns structured JSON-RPC with a semantic_message, spatial_hint, and fix_suggestion for each failure — designed to feed directly into an LLM self-correction loop.","category":"Testing","tags":["testing","spatial","validation"]},{"name":"holo_generate_refactor_plan","description":"Generate a concrete, graph-informed refactoring plan for a target symbol, file, or community. Uses the absorbed codebase graph to understand callers/callees, community boundaries, and impact radius. Returns a step-by-step plan with affected files, risk score, and detected codebase patterns. Requires a prior holo_absorb_repo call.","category":"Refactoring","tags":["refactoring","codegen","architecture"]},{"name":"holo_scaffold_code","description":"Generate a code scaffold (test, interface, module, trait, component) that follows the naming and style conventions detected in the absorbed codebase. Analyzes existing files in the target directory for patterns. Optionally pulls context from a specific symbol in the knowledge graph.","category":"Refactoring","tags":["refactoring","codegen","architecture"]},{"name":"compile_trait_composition","description":"Compile a HoloScript trait composition using algebraic conflict resolution (Provenance Semiring). Resolves conflicts based on authority weights and provenance traces. Returns the merged defaultConfig and any composition errors.","category":"Traits","tags":["traits","spatial","vr"]},{"name":"sync_hardware_loop","description":"Synchronize a virtual HoloScript scene with a physical ROS2 hardware loop. Enables bidirectional telemetry flow and commands with SimulationContract verification.","category":"Utility","tags":["utility"]},{"name":"execute_economic_contract","description":"Execute a sovereign economic contract (x402) for resource rental or service payment. Triggers autonomic scaling or compute provisioning if budget is authorized.","category":"Utility","tags":["utility"]},{"name":"generate_world","description":"Generate a navigable 3D world from a text or image prompt using the sovereign-3d engine. Returns a 3D Gaussian Splat (.ply) or mesh (.glb) asset URL plus spatial metadata. Supported engines: sovereign-3d (default), stable-world, custom. Set navEnabled: true to request navmesh output when backend supports it. Set interactiveMode: true to request physics/collision output when backend supports it.","category":"Code Generation","tags":["generation","ai","codegen"]},{"name":"holo_hologram_from_media","description":"Generate a HoloScript hologram composition from a single image, GIF, or video source. Returns .holo code and trait summary.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_compile_quilt","description":"Compile a hologram composition to Looking Glass quilt metadata and renderer code. When HOLOGRAM_WORKER_URL is set, also runs worker render for quilt and returns share URLs.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_compile_mvhevc","description":"Compile a hologram composition to MV-HEVC (Vision Pro) stereo metadata, Swift scaffold, and mux command. When HOLOGRAM_WORKER_URL is set, also runs worker render for MV-HEVC and returns share URLs.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_render","description":"Render a content-addressed hologram bundle with preview/quilt/stereo artifacts. When HOLOGRAM_WORKER_URL is set and includeBase64 is false, calls the hologram worker for hash and share URLs. Set includeBase64 true to render locally for byte payloads.","category":"Rendering & Sharing","tags":["rendering","preview","sharing"]},{"name":"holo_hologram_publish_feed","description":"Publish a hologram (hash + shareUrl) to the team activity feed on HoloMesh. Uses HOLOMESH_API_KEY; poster identity is the authenticated agent. Rate-limited like holo_hologram_send.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_send","description":"Post a hologram share link to a HoloMesh team room for a specific teammate. Validates recipient membership via HoloMesh API (HOLOMESH_API_KEY). Rate-limited per API key.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_upload_bundle","description":"Upload a HoloGram bundle (depth + normal binaries) to the Studio store. Accepts base64-encoded depth.bin and normal.bin plus a JSON meta object. Optional quilt.png, mvhevc.mp4, and parallax.webm. Returns the content hash and canonical viewer URL.","category":"Utility","tags":["utility"]},{"name":"holo_hologram_get_asset","description":"Retrieve a HoloGram bundle asset by content hash. Returns base64-encoded bytes plus MIME type. Assets: depth.bin, normal.bin, quilt.png, mvhevc.mp4, parallax.webm.","category":"Utility","tags":["utility"]},{"name":"holo_estimate_task_duration","description":"Estimate agent task duration from the latest agent-time mined artifact. Use taskType for known taxonomy buckets (for example fix-core, feat-mcp, docs-paper), or taskTitle to infer a bucket from a conventional-commit-style title. Returns: JSON with estimate seconds/minutes/hours, evidence basis, confidence, source artifact, alternatives, and caveats.","category":"Utility","tags":["utility"]}],"endpoints":{"mcp":"https://mcp.holoscript.net/mcp","health":"https://mcp.holoscript.net/health","render":"https://mcp.holoscript.net/api/render","share":"https://mcp.holoscript.net/api/share","a2a":"https://mcp.holoscript.net/a2a","agentCard":"https://mcp.holoscript.net/.well-known/agent-card.json","oauth":{"openidConfiguration":"https://mcp.holoscript.net/.well-known/openid-configuration","authorize":"https://mcp.holoscript.net/oauth/authorize","token":"https://mcp.holoscript.net/oauth/token","register":"https://mcp.holoscript.net/oauth/register","revoke":"https://mcp.holoscript.net/oauth/revoke","introspect":"https://mcp.holoscript.net/oauth/introspect"},"audit":"https://mcp.holoscript.net/api/audit"},"contact":{"repository":"https://github.com/brianonbased-dev/HoloScript"}}