{"_schemas_baked": "hot", "catalog_etag": "c181ae6c90bc7a1a", "domains": {"admin": [{"action": "admin.data.health", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.health", "related_tools": ["admin.data.people", "admin.data.dna_list"], "source": "overlay", "title": "Admin Data Health", "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Diagnose empty admin lists vs live DB without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["admin.data.people", "admin.data.dna_list"], "required_cap": "admin.read", "safe_action": "admin_data_health", "summary": "Cheap counts for platform admin data plane (projects/users DNA slices).", "title": "Admin Data Health", "when_to_use": "Diagnose empty admin lists vs live DB without opening the SPA.", "write_mode": null}, {"action": "admin.data.people", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.people", "related_tools": ["admin.data.health"], "source": "overlay", "title": "Admin Data People", "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Verify Access hub users/projects payloads for ecosystem owner.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "safe_action": "admin_data_people", "summary": "Admin people bundle: projects (list shape) + users for a project.", "title": "Admin Data People", "when_to_use": "Verify Access hub users/projects payloads for ecosystem owner.", "write_mode": null}, {"action": "admin.data.dna_list", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.data.dna_list", "related_tools": ["admin.data.health"], "source": "overlay", "title": "Admin Data Dna List", "when_to_use": "Compare dna-list totals with UI table row counts."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Compare dna-list totals with UI table row counts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["admin.data.health"], "required_cap": "admin.read", "safe_action": "admin_data_dna_list", "summary": "Paginated DNA list with unified_8dna_role filters for admin Data hub.", "title": "Admin Data Dna List", "when_to_use": "Compare dna-list totals with UI table row counts.", "write_mode": null}, {"action": "admin.database.schema_inventory", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.schema_inventory", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "source": "overlay", "title": "Admin Database Schema Inventory", "when_to_use": "Diagnose canonical drift without opening Ops database tab."}, "doc_audience": "operator", "domain_title": "Admin Database MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Diagnose canonical drift without opening Ops database tab.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_database.gen1", "related_tools": ["admin.database.integrity_8dna", "admin.database.migrations_ledger"], "required_cap": "admin.read", "safe_action": "admin_database_schema_inventory", "summary": "Full schema health report (static drift + live inventory + registry).", "title": "Admin Database Schema Inventory", "when_to_use": "Diagnose canonical drift without opening Ops database tab.", "write_mode": null}, {"action": "admin.database.integrity_8dna", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.integrity_8dna", "related_tools": ["admin.database.schema_inventory"], "source": "overlay", "title": "Admin Database Integrity 8Dna", "when_to_use": "Verify unified 8DNA graph health after migrations."}, "domain_title": "Admin Database MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Verify unified 8DNA graph health after migrations.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_database.gen1", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "safe_action": "admin_database_integrity_8dna", "summary": "Live 8DNA integrity scan (orphans, cycles, legacy parity).", "title": "Admin Database Integrity 8Dna", "when_to_use": "Verify unified 8DNA graph health after migrations.", "write_mode": null}, {"action": "admin.database.migration_flags", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migration_flags", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "source": "overlay", "title": "Admin Database Migration Flags", "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync."}, "domain_title": "Admin Database MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Check migrate_013 / migrate_018 toggles before schema sync.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_database.gen1", "related_tools": ["admin.database.schema_inventory", "admin.database.migrations_ledger"], "required_cap": "admin.read", "safe_action": "admin_database_migration_flags", "summary": "Read opt-in platform_db_init flags from data.config.database_migrations.", "title": "Admin Database Migration Flags", "when_to_use": "Check migrate_013 / migrate_018 toggles before schema sync.", "write_mode": null}, {"action": "admin.database.migrations_ledger", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.admin.gen1"], "id": "admin.database.migrations_ledger", "related_tools": ["admin.database.schema_inventory"], "source": "overlay", "title": "Admin Database Migrations Ledger", "when_to_use": "Confirm which migrate_* steps applied on this environment."}, "domain_title": "Admin Database MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_database.gen1"], "instruction_hint": "Confirm which migrate_* steps applied on this environment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_database", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_database.gen1", "related_tools": ["admin.database.schema_inventory"], "required_cap": "admin.read", "safe_action": "admin_database_migrations_ledger", "summary": "Recent platform_schema_migrations ledger rows.", "title": "Admin Database Migrations Ledger", "when_to_use": "Confirm which migrate_* steps applied on this environment.", "write_mode": null}], "agentnet": [{"action": "agentnet.balance", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.balance", "related_tools": ["agentnet.post_batch", "agentnet.batch_proof", "wallets.list"], "source": "overlay", "title": "Agentnet Balance", "when_to_use": "When an agent must read an on-ledger AGC balance (not JSON wallets)."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "When an agent must read an on-ledger AGC balance (not JSON wallets).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.post_batch", "agentnet.batch_proof", "wallets.list"], "required_cap": "agentcoin", "safe_action": "agentnet_balance", "summary": "Read AgentCoin (AGC) balance from the L0 PostgreSQL ledger for a project slice.", "title": "Agentnet Balance", "when_to_use": "When an agent must read an on-ledger AGC balance (not JSON wallets).", "write_mode": null}, {"action": "agentnet.batch_proof", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.batch_proof", "related_tools": ["agentnet.balance", "agentnet.post_batch"], "source": "overlay", "title": "Agentnet Batch Proof", "when_to_use": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.balance", "agentnet.post_batch"], "required_cap": "agentcoin", "safe_action": "agentnet_batch_proof", "summary": "Merkle inclusion paths for a posted AgentCoin batch (read-only).", "title": "Agentnet Batch Proof", "when_to_use": "Receipts, audits, or clients verifying a batch leg against the stored Merkle root.", "write_mode": null}, {"action": "agentnet.checkpoint.covering_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.covering_batch", "related_tools": ["agentnet.batch_proof", "agentnet.evidence_receipt"], "source": "overlay", "title": "Agentnet Checkpoint Covering Batch", "when_to_use": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.batch_proof", "agentnet.evidence_receipt"], "required_cap": "agentcoin", "safe_action": "agentnet_checkpoint_covering_batch", "summary": "Resolve the newest checkpoint epoch that covers a ledger ``batch_id`` (read-only).", "title": "Agentnet Checkpoint Covering Batch", "when_to_use": "Operator diagnostics: which epoch/checkpoint anchors a given batch without building a full proof.", "write_mode": null}, {"action": "agentnet.checkpoint.list_recent", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.list_recent", "related_tools": ["agentnet.checkpoint.covering_batch", "agentnet.batch_proof"], "source": "overlay", "title": "Agentnet Checkpoint List Recent", "when_to_use": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.checkpoint.covering_batch", "agentnet.batch_proof"], "required_cap": "agentcoin", "safe_action": "agentnet_checkpoint_list_recent", "summary": "List recent AgentCoin checkpoint epochs for a project (newest first; no ``batch_roots_json``).", "title": "Agentnet Checkpoint List Recent", "when_to_use": "Operator dashboards: epoch, batch id range, anchor status without downloading full batch root JSON.", "write_mode": null}, {"action": "agentnet.checkpoint.by_epoch", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.checkpoint.by_epoch", "related_tools": ["agentnet.checkpoint.list_recent", "agentnet.checkpoint.covering_batch"], "source": "overlay", "title": "Agentnet Checkpoint By Epoch", "when_to_use": "Auditor random access to a specific epoch without scanning list_recent."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Auditor random access to a specific epoch without scanning list_recent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.checkpoint.list_recent", "agentnet.checkpoint.covering_batch"], "required_cap": "agentcoin", "safe_action": "agentnet_checkpoint_by_epoch", "summary": "Fetch one checkpoint row by epoch (includes ``batch_roots_json`` when stored).", "title": "Agentnet Checkpoint By Epoch", "when_to_use": "Auditor random access to a specific epoch without scanning list_recent.", "write_mode": null}, {"action": "agentnet.post_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.post_batch", "related_tools": ["agentnet.balance", "agentnet.batch_proof"], "source": "overlay", "title": "Agentnet Post Batch", "when_to_use": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.balance", "agentnet.batch_proof"], "required_cap": "agentcoin_post|project_admin", "safe_action": "agentnet_post_batch", "summary": "Post a double-entry AgentCoin batch (idempotent per ``idempotency_key``).", "title": "Agentnet Post Batch", "when_to_use": "Treasury mint / internal settlement robots that must hit L0, not JSON wallets.", "write_mode": null}, {"action": "agentnet.compute_credits.quote", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.quote", "related_tools": ["agentnet.compute_credits.purchase", "agentnet.balance"], "source": "overlay", "title": "Agentnet Compute Credits Quote", "when_to_use": "Before purchasing compute credits; pairs with ``agentcoin.compute_credits.purchase``."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Before purchasing compute credits; pairs with ``agentcoin.compute_credits.purchase``.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.compute_credits.purchase", "agentnet.balance"], "required_cap": "agentcoin", "safe_action": "agentnet_compute_credits_quote", "summary": "Deterministic quote for AGC cost of compute credits (demo v1 rate table).", "title": "Agentnet Compute Credits Quote", "when_to_use": "Before purchasing compute credits; pairs with ``agentcoin.compute_credits.purchase``.", "write_mode": null}, {"action": "agentnet.compute_credits.purchase", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.compute_credits.purchase", "related_tools": ["agentnet.compute_credits.quote", "agentnet.post_batch"], "source": "overlay", "title": "Agentnet Compute Credits Purchase", "when_to_use": "Demo purchase path for AGC-backed runtime credits."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Demo purchase path for AGC-backed runtime credits.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.compute_credits.quote", "agentnet.post_batch"], "required_cap": "agentcoin_post|project_admin", "safe_action": "agentnet_compute_credits_purchase", "summary": "Purchase compute credits: AGC user→treasury batch + idempotent ``builder_energy`` top-up.", "title": "Agentnet Compute Credits Purchase", "when_to_use": "Demo purchase path for AGC-backed runtime credits.", "write_mode": null}, {"action": "agentnet.receipt.verify", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.receipt.verify", "related_tools": ["agentnet.compute_credits.purchase", "agentnet.batch_proof"], "source": "overlay", "title": "Agentnet Receipt Verify", "when_to_use": "Offline-ish verification of purchase or run receipts returned by the platform."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Offline-ish verification of purchase or run receipts returned by the platform.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.compute_credits.purchase", "agentnet.batch_proof"], "required_cap": "agentcoin", "safe_action": "agentnet_receipt_verify", "summary": "Verify an AgentCoin receipt JSON (canonical hash + optional Merkle proof + optional Ed25519).", "title": "Agentnet Receipt Verify", "when_to_use": "Offline-ish verification of purchase or run receipts returned by the platform.", "write_mode": null}, {"action": "agentnet.evidence_receipt", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.evidence_receipt", "related_tools": ["agentnet.batch_proof"], "source": "overlay", "title": "Agentnet Evidence Receipt", "when_to_use": "Operator or auditor needs checkpoint-linked proof bundle for a batch."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator or auditor needs checkpoint-linked proof bundle for a batch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.batch_proof"], "required_cap": "agentcoin", "safe_action": "agentnet_evidence_receipt", "summary": "Build a self-contained evidence receipt (batch proof + checkpoint prefix witness).", "title": "Agentnet Evidence Receipt", "when_to_use": "Operator or auditor needs checkpoint-linked proof bundle for a batch.", "write_mode": null}, {"action": "agentnet.bridge.intents", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.intents", "related_tools": ["agentnet.bridge.events"], "source": "overlay", "title": "Agentnet Bridge Intents", "when_to_use": "Operator monitors bridge backlog."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator monitors bridge backlog.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bridge.events"], "required_cap": "agentcoin", "safe_action": "agentnet_bridge_intents", "summary": "List bridge settlement intents for a project slice.", "title": "Agentnet Bridge Intents", "when_to_use": "Operator monitors bridge backlog.", "write_mode": null}, {"action": "agentnet.bridge.events", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.events", "related_tools": ["agentnet.bridge.intents"], "source": "overlay", "title": "Agentnet Bridge Events", "when_to_use": "Operator or indexer audits on-chain events mirrored for bridge."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator or indexer audits on-chain events mirrored for bridge.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bridge.intents"], "required_cap": "agentcoin", "safe_action": "agentnet_bridge_events", "summary": "List normalized bridge chain events (relay idempotency log).", "title": "Agentnet Bridge Events", "when_to_use": "Operator or indexer audits on-chain events mirrored for bridge.", "write_mode": null}, {"action": "agentnet.bridge.supply_snapshot", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.supply_snapshot", "related_tools": ["agentnet.bridge.intents", "agentnet.bridge.events"], "source": "overlay", "title": "Agentnet Bridge Supply Snapshot", "when_to_use": "Operator supply parity / bridge health checks."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator supply parity / bridge health checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bridge.intents", "agentnet.bridge.events"], "required_cap": "agentcoin", "safe_action": "agentnet_bridge_supply_snapshot", "summary": "L0 AGC balance sum + in-flight bridge intents + optional EVM ``totalSupply``.", "title": "Agentnet Bridge Supply Snapshot", "when_to_use": "Operator supply parity / bridge health checks.", "write_mode": null}, {"action": "agentnet.vault.nav", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.nav", "related_tools": ["agentnet.bridge.supply_snapshot"], "source": "overlay", "title": "Agentnet Vault Nav", "when_to_use": "Operator vault liquidity / share supply checks."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Operator vault liquidity / share supply checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bridge.supply_snapshot"], "required_cap": "agentcoin", "safe_action": "agentnet_vault_nav", "summary": "ERC-4626 vault NAV (totalAssets, totalSupply). REST: GET /api/agentnet/{project_id}/vault/nav", "title": "Agentnet Vault Nav", "when_to_use": "Operator vault liquidity / share supply checks.", "write_mode": null}, {"action": "agentnet.vault.deposit_confirm", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.vault.deposit_confirm", "related_tools": ["agentnet.vault.nav"], "source": "overlay", "title": "Agentnet Vault Deposit Confirm", "when_to_use": "After vault Deposit event observed on L2."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "After vault Deposit event observed on L2.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.vault.nav"], "required_cap": "agentcoin", "safe_action": "agentnet_vault_deposit_confirm", "summary": "Credit L0 agUSD shares after ERC-4626 deposit (operator/indexer).", "title": "Agentnet Vault Deposit Confirm", "when_to_use": "After vault Deposit event observed on L2.", "write_mode": null}, {"action": "agentnet.proof_to_task", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.proof_to_task", "related_tools": ["agentnet.receipt.verify"], "source": "overlay", "title": "Agentnet Proof To Task", "when_to_use": "Portable trust anchor for agent run receipts."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Portable trust anchor for agent run receipts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.receipt.verify"], "required_cap": "agentcoin", "safe_action": "agentnet_proof_to_task", "summary": "Build ERC-8004 proof-to-task bundle; optional on-chain validation submit.", "title": "Agentnet Proof To Task", "when_to_use": "Portable trust anchor for agent run receipts.", "write_mode": null}, {"action": "agentnet.chain.finality_probe", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.finality_probe", "source": "overlay", "title": "Agentnet Chain Finality Probe", "when_to_use": "Solana tooling grant — finality mapping without production relayer."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana tooling grant — finality mapping without production relayer.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "required_cap": "agentcoin", "safe_action": "agentnet_chain_finality_probe", "summary": "Read-only finality label probe (Solana adapter stub + Base chain id).", "title": "Agentnet Chain Finality Probe", "when_to_use": "Solana tooling grant — finality mapping without production relayer.", "write_mode": null}, {"action": "agentnet.bridge.create_intent", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bridge.create_intent", "mutation_risk": "low", "related_tools": ["agentnet.bridge.intents", "agentnet.bridge.events"], "source": "overlay", "title": "Agentnet Bridge Create Intent", "when_to_use": "Start AGNT bridge flow."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Start AGNT bridge flow.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bridge.intents", "agentnet.bridge.events"], "required_cap": "agentcoin_post", "safe_action": "agentnet_bridge_create_intent", "summary": "Create bridge intent (in|out). REST: POST /api/agentnet/{project_id}/bridge/intents", "title": "Agentnet Bridge Create Intent", "when_to_use": "Start AGNT bridge flow.", "write_mode": null}, {"action": "agentnet.funding.offer", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.offer", "related_tools": ["agentnet.funding.start_vault_deposit"], "source": "overlay", "title": "Agentnet Funding Offer", "when_to_use": "After payment_completed to show convert-to-agUSD offer."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "After payment_completed to show convert-to-agUSD offer.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.funding.start_vault_deposit"], "required_cap": "agentcoin_post", "safe_action": "agentnet_funding_offer", "summary": "Get funding offer after R1 USDT payment (opt-in R2 vault). REST: GET funding/offer", "title": "Agentnet Funding Offer", "when_to_use": "After payment_completed to show convert-to-agUSD offer.", "write_mode": null}, {"action": "agentnet.funding.start_vault_deposit", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.funding.start_vault_deposit", "related_tools": ["agentnet.funding.offer", "agentnet.vault.deposit_confirm"], "source": "overlay", "title": "Agentnet Funding Start Vault Deposit", "when_to_use": "User explicitly converts R1 payment path to R2 vault deposit."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "User explicitly converts R1 payment path to R2 vault deposit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.funding.offer", "agentnet.vault.deposit_confirm"], "required_cap": "agentcoin_post", "safe_action": "agentnet_funding_start_vault_deposit", "summary": "Start opt-in vault deposit intent linked to payment.", "title": "Agentnet Funding Start Vault Deposit", "when_to_use": "User explicitly converts R1 payment path to R2 vault deposit.", "write_mode": null}, {"action": "agentnet.admin.schema_status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.schema_status", "related_tools": ["agentnet.admin.schema_status"], "source": "overlay", "title": "Agentnet Admin Schema Status", "when_to_use": "Ops verify 9/9 M+ tables without false legacy Missing alarms."}, "domain_title": "Agentnet Admin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Ops verify 9/9 M+ tables without false legacy Missing alarms.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.admin.schema_status"], "required_cap": "agentcoin", "safe_action": "agentnet_admin_schema_status", "summary": "Substrate M+ schema snapshot (required / deprecated / packed_in_8dna tiers).", "title": "Agentnet Admin Schema Status", "when_to_use": "Ops verify 9/9 M+ tables without false legacy Missing alarms.", "write_mode": null}, {"action": "agentnet.admin.launch_readiness", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.launch_readiness", "related_tools": ["agentnet.admin.grant_metrics", "agentnet.testnet.list_profiles"], "source": "overlay", "title": "Agentnet Admin Launch Readiness", "when_to_use": "Grant submit gate and weekly evidence export."}, "domain_title": "Agentnet Admin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Grant submit gate and weekly evidence export.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.admin.grant_metrics", "agentnet.testnet.list_profiles"], "required_cap": "agentcoin", "safe_action": "agentnet_admin_launch_readiness", "summary": "Grant Readiness Score (GRS v2), blockers, and submit_ready flag.", "title": "Agentnet Admin Launch Readiness", "when_to_use": "Grant submit gate and weekly evidence export.", "write_mode": null}, {"action": "agentnet.admin.grant_metrics", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.admin.grant_metrics", "related_tools": ["agentnet.admin.launch_readiness"], "source": "overlay", "title": "Agentnet Admin Grant Metrics", "when_to_use": "Attach counters to grant applications."}, "domain_title": "Agentnet Admin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Attach counters to grant applications.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_admin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.admin.launch_readiness"], "required_cap": "agentcoin", "safe_action": "agentnet_admin_grant_metrics", "summary": "Weekly grant metrics slice from ecosystem 8DNA (read-only).", "title": "Agentnet Admin Grant Metrics", "when_to_use": "Attach counters to grant applications.", "write_mode": null}, {"action": "agentnet.arb.status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.status", "related_tools": ["agentnet.arb.proof_bundle_for_run"], "source": "overlay", "title": "Agentnet Arb Status", "when_to_use": "Check Arbitrum grant rail before proof bundle."}, "domain_title": "Agentnet Arb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Check Arbitrum grant rail before proof bundle.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_arb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.arb.proof_bundle_for_run"], "required_cap": "agentcoin", "safe_action": "agentnet_arb_status", "summary": "Arbitrum Sepolia rail status (RPC ping, registries).", "title": "Agentnet Arb Status", "when_to_use": "Check Arbitrum grant rail before proof bundle.", "write_mode": null}, {"action": "agentnet.arb.proof_bundle_for_run", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.arb.proof_bundle_for_run", "related_tools": ["agentnet.proof_to_task", "agentnet.arb.status"], "source": "overlay", "title": "Agentnet Arb Proof Bundle For Run", "when_to_use": "Arbitrum Foundation grant evidence."}, "domain_title": "Agentnet Arb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Arbitrum Foundation grant evidence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_arb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.proof_to_task", "agentnet.arb.status"], "required_cap": "agentcoin", "safe_action": "agentnet_arb_proof_bundle_for_run", "summary": "Build ERC-8004 proof-to-task bundle for a Fleet run (Arbitrum narrative).", "title": "Agentnet Arb Proof Bundle For Run", "when_to_use": "Arbitrum Foundation grant evidence.", "write_mode": null}, {"action": "agentnet.bnb.status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.status", "related_tools": ["agentnet.bnb.register_identity"], "source": "handler", "title": "Agentnet Bnb Status", "when_to_use": "Check BNBAgent integration before register or APEX jobs."}, "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Check BNBAgent integration before register or APEX jobs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bnb.register_identity"], "required_cap": "agentcoin", "safe_action": "agentnet_bnb_status", "summary": "BSC testnet rail status (RPC ping, registries).", "title": "Agentnet Bnb Status", "when_to_use": "Check BNBAgent integration before register or APEX jobs.", "write_mode": null}, {"action": "agentnet.bnb.register_identity", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.register_identity", "related_tools": ["agentnet.bnb.status", "agentnet.proof_to_task"], "source": "overlay", "title": "Agentnet Bnb Register Identity", "when_to_use": "On-chain discoverability for BNB grant demo."}, "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "On-chain discoverability for BNB grant demo.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bnb.status", "agentnet.proof_to_task"], "required_cap": "agentcoin", "safe_action": "agentnet_bnb_register_identity", "summary": "Register Fleet agent on BSC ERC-8004 via BNBAgent SDK.", "title": "Agentnet Bnb Register Identity", "when_to_use": "On-chain discoverability for BNB grant demo.", "write_mode": null}, {"action": "agentnet.bnb.proof_bundle_for_run", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.proof_bundle_for_run", "related_tools": ["agentnet.proof_to_task"], "source": "overlay", "title": "Agentnet Bnb Proof Bundle For Run", "when_to_use": "L0 proof-to-task bundle for agent run audit."}, "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "L0 proof-to-task bundle for agent run audit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.proof_to_task"], "required_cap": "agentcoin", "safe_action": "agentnet_bnb_proof_bundle_for_run", "summary": "L0 proof-to-task bundle for an agent run (read-only).", "title": "Agentnet Bnb Proof Bundle For Run", "when_to_use": "L0 proof-to-task bundle for agent run audit.", "write_mode": null}, {"action": "agentnet.bnb.apex_jobs_list", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.bnb.apex_jobs_list", "related_tools": ["agentnet.bnb.proof_bundle_for_run", "agentnet.bnb.status"], "source": "overlay", "title": "Agentnet Bnb Apex Jobs List", "when_to_use": "List runs with completed BNB APEX proof jobs."}, "domain_title": "Agentnet Bnb MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "List runs with completed BNB APEX proof jobs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_bnb", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.bnb.proof_bundle_for_run", "agentnet.bnb.status"], "required_cap": "agentcoin", "safe_action": "agentnet_bnb_apex_jobs_list", "summary": "List agent runs with completed BNB APEX jobs (L0 events).", "title": "Agentnet Bnb Apex Jobs List", "when_to_use": "List runs with completed BNB APEX proof jobs.", "write_mode": null}, {"action": "agentnet.chain.rails", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.rails", "related_tools": ["agentnet.chain.submit_intent"], "source": "overlay", "title": "Agentnet Chain Rails", "when_to_use": "Discover chain control rails before submitting intents."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Discover chain control rails before submitting intents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.chain.submit_intent"], "required_cap": "agentcoin", "safe_action": "agentnet_chain_rails", "summary": "List enabled chain control rails (CCM).", "title": "Agentnet Chain Rails", "when_to_use": "Discover chain control rails before submitting intents.", "write_mode": null}, {"action": "agentnet.chain.submit_intent", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.submit_intent", "related_tools": ["agentnet.chain.intent_status", "agentnet.chain.rails"], "source": "overlay", "title": "Agentnet Chain Submit Intent", "when_to_use": "Chain-triggered Fleet run via CCM gateway."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Chain-triggered Fleet run via CCM gateway.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.chain.intent_status", "agentnet.chain.rails"], "required_cap": "agentcoin", "safe_action": "agentnet_chain_submit_intent", "summary": "Submit a chain control intent (Fleet run by default).", "title": "Agentnet Chain Submit Intent", "when_to_use": "Chain-triggered Fleet run via CCM gateway.", "write_mode": null}, {"action": "agentnet.chain.intent_status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.chain.intent_status", "related_tools": ["agentnet.chain.submit_intent"], "source": "overlay", "title": "Agentnet Chain Intent Status", "when_to_use": "Poll intent execution after submit."}, "domain_title": "Agentcoin MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Poll intent execution after submit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentcoin", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.chain.submit_intent"], "required_cap": "agentcoin", "safe_action": "agentnet_chain_intent_status", "summary": "Get chain intent status by intent_id.", "title": "Agentnet Chain Intent Status", "when_to_use": "Poll intent execution after submit.", "write_mode": null}, {"action": "agentnet.genome.get", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.get", "related_tools": ["agentnet.genome.verify", "agentnet.proof_to_task"], "source": "overlay", "title": "Agentnet Genome Get", "when_to_use": "Verify stored lineage before on-chain commit or proof bundle."}, "domain_title": "Agentnet Genome MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Verify stored lineage before on-chain commit or proof bundle.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_genome", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.genome.verify", "agentnet.proof_to_task"], "required_cap": "agentcoin", "safe_action": "agentnet_genome_get", "summary": "Read L0 genome lineage entry for an entity (ecosystem.genome_lineage).", "title": "Agentnet Genome Get", "when_to_use": "Verify stored lineage before on-chain commit or proof bundle.", "write_mode": null}, {"action": "agentnet.genome.verify", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.genome.verify", "related_tools": ["agentnet.genome.get"], "source": "overlay", "title": "Agentnet Genome Verify", "when_to_use": "Verify GenomeTag commit_hash matches canonical JSON."}, "domain_title": "Agentnet Genome MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Verify GenomeTag commit_hash matches canonical JSON.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_genome", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.genome.get"], "required_cap": "agentcoin", "safe_action": "agentnet_genome_verify", "summary": "Verify commit_hash matches canonical GenomeTag JSON.", "title": "Agentnet Genome Verify", "when_to_use": "Verify GenomeTag commit_hash matches canonical JSON.", "write_mode": null}, {"action": "agentnet.solana.status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.status", "related_tools": ["agentnet.solana.register_identity"], "source": "overlay", "title": "Agentnet Solana Status", "when_to_use": "Check Solana PTR rail before register or validation submit."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Check Solana PTR rail before register or validation submit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.solana.register_identity"], "required_cap": "agentcoin", "safe_action": "agentnet_solana_status", "summary": "Solana devnet PTR attestation rail status.", "title": "Agentnet Solana Status", "when_to_use": "Check Solana PTR rail before register or validation submit.", "write_mode": null}, {"action": "agentnet.solana.register_identity", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.register_identity", "related_tools": ["agentnet.solana.status", "agentnet.solana.submit_validation"], "source": "overlay", "title": "Agentnet Solana Register Identity", "when_to_use": "Solana grant demo identity registration."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana grant demo identity registration.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.solana.status", "agentnet.solana.submit_validation"], "required_cap": "agentcoin", "safe_action": "agentnet_solana_register_identity", "summary": "Register Fleet agent metadata on Solana attestation program (devnet).", "title": "Agentnet Solana Register Identity", "when_to_use": "Solana grant demo identity registration.", "write_mode": null}, {"action": "agentnet.solana.proof_bundle_for_run", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.proof_bundle_for_run", "related_tools": ["agentnet.solana.submit_validation"], "source": "overlay", "title": "Agentnet Solana Proof Bundle For Run", "when_to_use": "Grant reviewer bundle reconstruction for Solana rail."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Grant reviewer bundle reconstruction for Solana rail.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.solana.submit_validation"], "required_cap": "agentcoin", "safe_action": "agentnet_solana_proof_bundle_for_run", "summary": "Build proof-to-task v2 bundle for a Fleet run (Solana PTR).", "title": "Agentnet Solana Proof Bundle For Run", "when_to_use": "Grant reviewer bundle reconstruction for Solana rail.", "write_mode": null}, {"action": "agentnet.solana.submit_validation", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_validation", "related_tools": ["agentnet.solana.proof_bundle_for_run"], "source": "overlay", "title": "Agentnet Solana Submit Validation", "when_to_use": "Anchor devnet tx after Fleet run completes."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Anchor devnet tx after Fleet run completes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.solana.proof_bundle_for_run"], "required_cap": "agentcoin", "safe_action": "agentnet_solana_submit_validation", "summary": "Submit task validation to Solana attestation program (best-effort).", "title": "Agentnet Solana Submit Validation", "when_to_use": "Anchor devnet tx after Fleet run completes.", "write_mode": null}, {"action": "agentnet.ptr.list_rails", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.ptr.list_rails", "related_tools": ["agentnet.solana.status", "agentnet.bnb.status"], "source": "overlay", "title": "Agentnet Ptr List Rails", "when_to_use": "Discovery before multi-rail PTR anchor."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Discovery before multi-rail PTR anchor.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.solana.status", "agentnet.bnb.status"], "required_cap": "agentcoin", "safe_action": "agentnet_ptr_list_rails", "summary": "List enabled PTR rails (Base, BNB, Arb, Solana) with strategies.", "title": "Agentnet Ptr List Rails", "when_to_use": "Discovery before multi-rail PTR anchor.", "write_mode": null}, {"action": "agentnet.solana.submit_intent", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.solana.submit_intent", "related_tools": ["agentnet.chain.submit_intent", "agentnet.solana.status"], "source": "overlay", "title": "Agentnet Solana Submit Intent", "when_to_use": "Solana CCM intent → Fleet (evidence_tier=none default)."}, "domain_title": "Agentnet Solana MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Solana CCM intent → Fleet (evidence_tier=none default).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_solana", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.chain.submit_intent", "agentnet.solana.status"], "required_cap": "agentcoin", "safe_action": "agentnet_solana_submit_intent", "summary": "Submit Solana chain control intent (CCM) via gateway.", "title": "Agentnet Solana Submit Intent", "when_to_use": "Solana CCM intent → Fleet (evidence_tier=none default).", "write_mode": null}, {"action": "agentnet.testnet.list_profiles", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.list_profiles", "related_tools": ["agentnet.testnet.run_scenario", "agentnet.testnet.faucet_mint"], "source": "overlay", "title": "Agentnet Testnet List Profiles", "when_to_use": "Before running grant testnet scenarios or faucet mint."}, "domain_title": "Agentnet Testnet MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Before running grant testnet scenarios or faucet mint.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.testnet.run_scenario", "agentnet.testnet.faucet_mint"], "required_cap": "agentcoin", "safe_action": "agentnet_testnet_list_profiles", "summary": "List AgentNet testnet chain profiles (lanes, faucet policy).", "title": "Agentnet Testnet List Profiles", "when_to_use": "Before running grant testnet scenarios or faucet mint.", "write_mode": null}, {"action": "agentnet.testnet.run_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.run_scenario", "related_tools": ["agentnet.testnet.list_profiles"], "source": "overlay", "title": "Agentnet Testnet Run Scenario", "when_to_use": "Ops grant E2E from MCP without shell scripts."}, "domain_title": "Agentnet Testnet MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Ops grant E2E from MCP without shell scripts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.testnet.list_profiles"], "required_cap": "agentcoin", "safe_action": "agentnet_testnet_run_scenario", "summary": "Run a registered testnet scenario (grant demo, bridge smoke, etc.).", "title": "Agentnet Testnet Run Scenario", "when_to_use": "Ops grant E2E from MCP without shell scripts.", "write_mode": null}, {"action": "agentnet.testnet.faucet_mint", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "id": "agentnet.testnet.faucet_mint", "mutation_risk": "low", "related_tools": ["agentnet.testnet.run_scenario"], "source": "overlay", "title": "Agentnet Testnet Faucet Mint", "when_to_use": "Fund buyer before grant_demo_full scenario."}, "domain_title": "Agentnet Testnet MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agentnet.ptr_rails.gen1"], "instruction_hint": "Fund buyer before grant_demo_full scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agentnet_testnet", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agentnet.ptr_rails.gen1", "related_tools": ["agentnet.testnet.run_scenario"], "required_cap": "agentcoin_post", "safe_action": "agentnet_testnet_faucet_mint", "summary": "Mint AGNT on L0 via testnet faucet (rate-limited).", "title": "Agentnet Testnet Faucet Mint", "when_to_use": "Fund buyer before grant_demo_full scenario.", "write_mode": null}], "agents": [{"action": "agents.list", "aliases": ["agents.catalog", "agents.fleet", "agents.list_agents"], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.list", "source": "overlay", "title": "Agents List", "when_to_use": "Discover configured agents before run/fork operations."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover configured agents before run/fork operations.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agents": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_list", "summary": "List Agents Fleet rows for a project (8DNA entity_type=agent).", "title": "Agents List", "when_to_use": "Discover configured agents before run/fork operations.", "write_mode": null}, {"action": "agents.get", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.get", "source": "overlay", "title": "Agents Get", "when_to_use": "Fetch AgentSpec before editing or running."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fetch AgentSpec before editing or running.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_get", "summary": "Get a single agent by UUID (default owner=project; personal rows need owner=user).", "title": "Agents Get", "when_to_use": "Fetch AgentSpec before editing or running.", "write_mode": null}, {"action": "agents.create", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create", "mutation_risk": "low", "source": "overlay", "title": "Agents Create", "when_to_use": "Provision a fleet agent."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"name": "example_string", "owner": "example_string", "project_id": 123}, "genetic_tags": ["core.agents.fleet.gen1"], "inputSchema": {"properties": {"name": {"description": "Display name", "type": "string"}, "owner": {"description": "project | user — create under project slice or under user's row", "type": "string"}, "project_id": {"description": "Logical project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Provision a fleet agent.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "rollback": ["agents.delete"], "safe_action": "agents_create", "summary": "Create a new agent row (draft AgentSpec).", "title": "Agents Create", "verification": ["agents.get", "agents.list"], "verify": [{"action": "agents.get", "predicate": "named resource is visible"}, {"action": "agents.list", "predicate": "named resource is visible"}], "when_to_use": "Provision a fleet agent.", "write_mode": null}, {"action": "agents.update", "anti_pattern": "Sending a partial agent_spec without section or path_updates — that replaces the whole spec.", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.update", "mutation_risk": "low", "source": "overlay", "title": "Agents Update", "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compil…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_update", "summary": "Update an agent. `section`+`section_value` or `path_updates` load the current AgentSpec, merge objects (lists replace), validate, then `update_agent_spec` (Logic sync for workflow, reactions, schedule", "title": "Agents Update", "when_to_use": "Persist one section or leaf. Merge keeps sibling fields. Workflow, reactions, and schedule compile because the write uses update_agent_spec.", "write_mode": ["patch", "merge", "replace", "write"], "write_mode_note": "section and path_updates default to merge (objects merge, lists replace). write_mode=replace sets the section or leaf wholesale. A full agent_spec without section/path_updates is a replace. write_mode=merge with only a partial agent_spec is rejected."}, {"action": "agents.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.delete", "mutation_risk": "low", "source": "overlay", "title": "Agents Delete", "when_to_use": "Remove an agent from the fleet."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "example_params": {"agent_id": "example_string", "owner": "example_string", "project_id": 123}, "genetic_tags": ["core.agents.fleet.gen1"], "inputSchema": {"properties": {"agent_id": {"description": "Agent uuid", "format": "uuid", "type": "string"}, "owner": {"description": "project (default) | user — personal agents: owner=user and context user_id must match row owner", "type": "string"}, "project_id": {"description": "Logical project id", "type": "integer"}}, "required": ["project_id", "agent_id"], "type": "object"}, "instruction_hint": "Remove an agent from the fleet.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "rollback": [], "safe_action": "agents_delete", "summary": "Delete an agent row.", "title": "Agents Delete", "verification": ["agents.list"], "verify": [{"action": "agents.list", "predicate": "named resource is visible"}], "when_to_use": "Remove an agent from the fleet.", "write_mode": null}, {"action": "agents.provider_preflight", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.provider_preflight", "source": "overlay", "title": "Agents Provider Preflight", "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"model": {"description": "string", "type": "any"}, "ok": {"description": "boolean", "type": "any"}, "provider": {"description": "string", "type": "any"}, "retryable": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_provider_preflight", "summary": "Read-only LLM provider snapshot for an agent before enqueue (quota hints, fallbacks).", "title": "Agents Provider Preflight", "when_to_use": "Before agents.run or agents.orchestrate when AgentSpec.llm.preflight_required is set.", "write_mode": null}, {"action": "agents.orchestrate", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.orchestrate", "mutation_risk": "low", "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.run_get", "agents.traces"], "source": "overlay", "title": "Agents Orchestrate", "when_to_use": "Project AI operator — prefer over raw agents.run when orchestrator is configured."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Project AI operator — prefer over raw agents.run when orchestrator is configured.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_uuid": {"description": "string", "type": "any"}, "run_uuid": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "related_tools": ["projects.orchestrator.get", "projects.orchestrator.patch", "agents.run_get", "agents.traces"], "required_cap": "mcp_read", "safe_action": "agents_orchestrate", "summary": "Run the project AI orchestrator for a channel (workspace|messenger|bot|mcp|api).", "title": "Agents Orchestrate", "when_to_use": "Project AI operator — prefer over raw agents.run when orchestrator is configured.", "write_mode": null}, {"action": "agents.run", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run", "mutation_risk": "low", "related_tools": ["agents.run_get", "agents.runs_list", "agents.traces", "agents.gates", "agents.approve_run"], "source": "handler", "title": "Agents Run", "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status)."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "inputSchema": {"properties": {"agent_id": {"description": "Agent uuid. Alias: agent_uuid.", "format": "uuid", "type": "string"}, "handoff_reason": {"description": "Handoff reason", "type": "string"}, "handoff_to_agent_id": {"description": "Target agent id for handoff", "type": "string"}, "idempotency_key": {"description": "Idempotent user/request key", "type": "string"}, "input": {"description": "Run input. A top-level message, prompt, or text is copied to input.message when that text is missing.", "type": "object"}, "message": {"description": "Task text when input.message is omitted. Aliases: prompt, text, task.", "type": "string"}, "owner": {"description": "project (default) | user — personal agents: owner=user and context user_id must match row owner", "type": "string"}, "parent_run_id": {"description": "Parent run id for handoff trees", "type": "string"}, "project_id": {"description": "Logical project id", "type": "integer"}, "root_run_id": {"description": "Root run id for handoff trees", "type": "string"}, "wait": {"description": "Wait briefly for terminal status", "type": "boolean"}, "wait_timeout_s": {"description": "Wait timeout in seconds (max 30)", "maximum": 30, "type": "number"}}, "required": ["project_id", "agent_id"], "type": "object"}, "instruction_hint": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"run_uuid": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}, "work_item_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "related_tools": ["agents.run_get", "agents.runs_list", "agents.traces", "agents.gates", "agents.approve_run"], "required_cap": "agents_run", "safe_action": "agents_run", "summary": "Enqueue an agent run (durable work queue).", "title": "Agents Run", "when_to_use": "Execute agent with policy caps; poll via agents.run_get (not discovery.job_status).", "write_mode": null}, {"action": "agents.run_with_agnt_credits", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_with_agnt_credits", "mutation_risk": "low", "source": "overlay", "title": "Agents Run With Agnt Credits", "when_to_use": "Autonomous demo: fund runtime energy from AGC then start a Fleet run."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Autonomous demo: fund runtime energy from AGC then start a Fleet run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_run_with_agnt_credits", "summary": "Demo orchestration: purchase compute credits (AGC) then enqueue an agent run.", "title": "Agents Run With Agnt Credits", "when_to_use": "Autonomous demo: fund runtime energy from AGC then start a Fleet run.", "write_mode": null}, {"action": "agents.fork", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.fork", "mutation_risk": "low", "source": "overlay", "title": "Agents Fork", "when_to_use": "Create a draft child generation for experimentation."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Create a draft child generation for experimentation.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_fork", "summary": "Fork an agent to a new generation (DNA row).", "title": "Agents Fork", "when_to_use": "Create a draft child generation for experimentation.", "write_mode": null}, {"action": "agents.stop", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.stop", "mutation_risk": "low", "source": "overlay", "title": "Agents Stop", "when_to_use": "Stop an in-flight run from automation or ops."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Stop an in-flight run from automation or ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_stop", "summary": "Cancel a running / queued agent run.", "title": "Agents Stop", "when_to_use": "Stop an in-flight run from automation or ops.", "write_mode": null}, {"action": "agents.kill", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.kill", "mutation_risk": "low", "source": "overlay", "title": "Agents Kill", "when_to_use": "Emergency stop for a misbehaving agent."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Emergency stop for a misbehaving agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_kill", "summary": "Set agent lifecycle state to killed (hard stop for new runs).", "title": "Agents Kill", "when_to_use": "Emergency stop for a misbehaving agent.", "write_mode": null}, {"action": "agents.promote", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.promote", "mutation_risk": "low", "source": "overlay", "title": "Agents Promote", "when_to_use": "After soak / canary, attempt promotion."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After soak / canary, attempt promotion.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"gates": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_promote", "summary": "Run auto-promotion gates; may set state to live when metrics pass.", "title": "Agents Promote", "when_to_use": "After soak / canary, attempt promotion.", "write_mode": null}, {"action": "agents.rollout_advance", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.rollout_advance", "mutation_risk": "low", "source": "overlay", "title": "Agents Rollout Advance", "when_to_use": "Progressive traffic shift for agent versions."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Progressive traffic shift for agent versions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_rollout_advance", "summary": "Advance canary rollout step (5→20→50→100).", "title": "Agents Rollout Advance", "when_to_use": "Progressive traffic shift for agent versions.", "write_mode": null}, {"action": "agents.metrics", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.metrics", "source": "overlay", "title": "Agents Metrics", "when_to_use": "Diagnostics and dashboards."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Diagnostics and dashboards.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"metrics": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_metrics", "summary": "Read rollup metrics for an agent (ecosystem.agents_metrics).", "title": "Agents Metrics", "when_to_use": "Diagnostics and dashboards.", "write_mode": null}, {"action": "agents.gates", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.gates", "source": "overlay", "title": "Agents Gates", "when_to_use": "Pre-promotion verification."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Pre-promotion verification.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"gates": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_gates", "summary": "Evaluate promotion gates for an agent.", "title": "Agents Gates", "when_to_use": "Pre-promotion verification.", "write_mode": null}, {"action": "agents.traces", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.traces", "related_tools": ["agents.run_get", "agents.approve_run"], "source": "overlay", "title": "Agents Traces", "when_to_use": "Debug a specific execution."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Debug a specific execution.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"events": {"description": "list", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "related_tools": ["agents.run_get", "agents.approve_run"], "required_cap": "agents_run", "safe_action": "agents_traces", "summary": "Return stored run events (trace buffer) for a run.", "title": "Agents Traces", "when_to_use": "Debug a specific execution.", "write_mode": null}, {"action": "agents.timeline", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.timeline", "source": "overlay", "title": "Agents Timeline", "when_to_use": "Inspect execution history before approve or debug."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect execution history before approve or debug.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"runs": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_timeline", "summary": "List recent runs for an agent (uuid + status + timestamps).", "title": "Agents Timeline", "when_to_use": "Inspect execution history before approve or debug.", "write_mode": null}, {"action": "agents.version_timeline", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.version_timeline", "source": "overlay", "title": "Agents Version Timeline", "when_to_use": "Inspect fork/promote lineage before rollout or rollback."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect fork/promote lineage before rollout or rollback.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"versions": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_version_timeline", "summary": "List agent version lineage (generation tree — REST GET /timeline parity).", "title": "Agents Version Timeline", "when_to_use": "Inspect fork/promote lineage before rollout or rollback.", "write_mode": null}, {"action": "agents.list_pending_approvals", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.list_pending_approvals", "source": "overlay", "title": "Agents List Pending Approvals", "when_to_use": "Operator queue before calling agents.approve_run with artifact hash."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Operator queue before calling agents.approve_run with artifact hash.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "list", "type": "any"}, "project_id": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_list_pending_approvals", "summary": "List runs waiting for approval across project or personal agent scope.", "title": "Agents List Pending Approvals", "when_to_use": "Operator queue before calling agents.approve_run with artifact hash.", "write_mode": null}, {"action": "agents.runs_list", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.runs_list", "source": "overlay", "title": "Agents Runs List", "when_to_use": "Per-agent history when agent_id is set; omit agent_id for project-wide recent runs (MCP bootstrap) or use agents.fleet_diagnostics for queue/stuck summary."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Per-agent history when agent_id is set; omit agent_id for project-wide recent runs (MCP bootstrap…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"runs": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_runs_list", "summary": "List agent runs with REST/SDK filters and lightweight audit fields.", "title": "Agents Runs List", "when_to_use": "Per-agent history when agent_id is set; omit agent_id for project-wide recent runs (MCP bootstrap) or use agents.fleet_diagnostics for queue/stuck summary.", "write_mode": null}, {"action": "agents.plan_get", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_get", "source": "overlay", "title": "Agents Plan Get", "when_to_use": "Inspect strategic/tactical goals before orchestrate or plan_patch."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect strategic/tactical goals before orchestrate or plan_patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"analytics": {"description": "object (when include_analytics=true)", "type": "any"}, "execution_eligibility": {"description": "object (when include_execution_eligibility=true)", "type": "any"}, "focus_affinities": {"description": "object (when include_affinities=true)", "type": "any"}, "metrics": {"description": "object", "type": "any"}, "plan_claim": {"description": "object (when include_claimable=true)", "type": "any"}, "task_list": {"description": "object", "type": "any"}, "tasks_projected": {"description": "array (when projection=tree or include_projected_children=true)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_get", "summary": "Read project Work Graph / plan (8DNA ecosystem.orchestrator.task_list) with metrics. Server-managed / read-only: root_run_id, claim lease fields (meta.claimed_at|lease_until|heartbeat_at|last_claim), ", "title": "Get Plan Graph", "when_to_use": "Inspect strategic/tactical goals before orchestrate or plan_patch.", "write_mode": null}, {"action": "agents.plan_preview_affinities", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_preview_affinities", "source": "overlay", "title": "Agents Plan Preview Affinities", "when_to_use": "Inspect affinity hints before pinning skills or genes."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect affinity hints before pinning skills or genes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"focus_affinities": {"description": "object", "type": "any"}, "task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_preview_affinities", "summary": "Preview suggested gene/skill hints on plan nodes (read-only, no DNA pin).", "title": "Agents Plan Preview Affinities", "when_to_use": "Inspect affinity hints before pinning skills or genes.", "write_mode": null}, {"action": "agents.plan_apply_affinities", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_apply_affinities", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Apply Affinities", "when_to_use": "Persist pinned skills/genes after preview."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist pinned skills/genes after preview.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_plan_apply_affinities", "summary": "Apply affinity hints and optionally pin skill_ids/gene_tags to plan DNA.", "title": "Agents Plan Apply Affinities", "when_to_use": "Persist pinned skills/genes after preview.", "write_mode": null}, {"action": "agents.plan_refresh_affinities", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_refresh_affinities", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Refresh Affinities", "when_to_use": "Legacy — prefer plan_preview_affinities / plan_apply_affinities."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Legacy — prefer plan_preview_affinities / plan_apply_affinities.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_refresh_affinities", "summary": "Deprecated alias: use plan_preview_affinities or plan_apply_affinities.", "title": "Agents Plan Refresh Affinities", "when_to_use": "Legacy — prefer plan_preview_affinities / plan_apply_affinities.", "write_mode": null}, {"action": "agents.plan_patch", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_patch", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Patch", "when_to_use": "Update project goals/tasks tree without full-blob DNA write."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Update project goals/tasks tree without full-blob DNA write.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_plan_patch", "summary": "Merge plan graph nodes (deep by id). Pass if_match_revision from plan_get for CAS (fleet/autonomous writers must send it). F1: when auto_generation_mode is on, pass env_uuid from sandbox fork; diff pa", "title": "Patch Plan Graph", "when_to_use": "Update project goals/tasks tree without full-blob DNA write.", "write_mode": null}, {"action": "agents.plan_claim", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_claim", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Claim", "when_blocked": {"expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_to_use": "After work_next returns next_action=agents.plan_claim with action_readiness.can_claim=true; pass node_ids + if_match_revision from the packet."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After work_next returns next_action=agents.plan_claim with action_readiness.can_claim=true; pass …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"claimed": {"description": "list", "type": "any"}, "task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_claim", "summary": "Claim pending plan leaves as in_progress for one agent (parallel work, WIP capped). Server-managed on claim: status, agent_id, meta.claimed_at|lease_until|heartbeat_at. Preserves title/objective/predi", "title": "Claim Plan Node", "when_blocked": {"expired_claim": "agents.plan_reclaim_stale — lease expired; do not treat as dependency_blocked", "plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "role_mismatch": "work_next handoff=true node_id=… — do not retry same agent", "wip_full": "Agent WIP cap reached — agents.plan_get then complete/release in_progress claims; retry plan_claim"}, "when_to_use": "After work_next returns next_action=agents.plan_claim with action_readiness.can_claim=true; pass node_ids + if_match_revision from the packet.", "write_mode": null}, {"action": "agents.plan_reclaim_stale", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reclaim_stale", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Reclaim Stale", "when_to_use": "Ops / fleet sweep when agents stalled mid-claim without inventing a second tracker."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops / fleet sweep when agents stalled mid-claim without inventing a second tracker.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"reclaimed": {"description": "list", "type": "any"}, "task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_reclaim_stale", "summary": "Return in_progress plan nodes with expired claim lease to ready (or pending if not eligible). Clears agent_id + lease meta; stamps meta.last_claim. Mutating DNA write — not read-only.", "title": "Reclaim Stale Claims", "when_to_use": "Ops / fleet sweep when agents stalled mid-claim without inventing a second tracker.", "write_mode": null}, {"action": "agents.plan_ingest", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.plan_ingest", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Ingest", "when_to_use": "Turn scan errors, Telegram/user requests, or agent findings into stable graph nodes."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Turn scan errors, Telegram/user requests, or agent findings into stable graph nodes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"decomposition_preview": {"description": "object", "type": "any"}, "ingest": {"description": "object", "type": "any"}, "intake_mode": {"description": "string", "type": "any"}, "task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_ingest", "summary": "Append diagnostic or work-intake findings as plan/Work Graph tasks. intake_mode=diagnostic (default) or work. Existing claimed nodes are left alone; matching issues bump occurrence_count.", "title": "Ingest Plan Work", "when_to_use": "Turn scan errors, Telegram/user requests, or agent findings into stable graph nodes.", "write_mode": null}, {"action": "agents.run_resume_packet", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_resume_packet", "source": "overlay", "title": "Agents Run Resume Packet", "when_to_use": "User says continue; new MCP client resumes an orchestration run."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "User says continue; new MCP client resumes an orchestration run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"resume": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_run_resume_packet", "summary": "Cross-provider continuation: goal, step, packet, skills — no chat transcript.", "title": "Agents Run Resume Packet", "when_to_use": "User says continue; new MCP client resumes an orchestration run.", "write_mode": null}, {"action": "agents.run_get", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.run_get", "source": "overlay", "title": "Agents Run Get", "when_blocked": {"invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied."}, "when_to_use": "Inspect one run including timeline, output, approval hash/TTL, and audit summary. Pass run_id; agent_id optional (resolved from run)."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Inspect one run including timeline, output, approval hash/TTL, and audit summary. Pass run_id; ag…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"run": {"description": "object", "type": "any"}, "run_detail": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_run_get", "summary": "Get a run row plus normalized RunDetailDTO for cockpit/audit views.", "title": "Agents Run Get", "when_blocked": {"invalid_parameters": "project_id and run_id required — agent_id is optional when run_id is supplied."}, "when_to_use": "Inspect one run including timeline, output, approval hash/TTL, and audit summary. Pass run_id; agent_id optional (resolved from run).", "write_mode": null}, {"action": "agents.approve_run", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.approve_run", "mutation_risk": "low", "source": "overlay", "title": "Agents Approve Run", "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_approve_run", "summary": "Approve a run stuck in waiting_for_approval and resume execution.", "title": "Agents Approve Run", "when_to_use": "Human checkpoint after agents.run_get shows waiting_for_approval. Pass the hash from that response.", "write_mode": null}, {"action": "agents.policy_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.policy_preview", "source": "overlay", "title": "Agents Policy Preview", "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "UI live preview while editing AgentPolicy; debug effective allowlist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"approval_required": {"description": "list", "type": "any"}, "denied": {"description": "list", "type": "any"}, "effective_actions": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_policy_preview", "summary": "Expand AgentPolicy patterns to live MCP actions (preview, no persistence).", "title": "Agents Policy Preview", "when_to_use": "UI live preview while editing AgentPolicy; debug effective allowlist.", "write_mode": null}, {"action": "agents.templates_list", "aliases": ["agents.templates"], "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.templates_list", "source": "overlay", "title": "Agents Templates List", "when_to_use": "Discover template_id before agents.create_from_template."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Discover template_id before agents.create_from_template.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"templates": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_templates_list", "summary": "List built-in Agent Fleet templates (canonical Python catalog).", "title": "List Agent Templates", "when_to_use": "Discover template_id before agents.create_from_template.", "write_mode": null}, {"action": "agents.template_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.template_preview", "source": "overlay", "title": "Agents Template Preview", "when_to_use": "Show users what a template will apply before create."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Show users what a template will apply before create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_spec": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_template_preview", "summary": "Return merged AgentSpec-shaped preview for a template (no persistence).", "title": "Preview Agent Template", "when_to_use": "Show users what a template will apply before create.", "write_mode": null}, {"action": "agents.create_from_template", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.create_from_template", "mutation_risk": "low", "source": "overlay", "title": "Agents Create From Template", "when_to_use": "Provision a fleet agent from catalog without client-side merge."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Provision a fleet agent from catalog without client-side merge.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent": {"description": "object", "type": "any"}, "agent_id": {"description": "string", "type": "any"}, "bound_node_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_admin", "safe_action": "agents_create_from_template", "summary": "Create an agent row from a built-in template (atomic merge on server).", "title": "Create Agent from Template", "when_to_use": "Provision a fleet agent from catalog without client-side merge.", "write_mode": null}, {"action": "agents.ensure_agent", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "effect_override": {"conditional_mutate": true, "effect_depends_on_params": true, "kind": "read", "mutates_when": {"create": true}}, "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.ensure_agent", "mutation_risk": "low", "source": "overlay", "title": "Agents Ensure Agent", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim"}, "when_to_use": "When work_next recovery recommends ensure_agent or execution shows provision_required / fully_provisionable — never skip the create=false preview.", "write_when": ["params.create=true"]}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "conditional_mutate": true, "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "mutates_when": {"create": true}, "read_only_hint": true, "risk_class": "read", "write_mode": false}, "effect_override": {"conditional_mutate": true, "effect_depends_on_params": true, "kind": "read", "mutates_when": {"create": true}}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "When work_next recovery recommends ensure_agent or execution shows provision_required / fully_pro…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_id": {"description": "string", "type": "any"}, "blocked_reason": {"description": "string", "type": "any"}, "created": {"description": "boolean", "type": "any"}, "graph_revision": {"description": "integer", "type": "any"}, "node_id": {"description": "string", "type": "any"}, "preview_template_id": {"description": "string", "type": "any"}, "template_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_ensure_agent", "summary": "Resolve or provision a plan-node executor. Read-only by default (effect.kind=read); create=true provisions from top compatible template with bind_node=False, validates eligibility, then returns next_a", "title": "Ensure Plan Executor", "when_blocked": {"capability_mismatch": "agents.ensure_agent create=false (H5) then create=true, or plan_propose mode=repair_plan", "created_agent_not_eligible": "Provision rolled back — plan_propose mode=repair_plan or pick template with matching caps (H5)", "ensure_agent_stamp_mismatch": "Replay create=false preview; create=true must match preview_template_id + graph_revision", "provision_required": "ensure_agent create=false (H5) then create=true then plan_claim"}, "when_to_use": "When work_next recovery recommends ensure_agent or execution shows provision_required / fully_provisionable — never skip the create=false preview.", "write_mode": null}, {"action": "agents.automation_map", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.automation_map", "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "source": "overlay", "title": "Agents Automation Map", "when_to_use": "Orchestration hub map before wiring agents to Logic or support."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration hub map before wiring agents to Logic or support.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agents": {"description": "list", "type": "any"}, "support_bindings": {"description": "list", "type": "any"}, "workflows": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "related_tools": ["agents.list", "logic.list", "social.support.inbox"], "required_cap": "mcp_read", "safe_action": "agents_automation_map", "summary": "Fleet automation aggregate: triggers, Logic rule ids, support ownership.", "title": "Agents Automation Map", "when_to_use": "Orchestration hub map before wiring agents to Logic or support.", "write_mode": null}, {"action": "agents.import_from_asset", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.import_from_asset", "mutation_risk": "low", "related_tools": ["agents.get", "agents.run", "assets.get"], "source": "overlay", "title": "Agents Import From Asset", "when_to_use": "Fulfill purchased agent template asset into Fleet."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Fulfill purchased agent template asset into Fleet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_id": {"description": "string", "type": "any"}, "agent_spec": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "related_tools": ["agents.get", "agents.run", "assets.get"], "required_cap": "agents_admin", "safe_action": "agents_import_from_asset", "summary": "Create agent from commerce asset extensions.agent_fleet preset.", "title": "Agents Import From Asset", "when_to_use": "Fulfill purchased agent template asset into Fleet.", "write_mode": null}, {"action": "agents.fleet_diagnostics", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.fleet_diagnostics", "source": "overlay", "title": "Agents Fleet Diagnostics", "when_to_use": "Ops triage for agents fleet and orchestrator binding before orchestrate."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops triage for agents fleet and orchestrator binding before orchestrate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "agents_run", "safe_action": "agents_fleet_diagnostics", "summary": "Project fleet diagnostics: runs, queue, orchestrator agent binding.", "title": "Agents Fleet Diagnostics", "when_to_use": "Ops triage for agents fleet and orchestrator binding before orchestrate.", "write_mode": null}, {"action": "agents.skills_list", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_list", "source": "overlay", "title": "Agents Skills List", "when_to_use": "Instruction plane — discover skill ids before orchestrate."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Instruction plane — discover skill ids before orchestrate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"skills": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_skills_list", "summary": "List ecosystem skill cards (fixture + optional ecosystem overlay).", "title": "Agents Skills List", "when_to_use": "Instruction plane — discover skill ids before orchestrate.", "write_mode": null}, {"action": "agents.skills_get", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.instruction_plane.gen1"], "id": "agents.skills_get", "source": "overlay", "title": "Agents Skills Get", "when_to_use": "MCP interop — load procedure text for external agents."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "MCP interop — load procedure text for external agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"skill": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_skills_get", "summary": "Fetch one skill card with progressive disclosure (full text).", "title": "Agents Skills Get", "when_to_use": "MCP interop — load procedure text for external agents.", "write_mode": null}, {"action": "agents.skills_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.skills_preview", "source": "overlay", "title": "Agents Skills Preview", "when_to_use": "Compose packet skill_preview without full bodies."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Compose packet skill_preview without full bodies.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"previews": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_skills_preview", "summary": "Short skill preview for instruction packet (title + excerpt).", "title": "Agents Skills Preview", "when_to_use": "Compose packet skill_preview without full bodies.", "write_mode": null}, {"action": "agents.team.create", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.orchestrator.gen1"], "id": "agents.team.create", "source": "overlay", "title": "Agents Team Create", "when_to_use": "Team/specialist fleet goals — taxonomy agents.team.create; GET /mcp/prompts/get?name=agentstack_closed_loop_autonomy for plan graph + parallel agents."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "conditional_mutate": "ingest_playbook_plan_nodes when goal routes to agents.team.create", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Team/specialist fleet goals — taxonomy agents.team.create; GET /mcp/prompts/get?name=agentstack_c…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"routed": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_team_create", "summary": "Thin wrapper: plan_ingest team template + optional orchestrate focus.", "title": "Agents Team Create", "when_to_use": "Team/specialist fleet goals — taxonomy agents.team.create; GET /mcp/prompts/get?name=agentstack_closed_loop_autonomy for plan graph + parallel agents.", "write_mode": null}, {"action": "agents.plan_execute", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.orchestrator.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_execute", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Execute", "when_to_use": "After plan_claim lease — attach evidence for completion_predicates; route_source=plan_node when continuing from work_next."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After plan_claim lease — attach evidence for completion_predicates; route_source=plan_node when c…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"plan_completion": {"description": "object", "type": "any"}, "plan_revision": {"description": "integer", "type": "any"}, "run": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_plan_execute", "summary": "Run orchestrator focused on current plan graph (alias for orchestrate with plan focus). Returns plan_revision / completion decision when available.", "title": "Execute Plan Node", "when_to_use": "After plan_claim lease — attach evidence for completion_predicates; route_source=plan_node when continuing from work_next.", "write_mode": null}, {"action": "agents.plan_suggest_tree", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_suggest_tree", "source": "overlay", "title": "Agents Plan Suggest Tree", "when_to_use": "Operator wants a full-tree plan preview before create_plan apply."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Operator wants a full-tree plan preview before create_plan apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"draft_tree": {"description": "object — version, root_prompt, nested tasks[]", "type": "any"}, "source": {"description": "string — llm|template|heuristic|playbook", "type": "any"}, "validation": {"description": "object — ok, errors[]", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_suggest_tree", "summary": "Suggest a nested plan tree draft from a goal (read-only). Does not mutate task_list — use plan_propose/create_plan + plan_apply_proposal to persist.", "title": "Agents Plan Suggest Tree", "when_to_use": "Operator wants a full-tree plan preview before create_plan apply.", "write_mode": null}, {"action": "agents.plan_propose", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_propose", "source": "overlay", "title": "Agents Plan Propose", "when_blocked": {"plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)"}, "when_to_use": "Decompose strategic/complex nodes before execution; plan-only intake. validation_mode=persist_unexecutable when fleet gaps expected; check execution_summary before apply."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Decompose strategic/complex nodes before execution; plan-only intake. validation_mode=persist_une…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"meta": {"description": "object — summary with supersede_count, deps_add", "type": "any"}, "proposal": {"description": "PlannerProposal — nodes_to_create, nodes_to_supersede, dependencies_to_add", "type": "any"}, "validation": {"description": "object — plan_valid, executable_now, execution{}, errors[], repair_hints[]", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_propose", "summary": "Build a validated planner proposal (draft) for create_plan or decompose_node. Does not mutate task_list — call agents.plan_apply_proposal to persist.", "title": "Propose Plan Changes", "when_blocked": {"plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)", "planner_duplicate_children": "agents.plan_get — semantic facet children already exist; re-propose is a no-op or use mode=replan_subtree", "supersede_in_progress": "agents.plan_get then wait/retry — in-progress node cannot be superseded without options.force_supersede_in_progress (retryable)"}, "when_to_use": "Decompose strategic/complex nodes before execution; plan-only intake. validation_mode=persist_unexecutable when fleet gaps expected; check execution_summary before apply.", "write_mode": null}, {"action": "agents.plan_apply_proposal", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_apply_proposal", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Apply Proposal", "when_blocked": {"plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)"}, "when_to_use": "Persist validated decomposition after plan_propose review."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Persist validated decomposition after plan_propose review.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied": {"description": "boolean", "type": "any"}, "new_revision": {"description": "integer", "type": "any"}, "task_list": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_plan_apply_proposal", "summary": "Apply a planner proposal to the Work Graph with CAS (if_match_revision). Pass proposal from plan_propose and base_graph_revision unchanged.", "title": "Apply Plan Proposal", "when_blocked": {"plan_revision_conflict": "agents.plan_get reload if_match_revision; retry claim/apply (retryable)"}, "when_to_use": "Persist validated decomposition after plan_propose review.", "write_mode": null}, {"action": "agents.plan_process_backlog", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_process_backlog", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Process Backlog", "when_to_use": "Backlog scan (planner plane): decomposition_status=needed. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake; validation_ok reflects plan_valid not fleet-ready.", "write_when": ["params.auto_apply_policy!=off"]}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "conditional_mutate": "params.auto_apply_policy!=off", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Backlog scan (planner plane): decomposition_status=needed. auto_apply_policy=off default; validat…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"candidates": {"description": "array", "type": "any"}, "graph_revision": {"description": "integer", "type": "any"}, "results": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_process_backlog", "summary": "Scan decomposition backlog (decomposition_status=needed, no execution decomposition) and build planner proposals. Claims planner-parent lease before decompose when required_role=planner (even when aut", "title": "Process Plan Backlog", "when_to_use": "Backlog scan (planner plane): decomposition_status=needed. auto_apply_policy=off default; validation_mode=persist_unexecutable for intake; validation_ok reflects plan_valid not fleet-ready.", "write_mode": null}, {"action": "agents.plan_recovery_scan", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1", "core.agents.work_graph.gen1"], "id": "agents.plan_recovery_scan", "source": "overlay", "title": "Agents Plan Recovery Scan", "when_blocked": {"verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_to_use": "Ops preview before repair_plan — no DNA mutation."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops preview before repair_plan — no DNA mutation.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"candidates": {"description": "array", "type": "any"}, "next_actions": {"description": "array", "type": "any"}, "recovery_engine": {"description": "object", "type": "any"}, "stale_claims": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_recovery_scan", "summary": "Read-only scan for verification_failed repair candidates and stale claims. Reason codes use recovery_engine SoT (verification_failed, expired_claim).", "title": "Scan Plan Recovery", "when_blocked": {"verification_failed": "agents.plan_recovery_scan → plan_propose mode=repair_plan"}, "when_to_use": "Ops preview before repair_plan — no DNA mutation.", "write_mode": null}, {"action": "agents.work_next", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_next", "mutation_risk": "low", "source": "overlay", "title": "Agents Work Next", "when_to_use": "Start every agent work loop here; read next_action first, then follow recovery.next_actions when state=blocked; use handoff=true after role/specialization mismatch.", "write_when": ["params.claim=true"]}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "conditional_mutate": "params.claim=true", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Start every agent work loop here; read next_action first, then follow recovery.next_actions when …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"blocked_work": {"description": "array", "type": "any"}, "claim": {"description": "object", "type": "any"}, "claim_result": {"description": "object", "type": "any"}, "goal": {"description": "object", "type": "any"}, "goal_summary": {"description": "object", "type": "any"}, "instruction_packet": {"description": "object", "type": "any"}, "locale": {"description": "string", "type": "any"}, "next_actions": {"description": "array", "type": "any"}, "next_work": {"description": "object", "type": "any"}, "plan_summary": {"description": "object", "type": "any"}, "recovery": {"description": "object", "type": "any"}, "recovery_hint": {"description": "string", "type": "any"}, "state": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_work_next", "summary": "Agent-native next-work packet: goal summary, best executable node, eligibility, instruction slice, and suggested claim/execute actions. Read-only unless claim=true. Optional env_uuid for sandbox slice", "title": "Get Next Work Item", "when_to_use": "Start every agent work loop here; read next_action first, then follow recovery.next_actions when state=blocked; use handoff=true after role/specialization mismatch.", "write_mode": null}, {"action": "agents.work_status", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.work_status", "source": "overlay", "title": "Agents Work Status", "when_to_use": "Poll progress between loops when you only need open_count / blocked_leaves / idle vs actionable — not a substitute for work_next."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Poll progress between loops when you only need open_count / blocked_leaves / idle vs actionable —…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"goal": {"description": "object", "type": "any"}, "plan_summary": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_work_status", "summary": "Plan summary only — task counts and execution-ready leaves (no node pick).", "title": "Agents Work Status", "when_to_use": "Poll progress between loops when you only need open_count / blocked_leaves / idle vs actionable — not a substitute for work_next.", "write_mode": null}, {"action": "agents.plan_reconcile_diagnostics", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.work_graph.gen1", "core.mcp.agents.gen1"], "id": "agents.plan_reconcile_diagnostics", "mutation_risk": "low", "source": "overlay", "title": "Agents Plan Reconcile Diagnostics", "when_to_use": "After fleet heal or binding repair — closes diag-* tasks with finding_absent evidence."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "After fleet heal or binding repair — closes diag-* tasks with finding_absent evidence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"completed_node_ids": {"description": "array", "type": "any"}, "skipped_node_ids": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_plan_reconcile_diagnostics", "summary": "Auto-complete open diagnostic plan nodes when live findings are cleared (statuses_toward_completed: typically pending→verifying→completed).", "title": "Agents Plan Reconcile Diagnostics", "when_to_use": "After fleet heal or binding repair — closes diag-* tasks with finding_absent evidence.", "write_mode": null}, {"action": "agents.reconcile_binding", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.mcp.agents.gen1"], "id": "agents.reconcile_binding", "mutation_risk": "low", "source": "overlay", "title": "Agents Reconcile Binding", "when_to_use": "When orchestrate returns orchestrator_binding_stale or agents.list canonical is empty."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "When orchestrate returns orchestrator_binding_stale or agents.list canonical is empty.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_uuid": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_reconcile_binding", "summary": "Validate and repair project orchestrator agent_uuid vs fleet index and lineage.", "title": "Agents Reconcile Binding", "when_to_use": "When orchestrate returns orchestrator_binding_stale or agents.list canonical is empty.", "write_mode": null}, {"action": "agents.instruction_rules_list", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_list", "source": "overlay", "title": "Agents Instruction Rules List", "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — inspect instruction_rules before editing overlay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"rules": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_instruction_rules_list", "summary": "List merged platform instruction rules (fixture + ecosystem overlay).", "title": "Agents Instruction Rules List", "when_to_use": "Orchestration Studio — inspect instruction_rules before editing overlay.", "write_mode": null}, {"action": "agents.instruction_rules_upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.instruction_rules_upsert", "mutation_risk": "low", "source": "overlay", "title": "Agents Instruction Rules Upsert", "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only)."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"rule": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "project_admin", "safe_action": "agents_instruction_rules_upsert", "summary": "Upsert one instruction rule on ecosystem project overlay (8DNA leaf).", "title": "Agents Instruction Rules Upsert", "when_to_use": "Orchestration Studio — persist operator rule overlay (ecosystem project only).", "write_mode": null}, {"action": "agents.health", "capability_descriptor": {"complexity": "intermediate", "domain": "agents", "genetic_tags": ["core.agents.fleet.gen1"], "id": "agents.health", "source": "overlay", "title": "Agents Health", "when_to_use": "Ops check before agents.list when fleet_warming 503 appears."}, "domain_title": "Agents MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.agents.fleet.gen1"], "instruction_hint": "Ops check before agents.list when fleet_warming 503 appears.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.agents", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agents_index_count": {"description": "integer", "type": "any"}, "agents_index_resolved": {"description": "integer", "type": "any"}, "agents_initialized": {"description": "boolean", "type": "any"}, "bots_index_count": {"description": "integer", "type": "any"}, "bots_initialized": {"description": "boolean", "type": "any"}, "read_model": {"description": "string", "type": "any"}, "ready": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.agents.fleet.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_agents_fleet", "agentstack_project_orchestrator"], "required_cap": "mcp_read", "safe_action": "agents_health", "summary": "Fleet ECS index health for a project (agents/bots organelle diagnostics).", "title": "Agents Health", "when_to_use": "Ops check before agents.list when fleet_warming 503 appears.", "write_mode": null}], "ai_builder": [{"action": "ai_builder.manifest.get", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.get", "source": "overlay", "title": "Ai Builder Manifest Get", "when_to_use": "Load UAM v1 manifest before compose or validate."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Load UAM v1 manifest before compose or validate.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"manifest": {"description": "object or null", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_manifest_get", "summary": "Load Unified Application Manifest (UAM v1) for the current project.", "title": "Ai Builder Manifest Get", "when_to_use": "Load UAM v1 manifest before compose or validate.", "write_mode": null}, {"action": "ai_builder.manifest.validate", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.manifest.validate", "source": "overlay", "title": "Ai Builder Manifest Validate", "when_to_use": "Validate UAM JSON before agents.fleet bind."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Validate UAM JSON before agents.fleet bind.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"errors": {"description": "list", "type": "any"}, "ok": {"description": "boolean", "type": "any"}, "warnings": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_manifest_validate", "summary": "Validate a UAM v1 JSON object (structure + catalog + logic templates).", "title": "Ai Builder Manifest Validate", "when_to_use": "Validate UAM JSON before agents.fleet bind.", "write_mode": null}, {"action": "ai_builder.compose.preview", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.ai_builder.gen1"], "id": "ai_builder.compose.preview", "source": "overlay", "title": "Ai Builder Compose Preview", "when_to_use": "Deterministic compose preview (sha256 + paths)."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Deterministic compose preview (sha256 + paths).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"content_sha256": {"description": "string", "type": "any"}, "files": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_compose_preview", "summary": "Deterministic compose preview: returns content_sha256 and file paths.", "title": "Ai Builder Compose Preview", "when_to_use": "Deterministic compose preview (sha256 + paths).", "write_mode": null}, {"action": "ai_builder.source.list", "aliases": ["ai_builder.project.list"], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.source.list", "source": "live", "title": "Ai Builder Source List", "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_source_list", "summary": "List React source files under the project App Studio tree (src/** and related). Not hosting /s/ bucket bytes.", "title": "List App Studio Source", "when_to_use": "Read the editable React tree (src/**) before patching. Does not list /s/ bucket files.", "write_mode": null}, {"action": "ai_builder.source.get", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.source.get", "source": "live", "title": "Ai Builder Source Get", "when_to_use": "view=skeleton lists names. view=symbol with symbol= returns those bodies. A long file returns a window; pass offset."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "view=skeleton lists names. view=symbol with symbol= returns those bodies. A long file returns a w…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"content": {"description": "string", "type": "any"}, "next_offset": {"description": "integer", "type": "any"}, "sha256": {"description": "string", "type": "any"}, "symbols": {"description": "array", "type": "any"}, "truncated": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_source_get", "summary": "Read one UTF-8 source file and its sha256.", "title": "Read App Studio Source", "when_to_use": "view=skeleton lists names. view=symbol with symbol= returns those bodies. A long file returns a window; pass offset.", "write_mode": null}, {"action": "ai_builder.source.put", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.source.put", "source": "live", "title": "Ai Builder Source Put", "when_to_use": "Write a source file. Call ai_builder.build.enqueue afterwards."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Write a source file. Call ai_builder.build.enqueue afterwards.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"sha256": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_source_put", "summary": "Create or replace one source file. Does not start Vite.", "title": "Ai Builder Source Put", "when_to_use": "Write a source file. Call ai_builder.build.enqueue afterwards.", "write_mode": null}, {"action": "ai_builder.source.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.source.patch", "source": "live", "title": "Ai Builder Source Patch", "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. Do not patch vite.config.ts, package.json, index.html, src/main.tsx, src/style"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"path": {"description": "string", "type": "any"}, "sha256": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "project_admin", "safe_action": "ai_builder_source_patch", "summary": "Patch one source file by replacements, a whole function, full content, or a unified diff. Never enqueues a build. Do not patch the published assets/index-*.js bundle.", "title": "Patch App Studio Source", "when_to_use": "One find/replace or symbols:[{name, replace}] for a whole function. Pass expected_sha256; digest_mismatch writes nothing. Do not patch vite.config.ts, package.json, index.html, src/main.tsx, src/style", "write_mode": null}, {"action": "ai_builder.compose.apply", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.compose.apply", "source": "live", "title": "Ai Builder Compose Apply", "when_to_use": "Create the React skeleton from a blueprint, then patch slots."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Create the React skeleton from a blueprint, then patch slots.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"content_sha256": {"description": "string", "type": "any"}, "files": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "project_admin", "safe_action": "ai_builder_compose_apply", "summary": "Materialize a blueprint or UAM onto the project source tree. Does not run Vite.", "title": "Ai Builder Compose Apply", "when_to_use": "Create the React skeleton from a blueprint, then patch slots.", "write_mode": null}, {"action": "ai_builder.build.enqueue", "aliases": ["ai_builder.build", "ai_builder.build.run", "ai_builder.run"], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.build.enqueue", "source": "live", "title": "Ai Builder Build Enqueue", "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate."}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"build_uuid": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_build_enqueue", "summary": "Queue a Vite build. Returns immediately with build_uuid or status=cached. Does not call an LLM.", "title": "Ai Builder Build Enqueue", "when_to_use": "After source edits. Poll ai_builder.build.status. Do not wait inside agents.orchestrate.", "write_mode": null}, {"action": "ai_builder.build.status", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.build.status", "source": "live", "title": "Ai Builder Build Status", "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar"}, "domain_title": "Ai Builder MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.ai_builder.gen1"], "instruction_hint": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_c…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.ai_builder", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"errors": {"description": "array", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.ai_builder.gen1", "related_prompts": ["agentstack_app_studio"], "required_cap": "mcp_read", "safe_action": "ai_builder_build_status", "summary": "Read a Vite build status, including file and line when it failed.", "title": "Check Build Status", "when_to_use": "Poll until completed, failed, or cached. Omit build_uuid for the latest build. On failed: error_code syntax_error or dependency_error with errors[{file,line,message}]. Browserslist/caniuse warnings ar", "write_mode": null}, {"action": "ai_builder.publish", "aliases": ["ai_builder.build.publish"], "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.ai_builder.gen1"], "id": "ai_builder.publish", "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "source": "live", "title": "Ai Builder Publish", "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first."}, "domain_title": "App Studio pipeline", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "example_params": {"branch": "example_string", "bucket_id": "example_string", "project_id": 123}, "genetic_tags": ["core.app_studio.pipeline.gen1"], "inputSchema": {"properties": {"branch": {"description": "Source branch, default dev", "type": "string"}, "bucket_id": {"description": "Existing site bucket. Omit when the project has one primary site.", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": [], "type": "object"}, "instruction_hint": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_…", "kind": "processor", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "app_studio.pipeline", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"edge_ready": {"description": "boolean", "type": "any"}, "url": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.app_studio.pipeline.gen1", "related_prompts": ["agentstack_app_studio"], "related_tools": ["hosting.site.quick_start", "hosting.project.status", "ai_builder.build.status"], "required_cap": "project_admin", "rollback": ["hosting.release.promote"], "safe_action": "ai_builder_publish", "summary": "Copy the dev Vite build into a hosting bucket as an SPA and publish it.", "title": "Publish App Studio Build", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_to_use": "Only when the user explicitly asks to publish. Agents need approval. If bucket_id_or_bucket_name_required — run hosting.site.quick_start first.", "write_mode": null}], "analytics": [{"action": "analytics.project_snapshot", "aliases": ["analytics.export_data", "analytics.list", "analytics.set_budget"], "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "genetic_tags": ["core.mcp.analytics.gen1", "core.analytics.read_model.gen1"], "id": "analytics.project_snapshot", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "source": "overlay", "title": "Analytics Project Snapshot", "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone."}, "domain_title": "Analytics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.analytics.gen1"], "instruction_hint": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.analytics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.analytics.gen1", "related_tools": ["finance.project.analytics", "analytics.get_usage", "projects.get_stats"], "required_cap": "analytics", "safe_action": "analytics_project_snapshot", "summary": "Unified project analytics snapshot: activity, finance, CRM, product events, optional business/bots/hosting slices. Prefer this over analytics.get_usage.", "title": "Analytics Project Snapshot", "when_to_use": "Dashboard / metrics / report for a project. Use finance.project.analytics only when you need P&L alone.", "write_mode": null}, {"action": "analytics.get_usage", "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_usage", "related_tools": ["analytics.project_snapshot"], "source": "overlay", "title": "Analytics Get Usage", "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards."}, "domain_title": "Analytics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.analytics.gen1"], "instruction_hint": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.analytics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.analytics.gen1", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "safe_action": "analytics_get_usage", "summary": "Project activity usage slice (members + API/exec events). Prefer analytics.project_snapshot with include=['activity']. Date filters are accepted for forward-compat but not applied.", "title": "Analytics Get Usage", "tool_chains": ["usage_monitoring"], "when_to_use": "Quick activity counters; prefer analytics.project_snapshot for dashboards.", "write_mode": null}, {"action": "analytics.get_metrics", "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "genetic_tags": ["core.mcp.analytics.gen1"], "id": "analytics.get_metrics", "related_tools": ["analytics.project_snapshot"], "source": "overlay", "title": "Analytics Get Metrics", "when_to_use": "Read custom counters stored in project data.metrics[]."}, "domain_title": "Analytics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.analytics.gen1"], "instruction_hint": "Read custom counters stored in project data.metrics[].", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.analytics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.analytics.gen1", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "safe_action": "analytics_get_metrics", "summary": "Custom DNA metrics array (data.metrics[]) for a project — not performance KPIs. For dashboard KPIs use analytics.project_snapshot.", "title": "Analytics Get Metrics", "when_to_use": "Read custom counters stored in project data.metrics[].", "write_mode": null}, {"action": "analytics.bump", "capability_descriptor": {"complexity": "intermediate", "domain": "analytics", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.bump", "related_tools": ["analytics.project_snapshot"], "source": "overlay", "title": "Analytics Bump", "when_to_use": "Manual ring correction or integration test seeding."}, "domain_title": "Analytics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.analytics.gen1"], "instruction_hint": "Manual ring correction or integration test seeding.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.analytics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.analytics.gen1", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "safe_action": "analytics_bump", "summary": "Increment analytics day-ring counters (catalog keys only: ae, ee, pe, rc, ec, eo, ev.*). Prefer organic writers; use for tests or manual corrections.", "title": "Analytics Bump", "when_to_use": "Manual ring correction or integration test seeding.", "write_mode": null}, {"action": "analytics.archive.query", "capability_descriptor": {"complexity": "advanced", "domain": "analytics", "genetic_tags": ["core.analytics.journal.gen1"], "id": "analytics.archive.query", "related_tools": ["analytics.project_snapshot"], "source": "overlay", "title": "Analytics Archive Query", "when_to_use": "Forensic analytics after detail archived to Storage sqlite."}, "domain_title": "Analytics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.analytics.gen1"], "instruction_hint": "Forensic analytics after detail archived to Storage sqlite.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.analytics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.analytics.gen1", "related_tools": ["analytics.project_snapshot"], "required_cap": "analytics", "safe_action": "analytics_archive_query", "summary": "Read-only cold archive rows (audit_logs + storage quota). Not included in analytics.project_snapshot.", "title": "Analytics Archive Query", "when_to_use": "Forensic analytics after detail archived to Storage sqlite.", "write_mode": null}], "apikeys": [{"action": "apikeys.create", "aliases": ["projects.create_api_key"], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.create", "mutation_risk": "low", "related_tools": ["apikeys.list", "apikeys.delete"], "source": "overlay", "title": "Apikeys Create", "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actor_kind": {"description": "string — agent (this alias) or user", "type": "any"}, "api_key": {"description": "string — JWT PAT shown once", "type": "any"}, "created_at": {"description": "string — ISO 8601", "type": "any"}, "key_id": {"description": "string — UUID to manage/delete this key", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "service_caps": {"description": "array|null — L1 caps stored on the key", "type": "any"}, "user_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["apikeys.list", "apikeys.delete"], "required_cap": "api_keys|apikeys.write", "safe_action": "apikeys_create", "summary": "Create an **agent PAT** (unified user PAT). Postel alias of `user.apikeys.create` with actor_kind=agent.", "title": "Apikeys Create", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding", "multi_tenant_onboarding"], "when_to_use": "Use to provision API keys for programmatic/AI-agent access. Always set service_caps when creating keys for AI agents to limit blast radius.", "write_mode": null}, {"action": "apikeys.list", "aliases": ["api_keys.list", "projects.get_api_keys"], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.list", "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "source": "overlay", "title": "Apikeys List", "when_to_use": "Audit keys before create/delete rotation."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Audit keys before create/delete rotation.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Total number of API keys found", "type": "any"}, "keys": {"description": "array - Array of API key objects. Each key contains: key_id, name, scopes, created_at, last_used_at (if available). Note: actual API key values are NOT returned for security", "type": "any"}, "project_id": {"description": "int - Project ID for which keys were retrieved", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["apikeys.create", "apikeys.delete", "auth.get_profile"], "required_cap": "api_keys|apikeys.read", "safe_action": "apikeys_list", "summary": "List all API keys for a project.", "title": "Apikeys List", "when_to_use": "Audit keys before create/delete rotation.", "write_mode": null}, {"action": "apikeys.delete", "aliases": ["apikeys.revoke", "projects.delete_api_key"], "capability_descriptor": {"complexity": "intermediate", "domain": "apikeys", "genetic_tags": ["core.mcp.apikeys.gen1"], "id": "apikeys.delete", "mutation_risk": "high", "related_tools": ["apikeys.list", "apikeys.create"], "source": "overlay", "title": "Apikeys Delete", "when_to_use": "Revoke compromised key — cannot undo."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Revoke compromised key — cannot undo.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool - Whether key was successfully deleted (always true if operation succeeds)", "type": "any"}, "deleted_at": {"description": "string - ISO 8601 timestamp when key was deleted", "type": "any"}, "key_id": {"description": "string - Deleted key identifier", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["apikeys.list", "apikeys.create"], "required_cap": "api_keys|apikeys.write", "safe_action": "apikeys_delete", "summary": "Delete an API key permanently.", "title": "Apikeys Delete", "when_to_use": "Revoke compromised key — cannot undo.", "write_mode": null}], "assets": [{"action": "assets.list_presets", "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.list_presets", "source": "overlay", "title": "Assets List Presets", "when_to_use": "List deterministic asset wizard presets for the project."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "instruction_hint": "List deterministic asset wizard presets for the project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"branchingQuestions": {"description": "array — optional intent filters", "type": "any"}, "presets": {"description": "array — preset definitions", "type": "any"}, "version": {"description": "int — fixture version", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "required_cap": "mcp_read", "safe_action": "assets_list_presets", "summary": "List deterministic asset wizard presets for the project.", "title": "Assets List Presets", "when_to_use": "List deterministic asset wizard presets for the project.", "write_mode": null}, {"action": "assets.create", "aliases": ["assets.mint"], "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.create", "mutation_risk": "low", "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "source": "overlay", "title": "Assets Create", "when_to_use": "Digital commerce asset — prefer over custom product tables."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "data": {"sku": "gems_100", "symbol": "CR"}, "name": "card_10hp_5atk", "preset_id": "exchange_pair", "preset_inputs": {"quote_asset_name": "Gold"}, "price_usdt": "0.00", "type": "digital_item"}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "inputSchema": {"examples": [{"description": "Create a game card with attack, HP, and mana cost", "name": "Create game card", "request": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "name": "card_10hp_5atk", "price_usdt": "0.00", "type": "digital_item"}, "response": {"data": {"components": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "card_10hp_5atk", "price_usdt": "0.00", "project_id": 123, "type": "digital_item"}, "success": true}}], "properties": {"components": {"description": "Asset components object containing properties, game, visual, metadata. Explicit components win over preset_id.", "example": {"game": {"stats": {"attack": 5, "hp": 10, "mana_cost": 3}}, "properties": {"tradeable": false}, "visual": {"image_url": "https://example.com/card.png"}}, "type": "object"}, "data": {"additionalProperties": true, "description": "Flat extras. sku and symbol stay in metadata.custom_fields. quote_asset_name, bundle_asset_ids, and game stats land on the slots the wizard uses. price_usd sets price_usdt.", "example": {"sku": "gems_100", "symbol": "CR"}, "type": "object"}, "name": {"description": "Asset name. Should be unique within the project (e.g., 'card_10hp_5atk', 'GOLD', 'DIAMONDS')", "example": "card_10hp_5atk", "type": "string"}, "preset_id": {"description": "Wizard preset from assets.list_presets. Fills type, price, and the slots storefront, exchange, and bundles read. Alias: preset.", "example": "exchange_pair", "type": "string"}, "preset_inputs": {"description": "Preset answers such as quote_asset_name or bundle_asset_ids. A data bag with the same keys is equivalent.", "example": {"quote_asset_name": "Gold"}, "type": "object"}, "price_usdt": {"description": "Price in USDT as decimal string (e.g., '0.00', '1.00', '10.50')", "example": "0.00", "type": "string"}, "type": {"description": "Asset type. Must be one of: 'currency', 'digital_item', 'physical_item', 'service', 'nft'", "enum": ["currency", "digital_item", "physical_item", "service", "nft"], "example": "digital_item", "type": "string"}}, "required": ["name", "type", "price_usdt"], "type": "object"}, "instruction_hint": "Digital commerce asset — prefer over custom product tables.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"components": {"description": "object - Asset components", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp", "type": "any"}, "id": {"description": "string - Unique asset ID (UUID format)", "type": "any"}, "name": {"description": "string - Asset name", "type": "any"}, "price_usdt": {"description": "string - Price in USDT", "type": "any"}, "project_id": {"description": "int - Project ID", "type": "any"}, "type": {"description": "string - Asset type", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.list", "assets.update", "commerce.storefront.seed_apply"], "required_cap": "assets_write", "rollback": ["assets.delete"], "safe_action": "assets_create", "summary": "Create a new asset for the project.", "title": "Assets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "verification": ["assets.get", "assets.list"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}, {"action": "assets.list", "predicate": "named resource is visible"}], "when_to_use": "Digital commerce asset — prefer over custom product tables.", "write_mode": null}, {"action": "assets.get", "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.get", "related_tools": ["assets.list", "assets.create"], "source": "overlay", "title": "Assets Get", "when_to_use": "Load one asset preset before update or publish."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "instruction_hint": "Load one asset preset before update or publish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"components": {"description": "object - Asset components", "type": "any"}, "id": {"description": "string - Asset ID", "type": "any"}, "name": {"description": "string - Asset name", "type": "any"}, "price_usdt": {"description": "string - Price in USDT", "type": "any"}, "type": {"description": "string - Asset type", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.create"], "required_cap": "mcp_read", "safe_action": "assets_get", "summary": "Get asset details by ID.", "title": "Assets Get", "when_to_use": "Load one asset preset before update or publish.", "write_mode": null}, {"action": "assets.list", "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.list", "related_tools": ["assets.get", "assets.update", "assets.create"], "source": "overlay", "title": "Assets List", "when_to_use": "Catalog assets before get/update or storefront seed. Response uses items[] + count; pass envelope=compat for legacy assets[] alias."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "instruction_hint": "Catalog assets before get/update or storefront seed. Response uses items[] + count; pass envelope…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"assets": {"description": "array - List of asset objects", "type": "any"}, "limit": {"description": "int - Limit used", "type": "any"}, "offset": {"description": "int - Offset used", "type": "any"}, "total": {"description": "int - Total number of assets", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.update", "assets.create"], "required_cap": "mcp_read", "safe_action": "assets_list", "summary": "List all assets in the project.", "title": "Assets List", "when_to_use": "Catalog assets before get/update or storefront seed. Response uses items[] + count; pass envelope=compat for legacy assets[] alias.", "write_mode": null}, {"action": "assets.update", "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.update", "mutation_risk": "low", "related_tools": ["assets.get", "assets.create"], "source": "overlay", "title": "Assets Update", "when_to_use": "Patch asset metadata or pricing leaf."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"asset_id": "asset_a1b2c3d4e5f6", "components": {}, "data": {"quote_asset_name": "Gold", "symbol": "CR"}, "name": "example_string", "price_usdt": "example_string"}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "inputSchema": {"examples": [{"description": "Update asset properties", "name": "Update asset", "request": {"asset_id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "response": {"data": {"id": "550e8400-e29b-41d4-a716-446655440000", "name": "Updated Card Name", "price_usdt": "1.00"}, "success": true}}], "properties": {"asset_id": {"description": "Opaque AgentStack asset ID — pass exactly as returned by create/list", "example": "asset_a1b2c3d4e5f6", "format": "opaque_id", "type": "string"}, "components": {"description": "Updated components. Merged onto the stored row; this object wins.", "type": "object"}, "data": {"additionalProperties": true, "description": "Flat extras merged onto the stored row. sku stays in custom_fields. quote_asset_name lands on exchange_pair. Existing keys are kept.", "example": {"quote_asset_name": "Gold", "symbol": "CR"}, "type": "object"}, "name": {"description": "New asset name", "type": "string"}, "price_usdt": {"description": "New price in USDT", "type": "string"}}, "required": ["asset_id"], "type": "object"}, "instruction_hint": "Patch asset metadata or pricing leaf.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"id": {"description": "string - Asset ID", "type": "any"}, "name": {"description": "string - Updated asset name", "type": "any"}, "updated_at": {"description": "string - Update timestamp", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.get", "assets.create"], "required_cap": "assets_write", "rollback": ["assets.update"], "safe_action": "assets_update", "summary": "Update an existing asset.", "title": "Assets Update", "verification": ["assets.get"], "verify": [{"action": "assets.get", "predicate": "named resource is visible"}], "when_to_use": "Patch asset metadata or pricing leaf.", "write_mode": null}, {"action": "assets.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "assets", "genetic_tags": ["core.mcp.assets.gen1"], "id": "assets.delete", "mutation_risk": "low", "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "source": "overlay", "title": "Assets Delete", "when_to_use": "Remove asset from catalog — check storefront refs first."}, "domain_title": "Assets MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "example_params": {"asset_id": "asset_a1b2c3d4e5f6", "project_id": 123}, "genetic_tags": ["core.commerce.assets.presets.gen1"], "inputSchema": {"properties": {"asset_id": {"description": "Opaque AgentStack asset ID — pass exactly as returned by create/list", "example": "asset_a1b2c3d4e5f6", "format": "opaque_id", "type": "string"}, "project_id": {"description": "Project ID (uses context if not provided)", "type": "integer"}}, "required": ["asset_id"], "type": "object"}, "instruction_hint": "Remove asset from catalog — check storefront refs first.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.assets", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.assets.presets.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["assets.list", "assets.get", "assets.create", "assets.update"], "required_cap": "assets_write", "rollback": [], "safe_action": "assets_delete", "summary": "Delete an asset from the project.", "title": "Assets Delete", "verification": ["assets.list"], "verify": [{"action": "assets.list", "predicate": "named resource is visible"}], "when_to_use": "Remove asset from catalog — check storefront refs first.", "write_mode": null}], "auth": [{"action": "auth.login", "aliases": ["app.auth.login", "auth.quick_auth", "identity.login", "session.create"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.login", "related_tools": ["auth.get_profile", "projects.get_projects"], "source": "overlay", "title": "Auth Login", "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"expires_at": {"description": "string - ISO 8601 timestamp when token expires", "type": "any"}, "session_id": {"description": "string - Session identifier", "type": "any"}, "token": {"description": "string - JWT authentication token. Use this token in 'Authorization: Bearer {token}' header for authenticated requests. Token expires based on session configuration", "type": "any"}, "user": {"description": "object - User information object containing: user_id (int - user ID), email (string - user email), name (string - user name), role (string - user role: 'user', 'admin', 'owner'), is_ecosystem (bool - whether user is ecosystem user), project_id (int - default project ID)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile", "projects.get_projects"], "safe_action": "auth_login", "summary": "Login to the system.", "title": "Auth Login", "when_to_use": "Tenant app user sign-in — not Cursor plugin MCP Connect.", "write_mode": null}, {"action": "auth.email_otp.send", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.send", "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "source": "overlay", "title": "Auth Email Otp Send", "when_to_use": "Tenant user passwordless login — send OTP before auth.email_otp.login."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Tenant user passwordless login — send OTP before auth.email_otp.login.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ask_user": {"description": "string", "type": "any"}, "challenge_id": {"description": "string — pass to auth.email_otp.login", "type": "any"}, "expires_in": {"description": "int — seconds", "type": "any"}, "masked_email": {"description": "string", "type": "any"}, "needs_human": {"description": "bool — stop and ask the human", "type": "any"}, "sent": {"description": "bool", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.login", "auth.login", "messaging.get_auth_email_readiness"], "safe_action": "auth_email_otp_send", "summary": "Request a one-time sign-in code. Always returns sent=true for a valid destination. If needs_human is set, stop and ask the human for the code. Pair with auth.email_otp.login.", "title": "Auth Email Otp Send", "when_to_use": "Tenant user passwordless login — send OTP before auth.email_otp.login.", "write_mode": null}, {"action": "auth.email_otp.login", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.email_otp.login", "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "source": "overlay", "title": "Auth Email Otp Login", "when_to_use": "Complete passwordless email login after auth.email_otp.send."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Complete passwordless email login after auth.email_otp.send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"mfa_required": {"description": "bool — when second step needed", "type": "any"}, "session": {"description": "object — access_token when login completes", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.email_otp.send", "auth.login", "auth.get_profile"], "safe_action": "auth_email_otp_login", "summary": "Verify email OTP and mint a session. MFA-enrolled users receive mfa_required on first call; retry with mfa_ticket + mfa_code (+ optional mfa_method).", "title": "Auth Email Otp Login", "when_to_use": "Complete passwordless email login after auth.email_otp.send.", "write_mode": null}, {"action": "auth.register", "aliases": ["auth.create_user", "users.create"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.register", "related_tools": ["auth.login", "buffs.apply_temporary_effect"], "source": "overlay", "title": "Auth Register", "when_to_use": "Create a new platform user with email + password."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Create a new platform user with email + password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"token": {"description": "string - JWT authentication token", "type": "any"}, "user": {"description": "object - User information", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "buffs.apply_temporary_effect"], "safe_action": "auth_register", "summary": "Register a new user.", "title": "Auth Register", "when_to_use": "Create a new platform user with email + password.", "write_mode": null}, {"action": "auth.get_profile", "aliases": ["auth.authenticate", "auth.list", "auth.me", "auth.profile", "auth.status", "auth.whoami"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.get_profile", "related_tools": ["auth.update_profile", "auth.login"], "source": "overlay", "title": "Auth Get Profile", "when_to_use": "Session probe. One jti covers every project membership allows. mutation_allowed true means do not loop auth.switch_project and do not log in again. Restart rehydrates the jti from 8DNA."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Session probe. One jti covers every project membership allows. mutation_allowed true means do not…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.update_profile", "auth.login"], "safe_action": "auth_get_profile", "summary": "Get user profile information.", "title": "Read Session Profile", "when_to_use": "Session probe. One jti covers every project membership allows. mutation_allowed true means do not loop auth.switch_project and do not log in again. Restart rehydrates the jti from 8DNA.", "write_mode": null}, {"action": "auth.update_profile", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.update_profile", "mutation_risk": "low", "related_tools": ["auth.get_profile"], "source": "overlay", "title": "Auth Update Profile", "when_to_use": "Patch user profile fields (display name, locale)."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Patch user profile fields (display name, locale).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"name": {"description": "string - Updated user name", "type": "any"}, "updated_at": {"description": "string - Update timestamp", "type": "any"}, "user_id": {"description": "int - User ID", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.get_profile"], "required_cap": "project_admin", "safe_action": "auth_update_profile", "summary": "Update user profile.", "title": "Auth Update Profile", "tool_chains": ["crud_with_logic"], "when_to_use": "Patch user profile fields (display name, locale).", "write_mode": null}, {"action": "auth.switch_project", "aliases": ["context.set_project", "projects.select", "session.switch_project"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.switch_project", "related_tools": ["auth.login", "auth.get_profile"], "source": "overlay", "title": "Auth Switch Project", "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"access_token": {"description": "string - JWT Bearer for target project session", "type": "any"}, "accessible_project_ids_digest": {"description": "string|null - Digest of accessible project ids", "type": "any"}, "authz_generation": {"description": "int - Authz generation stamp on the session", "type": "any"}, "hybrid_key": {"description": "string - Combined api_key:user_token for legacy clients", "type": "any"}, "jti": {"description": "string - Bound session JTI", "type": "any"}, "membership_generation": {"description": "int|null - Membership generation for cache invalidation", "type": "any"}, "mint_id": {"description": "string - Idempotency / correlation id for this mint", "type": "any"}, "project_id": {"description": "int - Target logical project id", "type": "any"}, "refresh_token": {"description": "string - Same as access_token (Session OS parity)", "type": "any"}, "session": {"description": "object - Session secrets and metadata (api_key, user_token, role, expires_at, scopes)", "type": "any"}, "success": {"description": "bool - True when mint succeeded", "type": "any"}, "token_type": {"description": "string - Always Bearer", "type": "any"}, "user": {"description": "object - User summary (user_id, email, role, project_id)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.get_profile"], "safe_action": "auth_switch_project", "summary": "Mint a session for an accessible target project (Session OS switch contour).", "title": "Auth Switch Project", "when_to_use": "Only when auth.get_profile mutation_allowed is false. One call, then the mutation. Do not loop it and do not log in again.", "write_mode": null}, {"action": "auth.channel_identities.list", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.list", "source": "overlay", "title": "Auth Channel Identities List", "when_to_use": "List bot channel identities linked to the authenticated user profile."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List bot channel identities linked to the authenticated user profile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"identities": {"description": "array", "type": "any"}, "total": {"description": "number", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "auth_channel_identities_list", "summary": "List bot channel identities linked to the authenticated user profile.", "title": "Auth Channel Identities List", "when_to_use": "List bot channel identities linked to the authenticated user profile.", "write_mode": null}, {"action": "auth.channel_identities.revoke", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.channel_identities.revoke", "mutation_risk": "high", "source": "overlay", "title": "Auth Channel Identities Revoke", "when_to_use": "Revoke a channel identity link by id (owner-only)."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Revoke a channel identity link by id (owner-only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"removed": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "project_admin", "safe_action": "auth_channel_identities_revoke", "summary": "Revoke a channel identity link by id (owner-only).", "title": "Auth Channel Identities Revoke", "when_to_use": "Revoke a channel identity link by id (owner-only).", "write_mode": null}, {"action": "auth.password_setup.mint", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_setup.mint", "mutation_risk": "low", "related_tools": ["auth.register", "projects.add_user"], "source": "overlay", "title": "Auth Password Setup Mint", "when_to_use": "After creating a user with a random password, send this link instead of the password."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "After creating a user with a random password, send this link instead of the password.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"email": {"description": "string", "type": "any"}, "expires_in_sec": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}, "url": {"description": "string — one-time set-password URL", "type": "any"}, "user_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.register", "projects.add_user"], "safe_action": "auth_password_setup_mint", "summary": "Mint a one-time /set-password URL for an existing ecosystem user. Operator-only (ecosystem owner or ecosystem admin/manage_users). The user opens the link, chooses their password, then signs in.", "title": "Auth Password Setup Mint", "when_to_use": "After creating a user with a random password, send this link instead of the password.", "write_mode": null}, {"action": "auth.password_reset.request", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.password_reset.request", "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "source": "overlay", "title": "Auth Password Reset Request", "when_to_use": "User forgot password — triggers reset email when account exists."}, "domain_title": "Auth MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "User forgot password — triggers reset email when account exists.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.auth", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string — generic confirmation (does not reveal if email exists)", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "related_tools": ["auth.login", "auth.register", "auth.password_setup.mint"], "safe_action": "auth_password_reset_request", "summary": "Request a self-service password reset email for an ecosystem user. Always returns the same success message (enumeration-safe). The user opens the link in the email, sets a new password, then signs in.", "title": "Auth Password Reset Request", "when_to_use": "User forgot password — triggers reset email when account exists.", "write_mode": null}, {"action": "auth.identity.resolve", "capability_descriptor": {"complexity": "simple", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.resolve", "source": "overlay", "title": "Auth Identity Resolve", "when_to_use": "Resolve canonical vs display email for a user (support / debug)."}, "domain_title": "Identity MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Resolve canonical vs display email for a user (support / debug).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"canonical_email": {"description": "string", "type": "any"}, "display_email": {"description": "string", "type": "any"}, "member_project_id": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "auth_identity_resolve", "summary": "Resolve canonical vs display email for a user (support / debug).", "title": "Auth Identity Resolve", "when_to_use": "Resolve canonical vs display email for a user (support / debug).", "write_mode": null}, {"action": "auth.identity.conflicts", "capability_descriptor": {"complexity": "simple", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "auth.identity.conflicts", "source": "overlay", "title": "Auth Identity Conflicts", "when_to_use": "List project member emails that diverge from ecosystem canonical auth email."}, "domain_title": "Identity MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "List project member emails that diverge from ecosystem canonical auth email.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.identity", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"conflicts": {"description": "array", "type": "any"}, "count": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "auth_identity_conflicts", "summary": "List project member emails that diverge from ecosystem canonical auth email.", "title": "Auth Identity Conflicts", "when_to_use": "List project member emails that diverge from ecosystem canonical auth email.", "write_mode": null}], "bots": [{"action": "bots.list", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.list", "source": "overlay", "title": "Bots List", "when_to_use": "Enumerate project bots before get/simulate/go_live."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Enumerate project bots before get/simulate/go_live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_list", "summary": "MCP tool bots.list", "title": "Bots List", "when_to_use": "Enumerate project bots before get/simulate/go_live.", "write_mode": null}, {"action": "bots.templates", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.templates", "source": "overlay", "title": "Bots Templates", "when_to_use": "List built-in bot templates before bots.create."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List built-in bot templates before bots.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_templates", "summary": "MCP tool bots.templates", "title": "Bots Templates", "when_to_use": "List built-in bot templates before bots.create.", "write_mode": null}, {"action": "bots.waba_templates", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.waba_templates", "source": "overlay", "title": "Bots Waba Templates", "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync)."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List WhatsApp Business API templates (builtins + optional Graph sync).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_waba_templates", "summary": "MCP tool bots.waba_templates", "title": "Bots Waba Templates", "when_to_use": "List WhatsApp Business API templates (builtins + optional Graph sync).", "write_mode": null}, {"action": "bots.get", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.get", "related_tools": ["bots.list", "bots.update", "bots.archive"], "source": "overlay", "title": "Bots Get", "when_to_use": "Load full bot_spec after bots.list summary pick."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Load full bot_spec after bots.list summary pick.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.list", "bots.update", "bots.archive"], "required_cap": "bots_run", "safe_action": "bots_get", "summary": "MCP tool bots.get", "title": "Bots Get", "when_to_use": "Load full bot_spec after bots.list summary pick.", "write_mode": null}, {"action": "bots.create", "anti_pattern": "Do not treat echo brain_mode as AI success — set brain via bots.set_brain.", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.create", "mutation_risk": "low", "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "source": "handler", "title": "Bots Create", "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel)."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"brain_mode": "echo", "name": "example_string", "project_id": 123, "template_id": "example_string", "template_variables": {}}, "genetic_tags": ["core.bots.fleet.gen1"], "inputSchema": {"properties": {"brain_mode": {"default": "echo", "description": "Initial brain mode: echo (transport only), agent, logic, or hybrid", "enum": ["echo", "agent", "logic", "hybrid"], "type": "string"}, "name": {"description": "Bot display name", "type": "string"}, "project_id": {"description": "Target project id (defaults to context.project_id)", "type": "integer"}, "template_id": {"description": "Optional fleet template id", "type": "string"}, "template_variables": {"description": "Template variable map when template_id is set", "type": "object"}}, "required": ["name"], "type": "object"}, "instruction_hint": "Create a draft bot row (Telegram / WhatsApp / Instagram channel).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.attach_channel", "bots.set_brain", "bots.go_live"], "required_cap": "bots_admin", "rollback": ["bots.archive", "generation.realign_to_prod"], "safe_action": "bots_create", "summary": "MCP tool bots.create", "title": "Bots Create", "verification": ["bots.get", "bots.list"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.list", "predicate": "named resource is visible"}], "when_to_use": "Create a draft bot row (Telegram / WhatsApp / Instagram channel).", "write_mode": null}, {"action": "bots.attach_channel", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.attach_channel", "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "source": "overlay", "title": "Bots Attach Channel", "when_to_use": "Bind channel credentials after bots.create."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bind channel credentials after bots.create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.go_live", "bots.simulate", "bots.health"], "required_cap": "bots_admin", "safe_action": "bots_attach_channel", "summary": "Attach a project messaging connection (telegram, max, whatsapp, …) to a bot fleet row.", "title": "Bots Attach Channel", "when_to_use": "Bind channel credentials after bots.create.", "write_mode": null}, {"action": "bots.go_live", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.go_live", "source": "overlay", "title": "Bots Go Live", "when_to_use": "Activate bot after channel attach + brain config."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "example_params": {"activate_webhook": true, "bot_id": "example_string", "hook_base": "example_string", "project_id": 123}, "genetic_tags": ["core.bots.fleet.gen1"], "inputSchema": {"properties": {"activate_webhook": {"default": true, "description": "Register webhook (default true)", "type": "boolean"}, "bot_id": {"description": "Bot fleet row id", "type": "string"}, "hook_base": {"description": "Webhook base URL override", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["bot_id"], "type": "object"}, "instruction_hint": "Activate bot after channel attach + brain config.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "rollback": ["bots.pause", "generation.realign_to_prod"], "safe_action": "bots_go_live", "summary": "Activate bot webhooks and set lifecycle live (Telegram / MAX / WhatsApp channels).", "title": "Bots Go Live", "verification": ["bots.health", "bots.get"], "verify": [{"action": "bots.health", "predicate": "named resource is visible"}, {"action": "bots.get", "predicate": "named resource is visible"}], "when_to_use": "Activate bot after channel attach + brain config.", "write_mode": null}, {"action": "bots.health", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.health", "source": "overlay", "title": "Bots Health", "when_to_use": "Bot channel + brain health before go_live or incident triage."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bot channel + brain health before go_live or incident triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_health", "summary": "MCP tool bots.health", "title": "Bots Health", "when_to_use": "Bot channel + brain health before go_live or incident triage.", "write_mode": null}, {"action": "bots.reset_message_quota", "ai_tips": "Live bots ACK webhooks but never reply; health.quota.blocked is true.", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.reset_message_quota", "source": "overlay", "title": "Bots Reset Message Quota", "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true."}, "doc_audience": "operator", "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Live bots ACK webhooks but never reply; health.quota.blocked is true.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "safe_action": "bots_reset_message_quota", "summary": "Zero project ``ecosystem.bot_usage`` and the NeuroCache hot counter for the current UTC month. Use when a poisoned cache mutes live Telegram.", "title": "Bots Reset Message Quota", "when_to_use": "Live bots ACK webhooks but never reply; health.quota.blocked is true.", "write_mode": null}, {"action": "bots.dlq_list", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_list", "source": "overlay", "title": "Bots Dlq List", "when_to_use": "List bot queue DLQ items before replay."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot queue DLQ items before replay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_dlq_list", "summary": "MCP tool bots.dlq_list", "title": "Bots Dlq List", "when_to_use": "List bot queue DLQ items before replay.", "write_mode": null}, {"action": "bots.dlq_replay", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.dlq_replay", "source": "overlay", "title": "Bots Dlq Replay", "when_to_use": "Replay one DLQ item after fixing root cause."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Replay one DLQ item after fixing root cause.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "safe_action": "bots_dlq_replay", "summary": "MCP tool bots.dlq_replay", "title": "Bots Dlq Replay", "when_to_use": "Replay one DLQ item after fixing root cause.", "write_mode": null}, {"action": "bots.simulate", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.simulate", "related_tools": ["bots.conversations", "bots.get", "bots.set_brain"], "source": "handler", "title": "Bots Simulate", "when_to_use": "Dry-run inbound message without live channel traffic."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "inputSchema": {"properties": {"access_tier": {"description": "", "type": "string"}, "bot_id": {"description": "Bot id alias", "type": "string"}, "bot_uuid": {"description": "Bot UUID", "type": "string"}, "channel_kind": {"description": "telegram|max|…", "type": "string"}, "chat_type": {"description": "private|group", "type": "string"}, "external_user_id": {"description": "Synthetic external user id for simulate", "type": "string"}, "message": {"description": "Alias for text", "type": "string"}, "principal_user_id": {"description": "", "type": "integer"}, "project_id": {"description": "", "type": "integer"}, "text": {"description": "Inbound user message", "type": "string"}}, "required": ["text"], "type": "object"}, "instruction_hint": "Dry-run inbound message without live channel traffic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.conversations", "bots.get", "bots.set_brain"], "required_cap": "bots_run", "safe_action": "bots_simulate", "summary": "Dry-run one bot brain turn without outbound. Heavy LLM: at most one per sync agentstack.execute (60s batch; 180s if this is the only heavy step). Suites: one simulate per execute, or options.async + d", "title": "Bots Simulate", "when_to_use": "Dry-run inbound message without live channel traffic.", "write_mode": null}, {"action": "bots.conversations", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.conversations", "source": "overlay", "title": "Bots Conversations", "when_to_use": "List bot conversations with handoff/needs_reply enrichment for inbox UI."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "List bot conversations with handoff/needs_reply enrichment for inbox UI.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_conversations", "summary": "List bot conversations with handoff/needs_reply enrichment for inbox UI.", "title": "Bots Conversations", "when_to_use": "List bot conversations with handoff/needs_reply enrichment for inbox UI.", "write_mode": null}, {"action": "bots.set_handoff", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_handoff", "source": "overlay", "title": "Bots Set Handoff", "when_to_use": "Claim or release staff handoff on a bot conversation."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Claim or release staff handoff on a bot conversation.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_set_handoff", "summary": "MCP tool bots.set_handoff", "title": "Bots Set Handoff", "when_to_use": "Claim or release staff handoff on a bot conversation.", "write_mode": null}, {"action": "bots.staff_reply", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.staff_reply", "source": "overlay", "title": "Bots Staff Reply", "when_to_use": "Send staff reply in a handoff conversation."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send staff reply in a handoff conversation.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_staff_reply", "summary": "MCP tool bots.staff_reply", "title": "Bots Staff Reply", "when_to_use": "Send staff reply in a handoff conversation.", "write_mode": null}, {"action": "bots.update", "ai_tips": "Always pass write_mode with commands. One /start object is merge, not replace. Studio Publish sends the full list with write_mode=replace. Empty commands=[] is blocked (commands_empty_blocked). See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "anti_pattern": "Sending commands: [{/start}] intending to edit welcome — that used to wipe the whole menu.", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.update", "mutation_risk": "low", "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "source": "overlay", "title": "Bots Update", "when_to_use": "Change bot name, brain, commands, or agreement. For one slash command prefer bots.commands.upsert. For PathAtom leaf edits use path_updates instead of a full spec."}, "collection_key": "trigger", "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Change bot name, brain, commands, or agreement. For one slash command prefer bots.commands.upsert…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.commands.upsert", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "safe_action": "bots_update", "summary": "Partial bot_spec update (commands, brain, name, …) — same as REST PUT. commands is a keyed list: pass write_mode (merge|replace|delete). A short commands array without write_mode merges by trigger and", "title": "Bots Update", "when_to_use": "Change bot name, brain, commands, or agreement. For one slash command prefer bots.commands.upsert. For PathAtom leaf edits use path_updates instead of a full spec.", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "Pass write_mode with commands. Prefer bots.commands.upsert for one command."}, {"action": "bots.commands.upsert", "ai_tips": "Pass commands as an array of full command objects (trigger + reply_text + buttons). Existing commands with other triggers stay. To remove a command use bots.update write_mode=delete with those triggers.", "anti_pattern": "Using bots.update with a 1-item commands array (legacy wipe).", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.commands.upsert", "mutation_risk": "low", "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "source": "overlay", "title": "Bots Commands Upsert", "when_to_use": "Edit or add slash commands without sending the full menu snapshot."}, "collection_key": "trigger", "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Edit or add slash commands without sending the full menu snapshot.", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.update", "bots.get", "bots.ensure_mentor_commands"], "required_cap": "bots_admin", "safe_action": "bots_commands_upsert", "summary": "Merge one or more bot commands by trigger. Never replaces the command list. Use this instead of bots.update when editing /start, /help, or a single handler.", "title": "Bots Commands Upsert", "when_to_use": "Edit or add slash commands without sending the full menu snapshot.", "write_mode": null, "write_mode_note": "Always merge-by-trigger; never replaces the menu."}, {"action": "bots.ensure_mentor_commands", "anti_pattern": "Running unity_apply_mentor_copy_1444.py when MCP heal is available.", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.ensure_mentor_commands", "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "source": "overlay", "title": "Bots Ensure Mentor Commands", "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer o…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.commands.upsert", "bots.update", "generation.diff_vs_prod", "generation.promote", "knowledge.playground"], "required_cap": "bots_admin", "safe_action": "bots_ensure_mentor_commands", "summary": "Heal mentor /start+/menu+/operator commands + inline buttons (idempotent).", "title": "Bots Ensure Mentor Commands", "when_to_use": "Tenant mentor menu drift, missing /start nav buttons, or post-deploy TG/MAX parity fail. Prefer over local ops scripts when MCP is available.", "write_mode": null}, {"action": "bots.pause", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.pause", "source": "overlay", "title": "Bots Pause", "when_to_use": "Pause bot and optionally deactivate webhook."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Pause bot and optionally deactivate webhook.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "safe_action": "bots_pause", "summary": "MCP tool bots.pause", "title": "Bots Pause", "when_to_use": "Pause bot and optionally deactivate webhook.", "write_mode": null}, {"action": "bots.archive", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.archive", "related_tools": ["bots.get", "bots.list"], "source": "overlay", "title": "Bots Archive", "when_to_use": "Archive a bot after go-live rollback or cleanup."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Archive a bot after go-live rollback or cleanup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "related_tools": ["bots.get", "bots.list"], "required_cap": "bots_admin", "safe_action": "bots_archive", "summary": "MCP tool bots.archive", "title": "Bots Archive", "when_to_use": "Archive a bot after go-live rollback or cleanup.", "write_mode": null}, {"action": "bots.set_brain", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.set_brain", "source": "overlay", "title": "Bots Set Brain", "when_to_use": "Wire Fleet agent or knowledge brain to the bot."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"agent_uuid": "example_string", "bot_id": "example_string", "logic_id": "example_string", "mode": "example_string", "project_id": 123, "rag_collections": []}, "genetic_tags": ["core.bots.fleet.gen1"], "inputSchema": {"properties": {"agent_uuid": {"description": "Agents Fleet uuid when mode=agent", "type": "string"}, "bot_id": {"description": "Bot fleet row id", "type": "string"}, "logic_id": {"description": "Logic rule id fallback", "type": "string"}, "mode": {"description": "Brain mode: agent | logic | hybrid | echo", "enum": ["echo", "agent", "logic", "hybrid"], "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "rag_collections": {"description": "RAG collection ids", "type": "array"}}, "required": ["bot_id", "mode"], "type": "object"}, "instruction_hint": "Wire Fleet agent or knowledge brain to the bot.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "rollback": ["bots.update", "generation.realign_to_prod"], "safe_action": "bots_set_brain", "summary": "MCP tool bots.set_brain", "title": "Bots Set Brain", "verification": ["bots.get", "bots.simulate"], "verify": [{"action": "bots.get", "predicate": "named resource is visible"}, {"action": "bots.simulate", "predicate": "named resource is visible"}], "when_to_use": "Wire Fleet agent or knowledge brain to the bot.", "write_mode": null}, {"action": "bots.broadcast", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.broadcast", "source": "overlay", "title": "Bots Broadcast", "when_to_use": "Broadcast outbound message to bot subscribers."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Broadcast outbound message to bot subscribers.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_admin", "safe_action": "bots_broadcast", "summary": "MCP tool bots.broadcast", "title": "Bots Broadcast", "when_to_use": "Broadcast outbound message to bot subscribers.", "write_mode": null}, {"action": "bots.send_commerce_offer", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.send_commerce_offer", "source": "overlay", "title": "Bots Send Commerce Offer", "when_to_use": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment)."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_send_commerce_offer", "summary": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment).", "title": "Bots Send Commerce Offer", "when_to_use": "Send a commerce offer card to a bot conversation (listing UUID → outbound attachment).", "write_mode": null}, {"action": "bots.fleet_diagnostics", "capability_descriptor": {"complexity": "intermediate", "domain": "bots", "genetic_tags": ["core.bots.fleet.gen1"], "id": "bots.fleet_diagnostics", "source": "overlay", "title": "Bots Fleet Diagnostics", "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics."}, "domain_title": "Bots MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.bots.fleet.gen1"], "instruction_hint": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.bots", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.bots.fleet.gen1", "related_prompts": ["agentstack_bots_studio"], "required_cap": "bots_run", "safe_action": "bots_fleet_diagnostics", "summary": "Project bots fleet health (channel health, sessions) — project read RBAC.", "title": "Bots Fleet Diagnostics", "when_to_use": "Bot Studio / ops triage; mirrors GET /api/projects/{id}/bots/fleet/diagnostics.", "write_mode": null}], "buffs": [{"action": "buffs.create_buff", "anti_pattern": "Don't apply buff before creating it", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.create_buff", "mutation_risk": "low", "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "source": "overlay", "title": "Buffs Create Buff", "when_to_use": "Define buff template for tenant SKUs. Platform operator grants: use buffs.grant_subscription (not create+apply)."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Define buff template for tenant SKUs. Platform operator grants: use buffs.grant_subscription (not…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string - UUID of created buff", "type": "any"}, "created_at": {"description": "string - ISO timestamp of creation", "type": "any"}, "state": {"description": "string - Current state (always 'pending' for new buffs)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.apply_buff", "buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "project_admin", "safe_action": "buffs_create_buff", "summary": "Create a buff template in PENDING state.", "title": "Buffs Create Buff", "tool_chains": ["user_with_trial", "payment_to_subscription", "apply_custom_buff_to_user"], "when_to_use": "Define buff template for tenant SKUs. Platform operator grants: use buffs.grant_subscription (not create+apply).", "write_mode": null}, {"action": "buffs.apply_buff", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_buff", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "source": "overlay", "title": "Buffs Apply Buff", "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Low-level buff apply — prefer apply_temporary_effect for trials.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"application_id": {"description": "string - same as buff_id, for the next revert or cancel step", "type": "any"}, "applied_at": {"description": "string - ISO timestamp of application", "type": "any"}, "buff_id": {"description": "string - UUID of applied buff", "type": "any"}, "expires_at": {"description": "string - ISO timestamp of expiration", "type": "any"}, "state": {"description": "string - Current state (should be 'active' after apply)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.get_buff", "buffs.list_active_buffs", "buffs.get_effective_limits"], "required_cap": "project_admin", "safe_action": "buffs_apply_buff", "summary": "Apply a buff to an entity (user or project).", "title": "Buffs Apply Buff", "tool_chains": ["user_with_trial", "apply_custom_buff_to_user", "marketing_campaign"], "when_to_use": "Low-level buff apply — prefer apply_temporary_effect for trials.", "write_mode": null}, {"action": "buffs.extend_buff", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.extend_buff", "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "source": "overlay", "title": "Buffs Extend Buff", "when_to_use": "Prolong active buff window."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Prolong active buff window.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string - UUID of extended buff", "type": "any"}, "expires_at": {"description": "string - New expiration timestamp", "type": "any"}, "extended": {"description": "bool - Whether extension was successful", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.list_active_buffs"], "required_cap": "mcp_read", "safe_action": "buffs_extend_buff", "summary": "Extend the duration of an active buff.", "title": "Buffs Extend Buff", "when_to_use": "Prolong active buff window.", "write_mode": null}, {"action": "buffs.revert_buff", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.revert_buff", "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "source": "overlay", "title": "Buffs Revert Buff", "when_to_use": "Undo last buff mutation on a user."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Undo last buff mutation on a user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string - UUID of reverted buff", "type": "any"}, "reason": {"description": "string - Reason if revert was not performed (e.g., 'persistent')", "type": "any"}, "reverted": {"description": "bool - Whether revert was successful", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.cancel_buff"], "required_cap": "mcp_read", "safe_action": "buffs_revert_buff", "summary": "Revert an active buff - restore original state from snapshot.", "title": "Buffs Revert Buff", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_to_use": "Undo last buff mutation on a user.", "write_mode": null}, {"action": "buffs.cancel_buff", "aliases": ["buffs.revoke"], "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.cancel_buff", "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "source": "overlay", "title": "Buffs Cancel Buff", "when_to_use": "End active buff before expiry."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "End active buff before expiry.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string - UUID of cancelled buff", "type": "any"}, "cancelled": {"description": "bool - Whether cancellation was successful", "type": "any"}, "deleted": {"description": "bool - Whether buff was deleted", "type": "any"}, "reverted": {"description": "bool - Whether buff was reverted before deletion (for ACTIVE)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.revert_buff"], "required_cap": "mcp_read", "safe_action": "buffs_cancel_buff", "summary": "Cancel a buff in any state (force cancellation).", "title": "Buffs Cancel Buff", "when_to_use": "End active buff before expiry.", "write_mode": null}, {"action": "buffs.get_buff", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_buff", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "source": "overlay", "title": "Buffs Get Buff", "when_to_use": "Inspect one buff definition or active instance."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Inspect one buff definition or active instance.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string - UUID of buff", "type": "any"}, "category": {"description": "string - Buff category", "type": "any"}, "config": {"description": "object - Buff configuration", "type": "any"}, "effects": {"description": "object - Effects applied by buff", "type": "any"}, "expires_at": {"description": "string - Expiration timestamp", "type": "any"}, "is_active": {"description": "bool - Whether buff is active", "type": "any"}, "name": {"description": "string - Buff name", "type": "any"}, "priority": {"description": "int - Priority value", "type": "any"}, "state": {"description": "string - Current state (pending, active, etc.)", "type": "any"}, "type": {"description": "string - Buff type", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff", "buffs.extend_buff"], "required_cap": "mcp_read", "safe_action": "buffs_get_buff", "summary": "Get information about a specific buff.", "title": "Buffs Get Buff", "when_to_use": "Inspect one buff definition or active instance.", "write_mode": null}, {"action": "buffs.list_active_buffs", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.list_active_buffs", "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "source": "overlay", "title": "Buffs List Active Buffs", "when_to_use": "List entitlements before get_effective_limits."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "List entitlements before get_effective_limits.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_buffs": {"description": "array - Array of active buff objects", "type": "any"}, "entity_id": {"description": "int - Entity ID", "type": "any"}, "entity_kind": {"description": "string - Entity kind", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_buff", "buffs.get_effective_limits", "buffs.extend_buff"], "required_cap": "mcp_read", "safe_action": "buffs_list_active_buffs", "summary": "List active buffs for an entity.", "title": "Buffs List Active Buffs", "tool_chains": ["payment_to_subscription", "apply_custom_buff_to_user"], "when_to_use": "List entitlements before get_effective_limits.", "write_mode": null}, {"action": "buffs.get_effective_limits", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.get_effective_limits", "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "source": "overlay", "title": "Buffs Get Effective Limits", "when_to_use": "Read merged limits. entity_kind=user → personal plane (free/premium/vip); entity_kind=project → business plane (launch/business/scale). Personal Premium/VIP never raises project quotas."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Read merged limits. entity_kind=user → personal plane (free/premium/vip); entity_kind=project → b…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"effective_limits": {"description": "object - Effective limits with all buffs applied", "type": "any"}, "entity_id": {"description": "int - Entity ID", "type": "any"}, "entity_kind": {"description": "string - Entity kind", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "buffs.apply_buff"], "required_cap": "mcp_read", "safe_action": "buffs_get_effective_limits", "summary": "Get effective limits for an entity with all buffs applied.", "title": "Buffs Get Effective Limits", "when_to_use": "Read merged limits. entity_kind=user → personal plane (free/premium/vip); entity_kind=project → business plane (launch/business/scale). Personal Premium/VIP never raises project quotas.", "write_mode": null}, {"action": "buffs.apply_temporary_effect", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_temporary_effect", "mutation_risk": "low", "related_tools": ["buffs.get_effective_limits", "payments.create"], "source": "overlay", "title": "Buffs Apply Temporary Effect", "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Time-boxed trial or promo tier — prefer over custom subscription tables.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied_at": {"description": "string - Application timestamp", "type": "any"}, "buff_id": {"description": "string - UUID of created and applied buff", "type": "any"}, "expires_at": {"description": "string - Expiration timestamp", "type": "any"}, "state": {"description": "string - Should be 'active'", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "payments.create"], "required_cap": "project_admin", "safe_action": "buffs_apply_temporary_effect", "summary": "Quickly apply a temporary effect (creates and applies buff in one step).", "title": "Buffs Apply Temporary Effect", "tool_chains": ["scheduled_rewards", "usage_monitoring"], "when_to_use": "Time-boxed trial or promo tier — prefer over custom subscription tables.", "write_mode": null}, {"action": "buffs.apply_persistent_effect", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1"], "id": "buffs.apply_persistent_effect", "mutation_risk": "low", "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "source": "overlay", "title": "Buffs Apply Persistent Effect", "when_to_use": "Grant durable entitlement after payment or admin action."}, "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Grant durable entitlement after payment or admin action.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied_at": {"description": "string - Application timestamp", "type": "any"}, "buff_id": {"description": "string - UUID of created and applied buff", "type": "any"}, "persistent": {"description": "bool - Always true for persistent effects", "type": "any"}, "state": {"description": "string - Should be 'active'", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.create_buff", "buffs.apply_buff", "buffs.apply_temporary_effect"], "required_cap": "project_admin", "safe_action": "buffs_apply_persistent_effect", "summary": "Quickly apply a persistent effect (creates and applies permanent buff).", "title": "Buffs Apply Persistent Effect", "when_to_use": "Grant durable entitlement after payment or admin action.", "write_mode": null}, {"action": "buffs.grant_subscription", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_subscription", "mutation_risk": "high", "related_tools": ["buffs.get_effective_limits", "buffs.list_active_buffs"], "source": "overlay", "title": "Buffs Grant Subscription", "when_blocked": {"forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind"}, "when_to_use": "Platform operator grant only (ecosystem ops jurisdiction). Not tenant SKU sales — use agentstack_tenant_subscription_monetization."}, "doc_audience": "operator", "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Platform operator grant only (ecosystem ops jurisdiction). Not tenant SKU sales — use agentstack_…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"buff_id": {"description": "string", "type": "any"}, "category": {"description": "string", "type": "any"}, "effective_limits": {"description": "object (when verify=true)", "type": "any"}, "entity_kind": {"description": "string", "type": "any"}, "state": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "buffs.list_active_buffs"], "required_cap": "mcp_read", "safe_action": "buffs_grant_subscription", "summary": "Platform operator: grant AgentStack subscription tier in one step (resolve → create_buff → apply_buff).", "title": "Buffs Grant Subscription", "tool_chains": ["multi_tenant_onboarding"], "when_blocked": {"forbidden": "ecosystem operator only — operator session on ecosystem ops; not tenant SKU sales", "grant_failed": "buffs.get_effective_limits verify; check entity_id and plane", "invalid_tier": "plane+tier from platform grant table (personal premium/vip or project launch+)", "preflight_blocked": "preflight.check with ecosystem ops context bound before grant", "service_cap_denied": "buffs.write cap on API key — widen service_caps or operator session", "tier_denied": "tier/cap denied — buffs.get_effective_limits first; verify plane+entity_kind"}, "when_to_use": "Platform operator grant only (ecosystem ops jurisdiction). Not tenant SKU sales — use agentstack_tenant_subscription_monetization.", "write_mode": null}, {"action": "buffs.grant_tenant_subscription", "capability_descriptor": {"complexity": "intermediate", "domain": "buffs", "genetic_tags": ["core.buffs.hub.gen1", "shared.subscription.two_plane.gen1"], "id": "buffs.grant_tenant_subscription", "mutation_risk": "low", "related_tools": ["buffs.list_active_buffs", "commerce.participant.grant_holding", "buffs.create_buff"], "source": "overlay", "title": "Buffs Grant Tenant Subscription", "when_blocked": {"forbidden": "authenticated operator + tenant project — never grant_subscription on tenant buyer grant", "insufficient_permissions": "project write on tenant project — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (tenant project)", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug"}, "when_to_use": "Tenant agent grants subscription/comp to end user. Requires project write on tenant project. Not buffs.grant_subscription."}, "doc_audience": "operator", "domain_title": "Buffs MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.buffs.hub.gen1"], "instruction_hint": "Tenant agent grants subscription/comp to end user. Requires project write on tenant project. Not …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.buffs", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"active_buffs": {"description": "array (when verify=true)", "type": "any"}, "buff_id": {"description": "string", "type": "any"}, "expires_at": {"description": "string", "type": "any"}, "plan_id": {"description": "string", "type": "any"}, "recipient_project_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.buffs.hub.gen1", "related_prompts": ["agentstack_platform_subscription_grant", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_read_bootstrap"], "related_tools": ["buffs.list_active_buffs", "commerce.participant.grant_holding", "buffs.create_buff"], "required_cap": "buffs.write", "safe_action": "buffs_grant_tenant_subscription", "summary": "Tenant operator: grant subscription entitlement to an end user in your project (one-shot).", "title": "Buffs Grant Tenant Subscription", "tool_chains": ["trial_to_paid_tier", "trial_to_premium"], "when_blocked": {"forbidden": "authenticated operator + tenant project — never grant_subscription on tenant buyer grant", "insufficient_permissions": "project write on tenant project — not personal Premium/VIP", "invalid_project": "context.project_id or params.project_id required (tenant project)", "tenant_grant_failed": "buffs.create_buff SKU first or check plan_id slug"}, "when_to_use": "Tenant agent grants subscription/comp to end user. Requires project write on tenant project. Not buffs.grant_subscription.", "write_mode": null}], "business": [{"action": "business.get_org", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.get_org", "source": "handler", "title": "Business Get Org", "when_to_use": "Get business org config and children index for a head project."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Get business org config and children index for a head project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_get_org", "summary": "Get business org config and children index for a head project.", "title": "Business Get Org", "when_to_use": "Get business org config and children index for a head project.", "write_mode": null}, {"action": "business.list_children", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_children", "source": "handler", "title": "Business List Children", "when_to_use": "List child organ projects for a business head."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"limit": {"description": "", "type": "integer"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "List child organ projects for a business head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_list_children", "summary": "List child organ projects for a business head.", "title": "Business List Children", "when_to_use": "List child organ projects for a business head.", "write_mode": null}, {"action": "business.attach_child", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.attach_child", "mutation_risk": "low", "source": "handler", "title": "Business Attach Child", "when_to_use": "Attach a child organ project to a business head."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"display_name": {"description": "", "type": "string"}, "idempotency_key": {"description": "", "type": "string"}, "organ": {"description": "", "type": "string"}, "preset_id": {"description": "", "type": "string"}, "project_id": {"description": "Head project id", "type": "integer"}}, "required": ["project_id", "organ", "display_name"], "type": "object"}, "instruction_hint": "Attach a child organ project to a business head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_attach_child", "summary": "Attach a child organ project to a business head.", "title": "Business Attach Child", "when_to_use": "Attach a child organ project to a business head.", "write_mode": null}, {"action": "business.link_child", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.link_child", "source": "overlay", "title": "Business Link Child", "when_to_use": "Link an existing owned project as a business organ (adopt)."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "instruction_hint": "Link an existing owned project as a business organ (adopt).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_link_child", "summary": "Link an existing owned project as a business organ (adopt).", "title": "Business Link Child", "when_to_use": "Link an existing owned project as a business organ (adopt).", "write_mode": null}, {"action": "business.list_adopt_candidates", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_adopt_candidates", "source": "overlay", "title": "Business List Adopt Candidates", "when_to_use": "List projects eligible for adopt/link into a business head."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "instruction_hint": "List projects eligible for adopt/link into a business head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_list_adopt_candidates", "summary": "List projects eligible for adopt/link into a business head.", "title": "Business List Adopt Candidates", "when_to_use": "List projects eligible for adopt/link into a business head.", "write_mode": null}, {"action": "business.list_composite_adopt_candidates", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.list_composite_adopt_candidates", "source": "overlay", "title": "Business List Composite Adopt Candidates", "when_to_use": "List standalone projects eligible for adopt during composite business create."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "instruction_hint": "List standalone projects eligible for adopt during composite business create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_list_composite_adopt_candidates", "summary": "List standalone projects eligible for adopt during composite business create.", "title": "Business List Composite Adopt Candidates", "when_to_use": "List standalone projects eligible for adopt during composite business create.", "write_mode": null}, {"action": "business.transfer_preflight", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "business.transfer_preflight", "source": "overlay", "title": "Business Transfer Preflight", "when_to_use": "Scan transfer blockers before listing a project for sale."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "instruction_hint": "Scan transfer blockers before listing a project for sale.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_transfer_preflight", "summary": "Scan transfer blockers before listing a project for sale.", "title": "Business Transfer Preflight", "when_to_use": "Scan transfer blockers before listing a project for sale.", "write_mode": null}, {"action": "business.detach_child", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.detach_child", "mutation_risk": "low", "source": "handler", "title": "Business Detach Child", "when_to_use": "Detach a child organ from business head."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"child_project_id": {"description": "", "type": "integer"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "child_project_id"], "type": "object"}, "instruction_hint": "Detach a child organ from business head.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_detach_child", "summary": "Detach a child organ from business head.", "title": "Business Detach Child", "when_to_use": "Detach a child organ from business head.", "write_mode": null}, {"action": "business.command_snapshot", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.command_snapshot", "source": "handler", "title": "Business Command Snapshot", "when_to_use": "Business command center aggregate (finance + CRM + org)."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"include_integrations": {"description": "", "type": "boolean"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Business command center aggregate (finance + CRM + org).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_command_snapshot", "summary": "Business command center aggregate (finance + CRM + org).", "title": "Business Command Snapshot", "when_to_use": "Business command center aggregate (finance + CRM + org).", "write_mode": null}, {"action": "business.create_composite", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.create_composite", "mutation_risk": "high", "source": "handler", "title": "Business Create Composite", "when_to_use": "Create business head + attach organ children from template."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"name": {"description": "", "type": "string"}, "organs": {"description": "", "type": "array"}, "tariff_template_id": {"description": "", "type": "string"}}, "required": ["name"], "type": "object"}, "instruction_hint": "Create business head + attach organ children from template.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_create_composite", "summary": "Create business head + attach organ children from template.", "title": "Business Create Composite", "when_to_use": "Create business head + attach organ children from template.", "write_mode": null}, {"action": "business.list_tariff_templates", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.list_tariff_templates", "source": "handler", "title": "Business List Tariff Templates", "when_to_use": "List business tariff templates available for a head project."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "List business tariff templates available for a head project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "mcp_read", "safe_action": "business_list_tariff_templates", "summary": "List business tariff templates available for a head project.", "title": "Business List Tariff Templates", "when_to_use": "List business tariff templates available for a head project.", "write_mode": null}, {"action": "business.apply_tariff", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.apply_tariff", "mutation_risk": "low", "source": "handler", "title": "Business Apply Tariff", "when_to_use": "Apply a tariff template to a business head project."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}, "template_id": {"description": "", "type": "string"}}, "required": ["project_id", "template_id"], "type": "object"}, "instruction_hint": "Apply a tariff template to a business head project.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_apply_tariff", "summary": "Apply a tariff template to a business head project.", "title": "Business Apply Tariff", "when_to_use": "Apply a tariff template to a business head project.", "write_mode": null}, {"action": "business.patch_org_settings", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.business.organism.gen1"], "id": "business.patch_org_settings", "mutation_risk": "low", "source": "handler", "title": "Business Patch Org Settings", "when_to_use": "Patch business head org settings (config.org leaf)."}, "domain_title": "Business Org MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.business.organism.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}, "settings": {"description": "", "type": "object"}}, "required": ["project_id", "settings"], "type": "object"}, "instruction_hint": "Patch business head org settings (config.org leaf).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.business_org", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.business.organism.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_business_organism", "agentstack_business_flows"], "required_cap": "project_admin", "safe_action": "business_patch_org_settings", "summary": "Patch business head org settings (config.org leaf).", "title": "Business Patch Org Settings", "when_to_use": "Patch business head org settings (config.org leaf).", "write_mode": null}], "calendar": [{"action": "calendar.events", "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.events", "source": "overlay", "title": "Calendar Events", "when_to_use": "Show project calendar month view before upserting manual events."}, "domain_title": "Calendar MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Show project calendar month view before upserting manual events.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"events": {"description": "array", "type": "any"}, "month": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.calendar.gen1", "required_cap": "mcp_read", "safe_action": "calendar_events", "summary": "List calendar events merged from CRM deals, activities, invoices, manual.", "title": "Calendar Events", "when_to_use": "Show project calendar month view before upserting manual events.", "write_mode": null}, {"action": "calendar.event.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.upsert", "mutation_risk": "low", "source": "overlay", "title": "Calendar Event Upsert", "when_to_use": "Add or edit a manual calendar block after calendar.events."}, "domain_title": "Calendar MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"event": {}, "project_id": 123}, "genetic_tags": ["core.mcp.calendar.gen1"], "inputSchema": {"properties": {"event": {"description": "Manual event. Fields: id, title, start, end, timezone, date, kind. kind is meeting|deadline|task|focus|other. Unknown kind is reported in ignored_fields and stored as other. start_at/end_at/tz alias start/end/timezone. date is the YYYY-MM-DD key derived from start when date is omitted. Timestamps are absolute local times in timezone (IANA, for example America/Sao_Paulo); end before start on the same day is rejected by the client. Unknown keys are listed in ignored_fields and are not stored.", "type": "object"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "event"], "type": "object"}, "instruction_hint": "Add or edit a manual calendar block after calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"event": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.calendar.gen1", "required_cap": "project_admin", "rollback": ["calendar.event.delete"], "safe_action": "calendar_event_upsert", "summary": "Create or update a manual calendar event on ecosystem.calendar.manual_events.", "title": "Calendar Event Upsert", "verification": ["calendar.events"], "verify": [{"action": "calendar.events", "predicate": "named resource is visible"}], "when_to_use": "Add or edit a manual calendar block after calendar.events.", "write_mode": null}, {"action": "calendar.event.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "calendar", "genetic_tags": ["core.mcp.calendar.gen1"], "id": "calendar.event.delete", "mutation_risk": "high", "source": "overlay", "title": "Calendar Event Delete", "when_to_use": "Remove a manual event by id from calendar.events."}, "domain_title": "Calendar MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.calendar.gen1"], "instruction_hint": "Remove a manual event by id from calendar.events.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.calendar", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}, "event_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.calendar.gen1", "required_cap": "project_admin", "safe_action": "calendar_event_delete", "summary": "Delete a manual calendar event by id.", "title": "Calendar Event Delete", "when_to_use": "Remove a manual event by id from calendar.events.", "write_mode": null}], "cardgame": [{"action": "cardgame.dna.read_rows", "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.dna.read_rows", "related_tools": ["commands.execute", "cardgame.rules.execute"], "source": "overlay", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move."}, "domain_title": "Cardgame MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["commands.execute", "cardgame.rules.execute"], "required_cap": "mcp_read", "safe_action": "cardgame_dna_read_rows", "summary": "List up to ``limit`` rows for a cardgame 8DNA entity type using DNA CRUD get (same permission model as the SPA). Use for match room / cell snapshots when building agent context.", "title": "Cardgame Dna Read Rows", "when_to_use": "Read public or owner-scoped cardgame state for reasoning before proposing a move.", "write_mode": null}, {"action": "cardgame.rules.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "cardgame", "genetic_tags": ["core.mcp.cardgame.gen1"], "id": "cardgame.rules.execute", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "source": "overlay", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side."}, "domain_title": "Cardgame MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.cardgame.gen1"], "instruction_hint": "Let an agent take a turn or advance match flow after validating legality server-side.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.cardgame", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.cardgame.gen1", "related_tools": ["cardgame.dna.read_rows", "logic.execute"], "required_cap": "project_admin", "safe_action": "cardgame_rules_execute", "summary": "Execute a Logic Engine command for ArcaneStack (e.g. ``cardgame.match.play_card``) with the same payload shape as the game client. Requires authenticated MCP context.", "title": "Cardgame Rules Execute", "when_to_use": "Let an agent take a turn or advance match flow after validating legality server-side.", "write_mode": null}], "channels": [{"action": "channels.list_identities", "aliases": ["channel.list_identities"], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.list_identities", "related_tools": ["channels.enroll_source", "notifications.list_prefs"], "source": "live", "title": "Channels List Identities", "when_to_use": "Before enroll_source — user must /login in bot first."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Before enroll_source — user must /login in bot first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"identities": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.enroll_source", "notifications.list_prefs"], "required_cap": "mcp_read", "safe_action": "channels_list_identities", "summary": "List linked bot channel identities for the signed-in user.", "title": "Channels List Identities", "when_to_use": "Before enroll_source — user must /login in bot first.", "write_mode": null}, {"action": "channels.enroll_source", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.enroll_source", "related_tools": ["channels.delete_source", "notifications.list_prefs"], "source": "live", "title": "Channels Enroll Source", "when_to_use": "Profile ReachabilityHub or bot /notify_on parity."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Profile ReachabilityHub or bot /notify_on parity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"sources": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "notifications.list_prefs"], "required_cap": "mcp_read", "safe_action": "channels_enroll_source", "summary": "Upsert a notification source (bot channel, web_push, email enrollment).", "title": "Channels Enroll Source", "when_to_use": "Profile ReachabilityHub or bot /notify_on parity.", "write_mode": null}, {"action": "channels.delete_source", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.delete_source", "source": "live", "title": "Channels Delete Source", "when_to_use": "Profile unenroll / revoke bot notify source."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Profile unenroll / revoke bot notify source.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"sources": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "channels_delete_source", "summary": "Remove a notification source by id.", "title": "Channels Delete Source", "when_to_use": "Profile unenroll / revoke bot notify source.", "write_mode": null}, {"action": "channels.deliver", "aliases": ["channel.deliver", "channels.notify", "channels.send"], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.deliver", "related_tools": ["notifications.deliver", "channels.resolve_routing"], "source": "live", "title": "Channels Deliver", "when_to_use": "Tenant notices with routing organelle + receipts."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Tenant notices with routing organelle + receipts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"delivery": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "channels.resolve_routing"], "required_cap": "mcp_read", "safe_action": "channels_deliver", "summary": "Send via unified channel plane (same bus as notifications.deliver).", "title": "Channels Deliver", "when_to_use": "Tenant notices with routing organelle + receipts.", "write_mode": null}, {"action": "channels.delivery_status", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.delivery_status", "source": "live", "title": "Channels Delivery Status", "when_to_use": "Track OTP / alert delivery outcome."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Track OTP / alert delivery outcome.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"latest_status": {"description": "string", "type": "any"}, "receipts": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "channels_delivery_status", "summary": "Read delivery receipts for a correlation_key from user DNA.", "title": "Channels Delivery Status", "when_to_use": "Track OTP / alert delivery outcome.", "write_mode": null}, {"action": "channels.test_delivery", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.test_delivery", "source": "live", "title": "Channels Test Delivery", "when_to_use": "Ops / Profile test ping."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Ops / Profile test ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"delivery": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "channels_test_delivery", "summary": "Enqueue a short test message on one channel (self or admin).", "title": "Channels Test Delivery", "when_to_use": "Ops / Profile test ping.", "write_mode": null}, {"action": "channels.resolve_routing", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.resolve_routing", "source": "live", "title": "Channels Resolve Routing", "when_to_use": "Before deliver — explain why a channel was skipped."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Before deliver — explain why a channel was skipped.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"effective_channels": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "channels_resolve_routing", "summary": "Preview effective channels after prefs ∩ sources ∩ project policy.", "title": "Channels Resolve Routing", "when_to_use": "Before deliver — explain why a channel was skipped.", "write_mode": null}, {"action": "channels.list_failed_deliveries", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.list_failed_deliveries", "source": "live", "title": "Channels List Failed Deliveries", "when_to_use": "Profile delivery troubleshooting."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Profile delivery troubleshooting.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"failed": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "channels_list_failed_deliveries", "summary": "Recent failed/skipped delivery receipts for the user.", "title": "Channels List Failed Deliveries", "when_to_use": "Profile delivery troubleshooting.", "write_mode": null}, {"action": "channels.list_event_triggers", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.list_event_triggers", "related_tools": ["logic.create", "notifications.deliver"], "source": "live", "title": "Channels List Event Triggers", "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "Attach Logic rules to delivery/enrollment/MFA channel events.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"triggers": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["logic.create", "notifications.deliver"], "required_cap": "mcp_read", "safe_action": "channels_list_event_triggers", "summary": "Catalog of normalized channel neural_event kinds for Logic subscriptions.", "title": "Channels List Event Triggers", "when_to_use": "Attach Logic rules to delivery/enrollment/MFA channel events.", "write_mode": null}, {"action": "channels.flush_digest", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.channels.gen1"], "id": "channels.flush_digest", "related_tools": ["notifications.list_prefs", "notifications.deliver"], "source": "live", "title": "Channels Flush Digest", "when_to_use": "User wants batched/deferred alerts delivered immediately."}, "domain_title": "Channels MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.channels.gen1"], "instruction_hint": "User wants batched/deferred alerts delivered immediately.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.channels", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"attempted": {"description": "integer", "type": "any"}, "flushed": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.channels.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.list_prefs", "notifications.deliver"], "required_cap": "mcp_read", "safe_action": "channels_flush_digest", "summary": "Flush pending quiet-hours / digest notifications for the signed-in user.", "title": "Channels Flush Digest", "when_to_use": "User wants batched/deferred alerts delivered immediately.", "write_mode": null}], "checklist": [{"action": "checklist.get", "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "genetic_tags": ["core.mcp.checklist.gen1"], "id": "checklist.get", "source": "overlay", "title": "Checklist Get", "when_to_use": "Read deal or task checklist before toggling items."}, "domain_title": "Checklist MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.checklist.gen1"], "instruction_hint": "Read deal or task checklist before toggling items.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.checklist", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.checklist.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "mcp_read", "safe_action": "checklist_get", "summary": "Get checklist for an entity (e.g. crm_deal).", "title": "Checklist Get", "when_to_use": "Read deal or task checklist before toggling items.", "write_mode": null}, {"action": "checklist.set", "ai_tips": "Replace full checklist template on a CRM deal or work item.", "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "genetic_tags": ["core.mcp.checklist.gen1"], "id": "checklist.set", "source": "overlay", "title": "Checklist Set", "when_to_use": "Replace full checklist template on a CRM deal or work item."}, "domain_title": "Checklist MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "example_params": {"entity_id": "example_string", "entity_type": "example_string", "items": [], "project_id": 123, "write_mode": "example_string"}, "genetic_tags": ["core.mcp.checklist.gen1"], "inputSchema": {"properties": {"entity_id": {"description": "", "type": "string"}, "entity_type": {"description": "", "type": "string"}, "items": {"description": "Array of checklist item objects", "items": {"properties": {"id": {"description": "Stable item id", "type": "string"}, "label": {"description": "Human-readable step label", "type": "string"}, "order": {"description": "Sort order (optional)", "type": "integer"}, "status": {"description": "Item state", "enum": ["pending", "active", "done"], "type": "string"}}, "required": ["id", "label"], "type": "object"}, "minItems": 1, "type": "array"}, "project_id": {"description": "", "type": "integer"}, "write_mode": {"description": "Required for collection writes. merge/patch/upsert = overlay by key; replace/write = full snapshot; delete = remove listed keys. Omit only if you want the safe heuristic (partial list merges).", "enum": ["merge", "patch", "upsert", "replace", "write", "delete"], "type": "string"}}, "required": ["project_id", "entity_type", "entity_id", "items"], "type": "object"}, "instruction_hint": "Replace full checklist template on a CRM deal or work item.", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.checklist", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.checklist.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "mcp_read", "rollback": ["checklist.set"], "safe_action": "checklist_set", "summary": "Replace checklist items for an entity.", "title": "Checklist Set", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_to_use": "Replace full checklist template on a CRM deal or work item.", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "checklist.set replaces the full items list — write_mode defaults to replace."}, {"action": "checklist.toggle_item", "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "genetic_tags": ["core.mcp.checklist.gen1"], "id": "checklist.toggle_item", "source": "overlay", "title": "Checklist Toggle Item", "when_to_use": "Mark one checklist step done or reopen after checklist.get."}, "domain_title": "Checklist MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.checklist.gen1"], "instruction_hint": "Mark one checklist step done or reopen after checklist.get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.checklist", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.checklist.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "mcp_read", "safe_action": "checklist_toggle_item", "summary": "Toggle or set status on one checklist item.", "title": "Checklist Toggle Item", "when_to_use": "Mark one checklist step done or reopen after checklist.get.", "write_mode": null}, {"action": "checklist.append_item", "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "genetic_tags": ["core.mcp.checklist.gen1"], "id": "checklist.append_item", "source": "overlay", "title": "Checklist Append Item", "when_to_use": "Add a new step to an existing entity checklist."}, "domain_title": "Checklist MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.checklist.gen1"], "instruction_hint": "Add a new step to an existing entity checklist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.checklist", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.checklist.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "mcp_read", "safe_action": "checklist_append_item", "summary": "Append a checklist step.", "title": "Checklist Append Item", "when_to_use": "Add a new step to an existing entity checklist.", "write_mode": null}, {"action": "checklist.clear", "capability_descriptor": {"complexity": "intermediate", "domain": "checklist", "genetic_tags": ["core.mcp.checklist.gen1"], "id": "checklist.clear", "source": "overlay", "title": "Checklist Clear", "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap."}, "domain_title": "Checklist MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"entity_id": "example_string", "entity_type": "example_string", "project_id": 123}, "genetic_tags": ["core.mcp.checklist.gen1"], "inputSchema": {"properties": {"entity_id": {"description": "", "type": "string"}, "entity_type": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "entity_type", "entity_id"], "type": "object"}, "instruction_hint": "Reset deal or work-item checklist before cert cleanup or template swap.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.checklist", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checklist": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.checklist.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "mcp_read", "rollback": [], "safe_action": "checklist_clear", "summary": "Clear all checklist items for an entity.", "title": "Checklist Clear", "verification": ["checklist.get"], "verify": [{"action": "checklist.get", "predicate": "named resource is visible"}], "when_to_use": "Reset deal or work-item checklist before cert cleanup or template swap.", "write_mode": null}], "commands": [{"action": "commands.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute", "mutation_risk": "low", "related_tools": ["commands.execute_batch"], "source": "overlay", "title": "Commands Execute", "when_to_use": "Run one registered command by id with params."}, "domain_title": "Commands MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Run one registered command by id with params.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"command_uuid": {"description": "string - Unique command identifier (UUID format)", "type": "any"}, "execution_time_ms": {"description": "float - Actual execution time in milliseconds. Useful for performance monitoring", "type": "any"}, "result": {"description": "object - Command execution result. Structure depends on command type. For DNA_CRUD: contains entity data. For other types: contains operation-specific data", "type": "any"}, "status": {"description": "string - Command execution status. Values: 'pending' (queued), 'queued' (waiting), 'executing' (running), 'completed' (success), 'failed' (error), 'cancelled' (aborted)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.commands.gen1", "related_tools": ["commands.execute_batch"], "required_cap": "logic_write|mcp.execute", "safe_action": "commands_execute", "summary": "Execute a single Protein Command via universal API.", "title": "Commands Execute", "tool_chains": ["game_setup"], "when_to_use": "Run one registered command by id with params.", "write_mode": null}, {"action": "commands.execute_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "commands", "genetic_tags": ["core.mcp.commands.gen1"], "id": "commands.execute_batch", "mutation_risk": "low", "related_tools": ["commands.execute"], "source": "overlay", "title": "Commands Execute Batch", "when_to_use": "Run multiple commands atomically — respect stopOnError."}, "domain_title": "Commands MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.commands.gen1"], "instruction_hint": "Run multiple commands atomically — respect stopOnError.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commands", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"failed_commands": {"description": "int - Number of commands that failed", "type": "any"}, "results": {"description": "array - Array of command result objects. Each result has same structure as commands.execute response: {command_uuid, status, result, execution_time_ms}", "type": "any"}, "successful_commands": {"description": "int - Number of commands that completed successfully", "type": "any"}, "total_commands": {"description": "int - Total number of commands in the batch", "type": "any"}, "total_execution_time_ms": {"description": "float - Total time taken to execute all commands in milliseconds. For parallel execution, this is the time of the slowest command. For sequential, it's the sum of all command execution times", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.commands.gen1", "related_tools": ["commands.execute"], "required_cap": "logic_write|mcp.execute", "safe_action": "commands_execute_batch", "summary": "Execute multiple Protein Commands in batch.", "title": "Commands Execute Batch", "when_to_use": "Run multiple commands atomically — respect stopOnError.", "write_mode": null}], "commerce": [{"action": "commerce.ai.generate_products", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.generate_products", "source": "overlay", "title": "Commerce Ai Generate Products", "when_to_use": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/generate-products."}, "domain_title": "Commerce Ai MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/g…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_ai", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"products": {"description": "array", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_ai_generate_products", "summary": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/generate-products.", "title": "Commerce Ai Generate Products", "when_to_use": "Dry-run AI product generation — returns wizard answer dicts only. Mirrors POST /api/commerce/ai/generate-products.", "write_mode": null}, {"action": "commerce.ai.magic_fill", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.ai.magic_fill", "source": "overlay", "title": "Commerce Ai Magic Fill", "when_to_use": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill."}, "domain_title": "Commerce Ai MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_ai", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"answers": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_ai_magic_fill", "summary": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill.", "title": "Commerce Ai Magic Fill", "when_to_use": "Parse text into product wizard answers. Mirrors POST /api/commerce/ai/magic-fill.", "write_mode": null}, {"action": "commerce.coupon.list", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.list", "source": "overlay", "title": "Commerce Coupon List", "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons."}, "domain_title": "Commerce Coupons MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/mer…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_coupons", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"coupons": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_coupon_list", "summary": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "title": "Commerce Coupon List", "when_to_use": "List project-scoped promo codes from 8DNA commerce.coupon_registry. Mirrors GET /api/commerce/merchant/coupons.", "write_mode": null}, {"action": "commerce.coupon.create", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.create", "source": "overlay", "title": "Commerce Coupon Create", "when_to_use": "Create discount coupon for checkout — not Stripe SDK."}, "domain_title": "Commerce Coupons MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Create discount coupon for checkout — not Stripe SDK.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_coupons", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"coupon": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_coupon_create", "summary": "Create a shop promo code (percent or fixed USDT off). Optional listing_uuids scopes the code to specific listings. Mirrors POST /api/commerce/merchant/coupons.", "title": "Commerce Coupon Create", "when_to_use": "Create discount coupon for checkout — not Stripe SDK.", "write_mode": null}, {"action": "commerce.coupon.update", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.update", "source": "overlay", "title": "Commerce Coupon Update", "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}."}, "domain_title": "Commerce Coupons MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_coupons", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"coupon": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_coupon_update", "summary": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Update", "when_to_use": "Update a project promo code. Mirrors PUT /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.coupon.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.coupon.delete", "source": "overlay", "title": "Commerce Coupon Delete", "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}."}, "domain_title": "Commerce Coupons MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_coupons", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_coupon_delete", "summary": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "title": "Commerce Coupon Delete", "when_to_use": "Delete a project promo code. Mirrors DELETE /api/commerce/merchant/coupons/{code}.", "write_mode": null}, {"action": "commerce.participant.grant_holding", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.participant.grant_holding", "mutation_risk": "low", "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "source": "overlay", "title": "Commerce Participant Grant Holding", "when_to_use": "Grant digital goods inventory to buyer user_id in tenant project. Requires project write."}, "doc_audience": "operator", "domain_title": "Commerce Participant MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Grant digital goods inventory to buyer user_id in tenant project. Requires project write.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_participant", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["assets.list", "buffs.grant_tenant_subscription", "commerce.sell.activate"], "required_cap": "assets_write", "safe_action": "commerce_participant_grant_holding", "summary": "Grant catalog asset holdings to an end user in your tenant project.", "title": "Commerce Participant Grant Holding", "when_to_use": "Grant digital goods inventory to buyer user_id in tenant project. Requires project write.", "write_mode": null}, {"action": "commerce.refund.status", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.status", "source": "overlay", "title": "Commerce Refund Status", "when_to_use": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refund-request."}, "domain_title": "Commerce Refunds MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refu…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_refunds", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"compensation": {"description": "object", "type": "any"}, "refund_request": {"description": "object", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_refund_status", "summary": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refund-request.", "title": "Commerce Refund Status", "when_to_use": "Poll refund request + compensation for an order. Mirrors GET /api/commerce/orders/{order_id}/refund-request.", "write_mode": null}, {"action": "commerce.refund.manual_list", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_list", "source": "overlay", "title": "Commerce Refund Manual List", "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds."}, "domain_title": "Commerce Refunds MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce s…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_refunds", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int", "type": "any"}, "pending": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_refund_manual_list", "summary": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "title": "Commerce Refund Manual List", "when_to_use": "Ecosystem admin: list refund_requested orders awaiting manual compensation for a buyer commerce slice. Mirrors GET /api/admin/commerce/manual-refunds.", "write_mode": null}, {"action": "commerce.refund.manual_complete", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.refund.manual_complete", "source": "overlay", "title": "Commerce Refund Manual Complete", "when_to_use": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. Mirrors POST /api/admin/commerce/manual-refunds/complete."}, "domain_title": "Commerce Refunds MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "example_params": {"buyer_project_id": 123, "buyer_user_id": 123, "external_refund_id": "example_string", "order_id": "example_string"}, "genetic_tags": ["core.commerce.marketplace.gen1"], "inputSchema": {"properties": {"buyer_project_id": {"description": "", "type": "integer"}, "buyer_user_id": {"description": "", "type": "integer"}, "external_refund_id": {"description": "", "type": "string"}, "order_id": {"description": "", "type": "string"}}, "required": ["buyer_project_id", "buyer_user_id", "order_id"], "type": "object"}, "instruction_hint": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. M…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_refunds", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revoked_entitlements": {"description": "array", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "rollback": [], "safe_action": "commerce_refund_manual_complete", "summary": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. Mirrors POST /api/admin/commerce/manual-refunds/complete.", "title": "Commerce Refund Manual Complete", "verification": ["commerce.refund.status", "commerce.refund.manual_list"], "verify": [{"action": "commerce.refund.status", "predicate": "named resource is visible"}, {"action": "commerce.refund.manual_list", "predicate": "named resource is visible"}], "when_to_use": "Ecosystem admin: mark fiat/manual refund compensated — revoke entitlements, set order refunded. Mirrors POST /api/admin/commerce/manual-refunds/complete.", "write_mode": null}, {"action": "commerce.storefront.list", "capability_descriptor": {"complexity": "intermediate", "domain": "general", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.list", "source": "overlay", "title": "Commerce Storefront List", "when_to_use": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/storefront/listings."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/stor…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "integer", "type": "any"}, "facet_counts": {"description": "object", "type": "any"}, "index_version": {"description": "integer", "type": "any"}, "listings": {"description": "list", "type": "any"}, "ready": {"description": "boolean", "type": "any"}, "total": {"description": "integer", "type": "any"}, "warming": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_list", "summary": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/storefront/listings.", "title": "Commerce Storefront List", "when_to_use": "List storefront listings via StorefrontReadFacade (ECS organelle). Mirrors GET /api/commerce/storefront/listings.", "write_mode": null}, {"action": "commerce.storefront.health", "capability_descriptor": {"complexity": "intermediate", "domain": "general", "genetic_tags": ["core.mcp.commerce.gen1"], "id": "commerce.storefront.health", "source": "overlay", "title": "Commerce Storefront Health", "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice)."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Storefront index + ECS organelle health (admin diagnostics slice).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ecs_global_count": {"description": "integer", "type": "any"}, "ecs_global_initialized": {"description": "boolean", "type": "any"}, "ecs_has_data": {"description": "boolean", "type": "any"}, "index_version": {"description": "integer", "type": "any"}, "read_model": {"description": "string", "type": "any"}, "ready": {"description": "boolean", "type": "any"}, "row_count": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_health", "summary": "Storefront index + ECS organelle health (admin diagnostics slice).", "title": "Commerce Storefront Health", "when_to_use": "Storefront index + ECS organelle health (admin diagnostics slice).", "write_mode": null}, {"action": "commerce.reconcile", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.reconcile", "source": "overlay", "title": "Commerce Reconcile", "when_to_use": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"project_id\": 1}"}, "domain_title": "Commerce Ai MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"pro…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_ai", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_reconcile", "summary": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"project_id\": 1}", "title": "Commerce Reconcile", "when_to_use": "Ops: find marketplace deals stuck after confirm without transfer. Example: {\"dry_run\": true, \"project_id\": 1}", "write_mode": null}, {"action": "commerce.sell.activate", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.sell.gen1"], "id": "commerce.sell.activate", "mutation_risk": "high", "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "source": "handler", "title": "Commerce Sell Activate", "when_to_use": "One-shot seller onboarding: wallet, seed listing, optional hosted vitrine."}, "domain_title": "Sell MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "inputSchema": {"properties": {"ai_prompt": {"description": "Natural language product description for AI seed", "type": "string"}, "bucket_name": {"description": "Hosted bucket slug (first publish only)", "type": "string"}, "idempotency_key": {"description": "Idempotent activation key", "type": "string"}, "products": {"description": "ProductSpec rows to seed (optional if re-activating)", "type": "array"}, "project_id": {"description": "Seller project id", "type": "integer"}, "publish_hosted": {"description": "Publish hosted vitrine after activation", "type": "boolean"}, "storefront_public": {"description": "Set storefront policy public (default true)", "type": "boolean"}, "use_ai": {"description": "Generate products from ai_prompt before seeding", "type": "boolean"}, "use_starter": {"description": "Seed starter product when catalog empty", "type": "boolean"}, "user_id": {"description": "Acting user id", "type": "integer"}}, "required": ["project_id", "user_id"], "type": "object"}, "instruction_hint": "One-shot seller onboarding: wallet, seed listing, optional hosted vitrine.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.sell", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activation": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "payments.create", "assets.create"], "required_cap": "payments|project_admin", "safe_action": "commerce_sell_activate", "summary": "One-shot seller activation: earnings wallet, product seed, public policy, storefront index upsert, optional hosted vitrine. Mirrors POST /api/commerce/sell/activate.", "title": "Commerce Sell Activate", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier"], "when_to_use": "One-shot seller onboarding: wallet, seed listing, optional hosted vitrine.", "write_mode": null}, {"action": "commerce.storefront.seed_plan", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_plan", "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "source": "overlay", "title": "Commerce Storefront Seed Plan", "when_to_use": "Preview seed diff before seed_apply."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Preview seed diff before seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"plan": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.seed_apply", "commerce.storefront.seed_undo"], "required_cap": "payments", "safe_action": "commerce_storefront_seed_plan", "summary": "Dry-run Storefront Studio seed — compose asset/listing drafts and guidance hints. Mirrors POST /api/commerce/storefront/seed/plan.", "title": "Commerce Storefront Seed Plan", "when_to_use": "Preview seed diff before seed_apply.", "write_mode": null}, {"action": "commerce.storefront.seed_apply", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_apply", "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "source": "overlay", "title": "Commerce Storefront Seed Apply", "when_to_use": "Apply storefront seed plan to 8DNA catalog (bulk, reversible)."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Apply storefront seed plan to 8DNA catalog (bulk, reversible).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "related_tools": ["commerce.storefront.hosted_publish", "commerce.storefront.hosted_manifest"], "required_cap": "payments", "safe_action": "commerce_storefront_seed_apply", "summary": "Apply a Storefront Studio seed plan (asset upsert → listing → index). Mirrors POST /api/commerce/storefront/seed/apply.", "title": "Commerce Storefront Seed Apply", "when_to_use": "Apply storefront seed plan to 8DNA catalog (bulk, reversible).", "write_mode": null}, {"action": "commerce.storefront.seed_undo", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_undo", "source": "overlay", "title": "Commerce Storefront Seed Undo", "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/comme…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_seed_undo", "summary": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "title": "Commerce Storefront Seed Undo", "when_to_use": "Undo a prior seed run — cancel listings and remove from storefront index. Mirrors POST /api/commerce/storefront/seed/undo.", "write_mode": null}, {"action": "commerce.storefront.seed_ingest", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.seed_ingest", "source": "overlay", "title": "Commerce Storefront Seed Ingest", "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commer…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int", "type": "any"}, "specs": {"description": "array", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_seed_ingest", "summary": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "title": "Commerce Storefront Seed Ingest", "when_to_use": "Parse bulk source (csv/json/ai_batch/magic/clone) into ProductSpec rows. Mirrors POST /api/commerce/storefront/seed/ingest.", "write_mode": null}, {"action": "commerce.storefront.one_click_fill", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.one_click_fill", "source": "overlay", "title": "Commerce Storefront One Click Fill", "when_to_use": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/storefront/seed/one-click-fill."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/s…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"filled_count": {"description": "int", "type": "any"}, "result": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_one_click_fill", "summary": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/storefront/seed/one-click-fill.", "title": "Commerce Storefront One Click Fill", "when_to_use": "Create listings for eligible catalog assets without active listings. Mirrors POST /api/commerce/storefront/seed/one-click-fill.", "write_mode": null}, {"action": "commerce.storefront.hosted_manifest", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_manifest", "source": "overlay", "title": "Commerce Storefront Hosted Manifest", "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/sto…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"manifest": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_hosted_manifest", "summary": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "title": "Commerce Storefront Hosted Manifest", "when_to_use": "Read hosted vitrine manifest (bucket, hosted_dirty, merchandising). Mirrors GET /api/commerce/storefront/hosted/manifest.", "write_mode": null}, {"action": "commerce.storefront.hosted_publish", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.commerce.marketplace.gen1"], "id": "commerce.storefront.hosted_publish", "source": "overlay", "title": "Commerce Storefront Hosted Publish", "when_to_use": "Publish hosted /s/ vitrine from storefront index."}, "domain_title": "Commerce Storefront MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "genetic_tags": ["core.commerce.marketplace.gen1"], "instruction_hint": "Publish hosted /s/ vitrine from storefront index.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.commerce_storefront", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"artifact_published": {"description": "bool", "type": "any"}, "artifact_warning": {"description": "string", "type": "any"}, "public_url": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.commerce.marketplace.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront"], "required_cap": "payments", "safe_action": "commerce_storefront_hosted_publish", "summary": "Publish hosted vitrine static bundle + tenant boot JSON when dist is on server. Mirrors POST /api/commerce/storefront/hosted/publish.", "title": "Commerce Storefront Hosted Publish", "when_to_use": "Publish hosted /s/ vitrine from storefront index.", "write_mode": null}], "commerce_rest": [{"action": "rest.marketplace.create_listing", "mcp_executable": false, "path": "POST /api/marketplace/listings", "safe_action": "rest_marketplace_create_listing", "summary": "Create listing (types: sale, buy, exchange, auction). Not an MCP action.", "surface": "rest"}, {"action": "rest.marketplace.list_listings", "mcp_executable": false, "path": "GET /api/marketplace/listings", "safe_action": "rest_marketplace_list_listings", "summary": "List marketplace listings with filters.", "surface": "rest"}, {"action": "rest.marketplace.place_bid", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/bids", "safe_action": "rest_marketplace_place_bid", "summary": "Place bid on auction listing.", "surface": "rest"}, {"action": "rest.marketplace.accept_listing", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/accept", "safe_action": "rest_marketplace_accept_listing", "summary": "Accept deal / settle listing (may trigger internal payment flow).", "surface": "rest"}, {"action": "rest.marketplace.close_auction", "mcp_executable": false, "path": "POST /api/marketplace/listings/{listing_id}/close-auction", "safe_action": "rest_marketplace_close_auction", "summary": "Close auction listing.", "surface": "rest"}, {"action": "rest.commerce.merchant.dashboard", "mcp_executable": false, "path": "GET /api/commerce/merchant/dashboard", "safe_action": "rest_commerce_merchant_dashboard", "summary": "Seller Command Center KPIs and recommended actions.", "surface": "rest"}, {"action": "rest.commerce.merchant.list_listings", "mcp_executable": false, "path": "GET /api/commerce/merchant/listings", "safe_action": "rest_commerce_merchant_list_listings", "summary": "Admin listings table for seller project (all statuses).", "surface": "rest"}, {"action": "rest.commerce.merchant.incoming_orders", "mcp_executable": false, "path": "GET /api/commerce/merchant/orders-incoming", "safe_action": "rest_commerce_merchant_incoming_orders", "summary": "Incoming sales for seller project.", "surface": "rest"}, {"action": "rest.commerce.merchant.update_listing", "mcp_executable": false, "path": "PUT /api/commerce/merchant/listings/{listing_uuid}", "safe_action": "rest_commerce_merchant_update_listing", "summary": "Update listing status or price (seller admin).", "surface": "rest"}, {"action": "rest.commerce.merchant.sync_price", "mcp_executable": false, "path": "POST /api/commerce/merchant/listings/{listing_uuid}/sync-price", "safe_action": "rest_commerce_merchant_sync_price", "summary": "Sync listing price from catalog asset.", "surface": "rest"}, {"action": "rest.commerce.merchant.reindex", "mcp_executable": false, "path": "POST /api/commerce/merchant/listings/{listing_uuid}/reindex", "safe_action": "rest_commerce_merchant_reindex", "summary": "Rebuild shop index row for one listing.", "surface": "rest"}, {"action": "rest.commerce.merchant.bulk_sync_prices", "mcp_executable": false, "path": "POST /api/commerce/merchant/listings/bulk-sync-prices", "safe_action": "rest_commerce_merchant_bulk_sync_prices", "summary": "Sync all stale listing prices for project.", "surface": "rest"}, {"action": "rest.commerce.merchant.bulk_deactivate", "mcp_executable": false, "path": "POST /api/commerce/merchant/listings/bulk-deactivate", "safe_action": "rest_commerce_merchant_bulk_deactivate", "summary": "Deactivate multiple listings.", "surface": "rest"}, {"action": "rest.commerce.guidance.checklist", "mcp_executable": false, "path": "GET /api/commerce/guidance/checklist", "safe_action": "rest_commerce_guidance_checklist", "summary": "Operator shop setup checklist (catalog + shelf).", "surface": "rest"}, {"action": "rest.commerce.guidance.catalog_hints", "mcp_executable": false, "path": "GET /api/commerce/guidance/catalog-hints", "safe_action": "rest_commerce_guidance_catalog_hints", "summary": "Per-asset listing eligibility and stale price hints.", "surface": "rest"}, {"action": "rest.commerce.guidance.listing_draft", "mcp_executable": false, "path": "GET /api/commerce/guidance/listing-draft", "safe_action": "rest_commerce_guidance_listing_draft", "summary": "Suggested listing draft defaults for one asset.", "surface": "rest"}, {"action": "rest.commerce.participant.holdings", "mcp_executable": false, "path": "GET /api/commerce/participant/holdings", "safe_action": "rest_commerce_participant_holdings", "summary": "User holdings in a project (participant plane, not catalog).", "surface": "rest"}, {"action": "rest.commerce.participant.grant_holding", "mcp_executable": false, "path": "POST /api/commerce/participant/grant-holding", "safe_action": "rest_commerce_participant_grant_holding", "summary": "Operator grant inventory to project member (requires write).", "surface": "rest"}, {"action": "rest.commerce.merchant.featured", "mcp_executable": false, "path": "GET|PUT /api/commerce/merchant/featured", "safe_action": "rest_commerce_merchant_featured", "summary": "Project featured listing UUIDs in 8DNA storefront config.", "surface": "rest"}, {"action": "rest.commerce.merchant.coupons", "mcp_executable": false, "path": "GET|POST /api/commerce/merchant/coupons", "safe_action": "rest_commerce_merchant_coupons", "summary": "List or create project promo codes (8DNA commerce.coupon_registry).", "surface": "rest"}, {"action": "rest.commerce.merchant.coupon_by_code", "mcp_executable": false, "path": "PUT|DELETE /api/commerce/merchant/coupons/{code}", "safe_action": "rest_commerce_merchant_coupon_by_code", "summary": "Update or delete a project promo code.", "surface": "rest"}, {"action": "rest.commerce.cart.apply_coupon", "mcp_executable": false, "path": "POST /api/commerce/cart/apply-coupon", "safe_action": "rest_commerce_cart_apply_coupon", "summary": "Apply or clear coupon on authenticated cart (listing scope enforced).", "surface": "rest"}, {"action": "rest.commerce.cart.checkout", "mcp_executable": false, "path": "POST /api/commerce/cart/checkout", "safe_action": "rest_commerce_cart_checkout", "summary": "Create checkout session from cart (wallet_internal or payments_fiat rail).", "surface": "rest"}, {"action": "rest.commerce.my_purchases", "mcp_executable": false, "path": "GET /api/commerce/my-purchases", "safe_action": "rest_commerce_my_purchases", "summary": "Buyer purchases BFF — orders merged with active entitlements and delivery URLs.", "surface": "rest"}, {"action": "rest.commerce.delivery.refresh", "mcp_executable": false, "path": "POST /api/commerce/delivery/refresh", "safe_action": "rest_commerce_delivery_refresh", "summary": "Re-issue signed delivery download token for a fulfilled order line.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_request", "mcp_executable": false, "path": "POST /api/commerce/orders/refund-request", "safe_action": "rest_commerce_orders_refund_request", "summary": "Request refund; wallet rail auto-compensates USDT. Fiat (payments_fiat) skips wallet credit — manual ops via admin manual-refunds.", "surface": "rest"}, {"action": "rest.commerce.orders.refund_status", "mcp_executable": false, "path": "GET /api/commerce/orders/{order_id}/refund-request", "safe_action": "rest_commerce_orders_refund_status", "summary": "Poll refund request status and compensation snapshot for an order.", "surface": "rest"}, {"action": "rest.commerce.events.refund_stream", "mcp_executable": false, "path": "GET /api/commerce/events/refund-stream", "safe_action": "rest_commerce_events_refund_stream", "summary": "SSE stream for refund lifecycle (commerce.refund.updated) — buyer/merchant cache refresh.", "surface": "rest"}, {"action": "rest.admin.commerce.refund_sse_health", "mcp_executable": false, "path": "GET /api/admin/commerce/refund-sse-health", "safe_action": "rest_admin_commerce_refund_sse_health", "summary": "Ops: in-process refund SSE subscriber counts on this worker (connection_count, pg_bus_enabled).", "surface": "rest"}, {"action": "rest.admin.commerce.metrics_scrape", "mcp_executable": false, "path": "GET /api/admin/commerce/metrics/scrape", "safe_action": "rest_admin_commerce_metrics_scrape", "summary": "Prometheus scrape for commerce funnel gauges (header X-Metrics-Token, env COMMERCE_METRICS_SCRAPE_TOKEN).", "surface": "rest"}, {"action": "rest.admin.commerce.settlement_funnel", "mcp_executable": false, "path": "GET /api/admin/commerce/settlement-funnel", "safe_action": "rest_admin_commerce_settlement_funnel", "summary": "Ops: stuck escrow scan + checkout funnel OpTrace + refund_sse_health snapshot.", "surface": "rest"}, {"action": "rest.exchange.quote", "mcp_executable": false, "path": "POST /api/exchange/quote", "safe_action": "rest_exchange_quote", "summary": "Cross-project exchange quote (not protein command_type exchange).", "surface": "rest"}, {"action": "rest.exchange.execute", "mcp_executable": false, "path": "POST /api/exchange/execute", "safe_action": "rest_exchange_execute", "summary": "Execute cross-project currency/asset exchange.", "surface": "rest"}, {"action": "rest.commerce.checkout.create_session", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions", "safe_action": "rest_commerce_checkout_create_session", "summary": "Create checkout session for listing or cart lines. Send Idempotency-Key header for safe retries.", "surface": "rest"}, {"action": "rest.commerce.checkout.confirm_session", "mcp_executable": false, "path": "POST /api/commerce/checkout/sessions/{session_id}/confirm", "safe_action": "rest_commerce_checkout_confirm_session", "summary": "Confirm checkout session (wallet_internal or payments_fiat rail). 402 insufficient_balance, 409 partial_failure — use Idempotency-Key.", "surface": "rest"}, {"action": "rest.commerce.checkout.get_session", "mcp_executable": false, "path": "GET /api/commerce/checkout/sessions/{session_id}", "safe_action": "rest_commerce_checkout_get_session", "summary": "Poll checkout session status until completed/failed/expired.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_list", "mcp_executable": false, "path": "GET /api/admin/commerce/manual-refunds", "safe_action": "rest_admin_commerce_manual_refunds_list", "summary": "Ops: list refund_requested orders awaiting manual compensation for a buyer slice.", "surface": "rest"}, {"action": "rest.admin.commerce.manual_refunds_complete", "mcp_executable": false, "path": "POST /api/admin/commerce/manual-refunds/complete", "safe_action": "rest_admin_commerce_manual_refunds_complete", "summary": "Ops: mark fiat/manual refund compensated — revoke entitlements, set order refunded.", "surface": "rest"}, {"action": "rest.commerce.reconcile_escrow", "mcp_executable": false, "path": "POST /api/admin/commerce/reconcile-escrow?dry_run=true", "safe_action": "rest_commerce_reconcile_escrow", "summary": "Ops: find deals confirmed without completed transfer (nightly gate).", "surface": "rest"}], "context": [{"action": "context.get", "capability_descriptor": {"complexity": "simple", "domain": "context", "genetic_tags": ["core.fabric.context_provider.gen1"], "id": "context.get", "source": "handler", "title": "Context Get", "when_to_use": "Prefetch RAG + memory context for a task."}, "domain_title": "Context Resolve MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.context_resolve.gen1"], "inputSchema": {"properties": {"collection_id": {"description": "Optional RAG collection scope", "type": "string"}, "memory_session_id": {"description": "Memory session for sources that include memory. Not an execute-context field.", "type": "string"}, "sources": {"description": "Context sources: rag, memory, crm, etc.", "type": "array"}, "task": {"description": "Natural-language task description for context prefetch", "type": "string"}, "token_budget": {"description": "Max tokens for bundled context", "type": "integer"}}, "required": ["task"], "type": "object"}, "instruction_hint": "Prefetch RAG + memory context for a task.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bundle": {"description": "ContextBundle with citations and snippets", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.context_resolve.gen1", "related_prompts": ["agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "context_get", "summary": "Prefetch RAG + memory context for a task.", "title": "Context Get", "when_to_use": "Prefetch RAG + memory context for a task.", "write_mode": null}, {"action": "context.resolve", "capability_descriptor": {"complexity": "intermediate", "domain": "context", "genetic_tags": ["core.mcp.context.gen1"], "id": "context.resolve", "related_tools": ["projects.get_projects", "auth.get_profile"], "source": "overlay", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous."}, "domain_title": "Context Resolve MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.context_resolve.gen1"], "instruction_hint": "After auth when context.project_id is missing or ambiguous.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.context_resolve", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.context_resolve.gen1", "related_prompts": ["agentstack_rag_memory_orchestrator"], "related_tools": ["projects.get_projects", "auth.get_profile"], "required_cap": "mcp_read", "safe_action": "context_resolve", "summary": "Resolve effective project_id for the session; surfaces ambiguous_project_context.", "title": "Context Resolve", "when_to_use": "After auth when context.project_id is missing or ambiguous.", "write_mode": null}], "crm": [{"action": "crm.list_contacts", "aliases": ["crm.contacts.list"], "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_contacts", "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "source": "handler", "title": "Crm List Contacts", "when_to_use": "List or search contacts before upsert, 360 view, or pipeline work."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "inputSchema": {"properties": {"lifecycle": {"description": "", "type": "string"}, "page": {"description": "", "type": "integer"}, "per_page": {"description": "", "type": "integer"}, "project_id": {"description": "", "type": "integer"}, "projection": {"default": "summary", "description": "summary=crm card_row; full=contact record", "enum": ["summary", "full"], "type": "string"}, "q": {"description": "", "type": "string"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "List or search contacts before upsert, 360 view, or pipeline work.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contacts": {"description": "list", "type": "any"}, "total": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.upsert_contact", "crm.search", "crm.get_contact_360"], "required_cap": "crm", "safe_action": "crm_list_contacts", "summary": "List CRM contacts for a project (paginated BFF).", "title": "List CRM Contacts", "when_to_use": "List or search contacts before upsert, 360 view, or pipeline work.", "write_mode": null}, {"action": "crm.upsert_contact", "aliases": ["crm.contacts.create"], "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.upsert_contact", "mutation_risk": "low", "related_tools": ["crm.list_contacts", "crm.create_deal", "crm.get_contact_360"], "source": "handler", "title": "Crm Upsert Contact", "when_blocked": {"duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update"}, "when_to_use": "Create or update a contact; dedupes by email within the project."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"contact": {}, "project_id": 123}, "genetic_tags": ["core.crm.hub.gen1"], "inputSchema": {"properties": {"contact": {"description": "CRM contact body (upsert by email within project)", "properties": {"company_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Company Id"}, "consent": {"additionalProperties": true, "title": "Consent", "type": "object"}, "custom": {"additionalProperties": true, "title": "Custom", "type": "object"}, "display_name": {"title": "Display Name", "type": "string"}, "emails": {"items": {"type": "string"}, "title": "Emails", "type": "array"}, "lifecycle": {"description": "Lead lifecycle stage.", "enum": ["lead", "mql", "sql", "customer", "churned"], "title": "ContactStage", "type": "string"}, "owner_user_id": {"anyOf": [{"type": "integer"}, {"type": "null"}], "default": null, "title": "Owner User Id"}, "phones": {"items": {"type": "string"}, "title": "Phones", "type": "array"}, "score": {"default": 0, "title": "Score", "type": "integer"}, "source": {"default": "manual", "title": "Source", "type": "string"}, "tags": {"items": {"type": "string"}, "title": "Tags", "type": "array"}}, "required": ["display_name"], "type": "object"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "contact"], "type": "object"}, "instruction_hint": "Create or update a contact; dedupes by email within the project.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contact": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.create_deal", "crm.get_contact_360"], "required_cap": "crm", "rollback": ["crm.erase_contact"], "safe_action": "crm_upsert_contact", "summary": "Create or update a CRM contact (dedupe by email).", "title": "Create or Update Contact", "verification": ["crm.get_contact_360"], "verify": [{"action": "crm.get_contact_360", "predicate": "named resource is visible"}], "when_blocked": {"duplicate_contact": "crm.list_contacts by email — merge via crm.merge_contacts or set external_id on update"}, "when_to_use": "Create or update a contact; dedupes by email within the project.", "write_mode": null}, {"action": "crm.create_deal", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_deal", "mutation_risk": "low", "related_tools": ["crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "source": "overlay", "title": "Crm Create Deal", "when_to_use": "Open a deal in the default pipeline after a contact exists."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"deal": {}, "project_id": 123}, "genetic_tags": ["core.crm.hub.gen1"], "inputSchema": {"properties": {"deal": {"description": "CRM deal body for default pipeline", "properties": {"amount": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Amount"}, "company_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Company Id"}, "contact_ids": {"items": {"type": "string"}, "title": "Contact Ids", "type": "array"}, "currency": {"default": "USDT", "title": "Currency", "type": "string"}, "custom": {"additionalProperties": true, "title": "Custom", "type": "object"}, "due_at": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Due At"}, "linked_checkout_session_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Linked Checkout Session Id"}, "linked_order_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Linked Order Id"}, "owner_user_id": {"anyOf": [{"type": "integer"}, {"type": "null"}], "default": null, "title": "Owner User Id"}, "pipeline_id": {"title": "Pipeline Id", "type": "string"}, "stage_id": {"title": "Stage Id", "type": "string"}, "tags": {"items": {"type": "string"}, "title": "Tags", "type": "array"}, "title": {"title": "Title", "type": "string"}}, "required": ["title", "pipeline_id", "stage_id"], "type": "object"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "deal"], "type": "object"}, "instruction_hint": "Open a deal in the default pipeline after a contact exists.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.move_deal_stage", "crm.list_board", "crm.get_deal_timeline"], "required_cap": "crm", "rollback": ["crm.delete_deal"], "safe_action": "crm_create_deal", "summary": "Create a CRM deal in the default pipeline.", "title": "Create CRM Deal", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "id"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_to_use": "Open a deal in the default pipeline after a contact exists.", "write_mode": null}, {"action": "crm.update_deal", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.update_deal", "mutation_risk": "low", "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "source": "overlay", "title": "Crm Update Deal", "when_blocked": {"pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes"}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Edit deal fields from hosted vertical or CRM drawer.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_deal", "crm.delete_deal", "crm.move_deal_stage"], "required_cap": "crm", "safe_action": "crm_update_deal", "summary": "Patch a CRM deal (title, amount, due_at, stage_id, contact_ids, custom).", "title": "Crm Update Deal", "when_blocked": {"pipeline_stage_locked": "crm.list_board + crm.get_crm_config — use crm.move_deal_stage for stage changes"}, "when_to_use": "Edit deal fields from hosted vertical or CRM drawer.", "write_mode": null}, {"action": "crm.delete_deal", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.delete_deal", "mutation_risk": "high", "related_tools": ["crm.update_deal", "crm.list_board"], "source": "overlay", "title": "Crm Delete Deal", "when_to_use": "Archive or cancel a project/deal from hosted vertical."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Archive or cancel a project/deal from hosted vertical.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal_id": {"description": "string", "type": "any"}, "deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.update_deal", "crm.list_board"], "required_cap": "crm", "safe_action": "crm_delete_deal", "summary": "Soft-delete (archive) a CRM deal.", "title": "Crm Delete Deal", "when_to_use": "Archive or cancel a project/deal from hosted vertical.", "write_mode": null}, {"action": "crm.move_deal_stage", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.move_deal_stage", "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity"], "source": "overlay", "title": "Crm Move Deal Stage", "when_to_use": "Advance or regress a deal on the kanban board."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"deal_id": "example_string", "expected_rev": 123, "project_id": 123, "stage_id": "example_string"}, "genetic_tags": ["core.crm.hub.gen1"], "inputSchema": {"properties": {"deal_id": {"description": "", "type": "string"}, "expected_rev": {"description": "", "type": "integer"}, "project_id": {"description": "", "type": "integer"}, "stage_id": {"description": "", "type": "string"}}, "required": ["project_id", "deal_id", "stage_id"], "type": "object"}, "instruction_hint": "Advance or regress a deal on the kanban board.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_board", "crm.get_deal_timeline", "crm.log_activity"], "required_cap": "crm", "rollback": [], "safe_action": "crm_move_deal_stage", "summary": "Move a deal to another pipeline stage.", "title": "Crm Move Deal Stage", "verification": ["crm.list_board", "crm.get_deal_timeline"], "verify": [{"action": "crm.list_board", "predicate": "named resource is visible"}, {"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_to_use": "Advance or regress a deal on the kanban board.", "write_mode": null}, {"action": "crm.log_activity", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.log_activity", "source": "overlay", "title": "Crm Log Activity", "when_to_use": "Log a CRM activity (note, call, task, etc.)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"activity": {}, "project_id": 123}, "genetic_tags": ["core.crm.hub.gen1"], "inputSchema": {"properties": {"activity": {"description": "Activity payload (id optional — auto-generated)", "properties": {"assignee_user_id": {"anyOf": [{"type": "integer"}, {"type": "null"}], "default": null, "title": "Assignee User Id"}, "body": {"default": "", "title": "Body", "type": "string"}, "channel_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Channel Id"}, "contact_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Contact Id"}, "deal_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Deal Id"}, "due_at": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Due At"}, "hlc": {"anyOf": [{"type": "integer"}, {"type": "null"}], "default": null, "title": "Hlc"}, "kind": {"default": "note", "enum": ["call", "email", "meeting", "note", "task", "stage_change"], "title": "Kind", "type": "string"}, "order_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Order Id"}, "status": {"default": "logged", "enum": ["logged", "open", "done"], "title": "Status", "type": "string"}}, "type": "object"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "activity"], "type": "object"}, "instruction_hint": "Log a CRM activity (note, call, task, etc.).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activity": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "rollback": [], "safe_action": "crm_log_activity", "summary": "Log a CRM activity (note, call, task, etc.).", "title": "Crm Log Activity", "verification": ["crm.get_deal_timeline"], "verify": [{"action": "crm.get_deal_timeline", "predicate": "named resource is visible"}], "when_to_use": "Log a CRM activity (note, call, task, etc.).", "write_mode": null}, {"action": "crm.search", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.search", "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "source": "overlay", "title": "Crm Search", "when_to_use": "Cross-entity CRM search when you do not know the contact id."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Cross-entity CRM search when you do not know the contact id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"results": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.list_contacts", "crm.get_contact_360"], "required_cap": "crm", "safe_action": "crm_search", "summary": "Search CRM contacts by query string.", "title": "Crm Search", "when_to_use": "Cross-entity CRM search when you do not know the contact id.", "write_mode": null}, {"action": "crm.create_company", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.create_company", "mutation_risk": "low", "source": "overlay", "title": "Crm Create Company", "when_to_use": "Create a CRM company for a project."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Create a CRM company for a project.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"company": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_create_company", "summary": "Create a CRM company for a project.", "title": "Crm Create Company", "when_to_use": "Create a CRM company for a project.", "write_mode": null}, {"action": "crm.list_companies", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_companies", "related_tools": ["crm.create_company", "crm.list_contacts"], "source": "overlay", "title": "Crm List Companies", "when_to_use": "List companies before linking contacts or deals to an account."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "List companies before linking contacts or deals to an account.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"companies": {"description": "list", "type": "any"}, "total": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.create_company", "crm.list_contacts"], "required_cap": "crm", "safe_action": "crm_list_companies", "summary": "List CRM companies for a project.", "title": "Crm List Companies", "when_to_use": "List companies before linking contacts or deals to an account.", "write_mode": null}, {"action": "crm.get_contact_360", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_contact_360", "source": "overlay", "title": "Crm Get Contact 360", "when_to_use": "Full contact timeline — use after list_contacts identifies the row."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Full contact timeline — use after list_contacts identifies the row.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contact": {"description": "object", "type": "any"}, "timeline": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_get_contact_360", "summary": "Contact 360 view: profile, deals, unified timeline.", "title": "Crm Get Contact 360", "when_to_use": "Full contact timeline — use after list_contacts identifies the row.", "write_mode": null}, {"action": "crm.magic_fill", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.magic_fill", "source": "overlay", "title": "Crm Magic Fill", "when_to_use": "AI/heuristic autofill for quick-create (dry-run, no write)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "AI/heuristic autofill for quick-create (dry-run, no write).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"answers": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_magic_fill", "summary": "AI/heuristic autofill for quick-create (dry-run, no write).", "title": "Crm Magic Fill", "when_to_use": "AI/heuristic autofill for quick-create (dry-run, no write).", "write_mode": null}, {"action": "crm.suggest_field", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.suggest_field", "source": "overlay", "title": "Crm Suggest Field", "when_to_use": "Suggest values for a CRM field from partial context."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Suggest values for a CRM field from partial context.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"suggestions": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_suggest_field", "summary": "Suggest values for a CRM field from partial context.", "title": "Crm Suggest Field", "when_to_use": "Suggest values for a CRM field from partial context.", "write_mode": null}, {"action": "crm.import_contacts", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.import_contacts", "mutation_risk": "low", "source": "overlay", "title": "Crm Import Contacts", "when_blocked": {"import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry"}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"created": {"description": "integer", "type": "any"}, "updated": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_import_contacts", "summary": "Batch import CRM contacts with email dedupe.", "title": "Crm Import Contacts", "when_blocked": {"import_blocked": "crm.list_contacts to preview dupes — shrink batch or crm.merge_contacts before retry"}, "when_to_use": "Bulk CSV import — prefer dry-run limits in UI; MCP for scripted ingest.", "write_mode": null}, {"action": "crm.export_contact", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.export_contact", "source": "overlay", "title": "Crm Export Contact", "when_to_use": "Export GDPR bundle for a CRM contact."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Export GDPR bundle for a CRM contact.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bundle": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_export_contact", "summary": "Export GDPR bundle for a CRM contact.", "title": "Crm Export Contact", "when_to_use": "Export GDPR bundle for a CRM contact.", "write_mode": null}, {"action": "crm.erase_contact", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.erase_contact", "mutation_risk": "high", "source": "overlay", "title": "Crm Erase Contact", "when_to_use": "Anonymize/erase a CRM contact (GDPR)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Anonymize/erase a CRM contact (GDPR).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"erased": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_erase_contact", "summary": "Anonymize/erase a CRM contact (GDPR).", "title": "Crm Erase Contact", "when_to_use": "Anonymize/erase a CRM contact (GDPR).", "write_mode": null}, {"action": "crm.list_board", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.list_board", "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "source": "overlay", "title": "Crm List Board", "when_to_use": "Kanban pipeline overview — use projection=summary before move_deal_stage."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Kanban pipeline overview — use projection=summary before move_deal_stage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"columns": {"description": "list", "type": "any"}, "pipeline": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "related_tools": ["crm.move_deal_stage", "crm.create_deal", "crm.get_deal_timeline"], "required_cap": "crm", "safe_action": "crm_list_board", "summary": "Pipeline kanban board with stage columns and deals.", "title": "View CRM Pipeline", "when_to_use": "Kanban pipeline overview — use projection=summary before move_deal_stage.", "write_mode": null}, {"action": "crm.get_deal_timeline", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_deal_timeline", "source": "overlay", "title": "Crm Get Deal Timeline", "when_to_use": "Activity timeline for a CRM deal (notes, tasks linked to deal_id)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Activity timeline for a CRM deal (notes, tasks linked to deal_id).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deal_id": {"description": "string", "type": "any"}, "timeline": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_get_deal_timeline", "summary": "Activity timeline for a CRM deal (notes, tasks linked to deal_id).", "title": "Crm Get Deal Timeline", "when_to_use": "Activity timeline for a CRM deal (notes, tasks linked to deal_id).", "write_mode": null}, {"action": "crm.get_crm_config", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.get_crm_config", "source": "overlay", "title": "Crm Get Crm Config", "when_to_use": "Project CRM config (saved_views, settings blob)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Project CRM config (saved_views, settings blob).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_get_crm_config", "summary": "Project CRM config (saved_views, settings blob).", "title": "Crm Get Crm Config", "when_to_use": "Project CRM config (saved_views, settings blob).", "write_mode": null}, {"action": "crm.patch_crm_config", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.patch_crm_config", "mutation_risk": "low", "source": "overlay", "title": "Crm Patch Crm Config", "when_to_use": "Patch project CRM config (writers may update saved_views only)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Patch project CRM config (writers may update saved_views only).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_patch_crm_config", "summary": "Patch project CRM config (writers may update saved_views only).", "title": "Crm Patch Crm Config", "when_to_use": "Patch project CRM config (writers may update saved_views only).", "write_mode": null}, {"action": "crm.merge_contacts", "capability_descriptor": {"complexity": "intermediate", "domain": "crm", "genetic_tags": ["core.crm.hub.gen1"], "id": "crm.merge_contacts", "mutation_risk": "low", "source": "overlay", "title": "Crm Merge Contacts", "when_to_use": "Merge duplicate contact into primary (absorb duplicate)."}, "domain_title": "Crm MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.crm.hub.gen1"], "instruction_hint": "Merge duplicate contact into primary (absorb duplicate).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.crm", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"contact": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.crm.hub.gen1", "related_prompts": ["agentstack_crm_workspace"], "required_cap": "crm", "safe_action": "crm_merge_contacts", "summary": "Merge duplicate contact into primary (absorb duplicate).", "title": "Crm Merge Contacts", "when_to_use": "Merge duplicate contact into primary (absorb duplicate).", "write_mode": null}], "data_access": [{"action": "data_access.set_policy", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1", "core.fabric.capability_descriptor.gen1"], "id": "data_access.set_policy", "mutation_risk": "low", "source": "handler", "title": "Data Access Set Policy", "when_to_use": "Create or update the field-level access policy for a project resource."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "access_control", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "inputSchema": {"properties": {"default_access": {"default": "deny", "description": "Global fallback when no rule matches any field ('deny' or 'public')", "type": "string"}, "globals": {"description": "Optional project FAP globals: nested_path_mode ('flat'|'dotted'), max_mask_depth. If omitted, existing globals are preserved.", "type": "object"}, "project_id": {"description": "Project ID", "type": "integer"}, "resource": {"description": "Resource key (e.g., 'orders', 'products')", "type": "string"}, "resource_policy": {"description": "Field → descriptor. Or pass resources: {name: {fields, default_access}}.", "type": "object"}, "resources": {"description": "Map of resource name → {default_access, fields}. rule allow is authenticated. allow_if stores a string condition only; an object condition is deny.", "type": "object"}}, "required": ["project_id", "resource"], "type": "object"}, "instruction_hint": "Create or update the field-level access policy for a project resource.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "Updated full policy dict", "type": "any"}, "resource": {"description": "Resource key that was updated", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "data_access_admin", "safe_action": "data_access_set_policy", "summary": "Create or update the field-level access policy for a project resource.", "title": "Data Access Set Policy", "tool_chains": ["content_access_control"], "when_to_use": "Create or update the field-level access policy for a project resource.", "write_mode": null}, {"action": "data_access.get_policy", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_policy", "source": "overlay", "title": "Data Access Get Policy", "when_to_use": "Retrieve the current field-level access policy for a project."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Retrieve the current field-level access policy for a project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "Full policy dict or single-resource policy", "type": "any"}, "resource": {"description": "Resource key (only when resource param is used)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "mcp_read", "safe_action": "data_access_get_policy", "summary": "Retrieve the current field-level access policy for a project.", "title": "Data Access Get Policy", "when_to_use": "Retrieve the current field-level access policy for a project.", "write_mode": null}, {"action": "data_access.check_field", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.check_field", "source": "overlay", "title": "Data Access Check Field", "when_to_use": "Check whether a specific role can read/write a field in a resource."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Check whether a specific role can read/write a field in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"allowed": {"description": "Boolean — True if access is granted", "type": "any"}, "field_path": {"description": "The checked path", "type": "any"}, "permission": {"description": "The checked permission", "type": "any"}, "user_role": {"description": "The role that was tested", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "mcp_read", "safe_action": "data_access_check_field", "summary": "Check whether a specific role can read/write a field in a resource.", "title": "Data Access Check Field", "when_to_use": "Check whether a specific role can read/write a field in a resource.", "write_mode": null}, {"action": "data_access.test_mask", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.test_mask", "source": "overlay", "title": "Data Access Test Mask", "when_to_use": "Preview what fields a given role can read/write in a resource."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Preview what fields a given role can read/write in a resource.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"preview": {"description": "Per-field access map", "type": "any"}, "resource": {"description": "Resource key", "type": "any"}, "user_role": {"description": "Tested role", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "mcp_read", "safe_action": "data_access_test_mask", "summary": "Preview what fields a given role can read/write in a resource.", "title": "Data Access Test Mask", "when_to_use": "Preview what fields a given role can read/write in a resource.", "write_mode": null}, {"action": "data_access.get_defaults_template", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_defaults_template", "source": "overlay", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources)."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_def…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"template": {"description": "default_access, globals, resources", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "mcp_read", "safe_action": "data_access_get_defaults_template", "summary": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "title": "Data Access Get Defaults Template", "when_to_use": "Read the global Field Access Policy template from ecosystem project DNA (`config.field_access_defaults`: default_access, globals, resources).", "write_mode": null}, {"action": "data_access.set_defaults_template", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_defaults_template", "mutation_risk": "low", "source": "overlay", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling)."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Write the global FAP template on ecosystem project (admin tooling).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"template": {"description": "Saved template", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "data_access_admin", "safe_action": "data_access_set_defaults_template", "summary": "Write the global FAP template on ecosystem project (admin tooling).", "title": "Data Access Set Defaults Template", "when_to_use": "Write the global FAP template on ecosystem project (admin tooling).", "write_mode": null}, {"action": "data_access.apply_defaults_template", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.apply_defaults_template", "mutation_risk": "low", "source": "overlay", "title": "Data Access Apply Defaults Template", "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"added_resources": {"description": "List of resource keys added", "type": "any"}, "policy": {"description": "Full updated FAP for target project", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "data_access_admin", "safe_action": "data_access_apply_defaults_template", "summary": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "title": "Data Access Apply Defaults Template", "tool_chains": ["project_bootstrap", "multi_tenant_onboarding"], "when_to_use": "Copy missing `resources.<name>` entries from the global template into `target_project_id`'s field_access_policy. Does not overwrite existing keys. Cannot target ecosystem project id=1.", "write_mode": null}, {"action": "data_access.get_triggers", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.get_triggers", "source": "overlay", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers``). Keyed by resource → pattern → list of trigger definitions. See FIELD_ACCESS_POLICY.md — Field Trig"}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"field_triggers": {"description": "Map resource → { pattern: [trigger, …] }", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "mcp_read", "safe_action": "data_access_get_triggers", "summary": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers``). Keyed by resource → pattern → list of trigger definitions. See FIELD_ACCESS_POLICY.md — Field Trig", "title": "Data Access Get Triggers", "when_to_use": "Read FAP v1.2 ``field_triggers`` for a project (same JSON as ``field_access_policy.field_triggers``). Keyed by resource → pattern → list of trigger definitions. See FIELD_ACCESS_POLICY.md — Field Trig", "write_mode": null}, {"action": "data_access.set_triggers", "capability_descriptor": {"complexity": "intermediate", "domain": "data_access", "genetic_tags": ["core.mcp.data_access.gen1"], "id": "data_access.set_triggers", "mutation_risk": "low", "source": "overlay", "title": "Data Access Set Triggers", "when_to_use": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def, …]`` (patterns like ``status``, ``config.**``, ``*``)."}, "domain_title": "Data Access MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.data_access.gen1"], "instruction_hint": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def,…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.data_access", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "Full field_access_policy after save", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.data_access.gen1", "required_cap": "data_access_admin", "safe_action": "data_access_set_triggers", "summary": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def, …]`` (patterns like ``status``, ``config.**``, ``*``).", "title": "Data Access Set Triggers", "when_to_use": "Upsert ``field_triggers`` for one resource. **triggers** is a map ``field_pattern → [trigger_def, …]`` (patterns like ``status``, ``config.**``, ``*``).", "write_mode": null}], "diagnostics": [{"action": "diagnostics.neural_graph", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.neural_graph", "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "source": "overlay", "title": "Diagnostics Neural Graph", "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object (includes heat_meta with configured_workers / multi_worker_likely on every response)", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["admin.data.health", "organelle.execute", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "safe_action": "diagnostics_neural_graph", "summary": "Neural Visualizer Gen2 snapshot: topology, heat planes (protein/api/dna_query/gene), composition edges, hot_region_hints. Always includes heat_meta (worker layout honesty). Process-local heat; Tier F ", "title": "Diagnostics Neural Graph", "when_to_use": "Robot/operator inspect live neural topology + hot paths without opening the SPA.", "write_mode": null}, {"action": "diagnostics.promote_hot_gene", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.promote_hot_gene", "related_tools": ["diagnostics.neural_graph"], "source": "overlay", "title": "Diagnostics Promote Hot Gene", "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["diagnostics.neural_graph"], "required_cap": "admin.write", "safe_action": "diagnostics_promote_hot_gene", "summary": "Promote a genetic tag's path prefixes into HotProteinRegion for an entity. Modes: warm, pin, prefetch_only. Tier F materialize blocked.", "title": "Diagnostics Promote Hot Gene", "when_to_use": "Operator pins hot gene paths after reviewing Neural Visualizer gene plane.", "write_mode": null}, {"action": "diagnostics.gene_token_query", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.gene_token_query", "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "source": "overlay", "title": "Diagnostics Gene Token Query", "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query."}, "domain_title": "Admin Data MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.admin_data.gen1"], "instruction_hint": "Admin debug: find hot protein bindings by genetic token AND query.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.admin_data", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.admin_data.gen1", "related_tools": ["diagnostics.neural_graph", "diagnostics.promote_hot_gene"], "required_cap": "admin.read", "safe_action": "diagnostics_gene_token_query", "summary": "GTPI bool query against process-local gene token lexicon.", "title": "Diagnostics Gene Token Query", "when_to_use": "Admin debug: find hot protein bindings by genetic token AND query.", "write_mode": null}, {"action": "diagnostics.consistency.scan", "capability_descriptor": {"complexity": "intermediate", "domain": "diagnostics", "genetic_tags": ["core.mcp.diagnostics.gen1"], "id": "diagnostics.consistency.scan", "source": "overlay", "title": "Diagnostics Consistency Scan", "when_blocked": {"missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_when": ["params.sync_plan=true"]}, "domain_title": "Diagnostics MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "conditional_mutate": "params.sync_plan=true", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.diagnostics.gen1"], "instruction_hint": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable f…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.diagnostics", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.diagnostics.gen1", "required_cap": "admin.read", "safe_action": "diagnostics_consistency_scan", "summary": "Scan integrity; set sync_plan=true to append findings as plan tasks (default read-only).", "title": "Diagnostics Consistency Scan", "when_blocked": {"missing_goal_facet": "agents.plan_propose mode=decompose_node — facet coverage incomplete on active goal", "provider_quota_exhausted": "buffs.get_effective_limits — wait/backoff; not a product bug", "work_graph_contradiction": "agents.work_next — recovery rank mismatch vs stale claims; follow next_action", "work_graph_stale_claims": "agents.plan_reclaim_stale then agents.plan_get — stale lease before plan_claim"}, "when_to_use": "Incident triage before promote or after list anomalies. Set sync_plan=true to ingest actionable findings as plan tasks.", "write_mode": null}], "discovery": [{"action": "discovery.get_platform_surfaces", "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.get_platform_surfaces", "source": "overlay", "title": "Discovery Get Platform Surfaces", "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Platform route inventory for Compass/docs — not tenant MCP.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_get_platform_surfaces", "summary": "List canonical platform routes from generated platform-surface-audit.json.", "title": "Discovery Get Platform Surfaces", "when_to_use": "Platform route inventory for Compass/docs — not tenant MCP.", "write_mode": null}, {"action": "discovery.list", "aliases": ["actions.list", "commerce.listings.list", "commerce_rest.listings.list", "discovery.actions", "discovery.catalog", "discovery.dynamic_tools", "discovery.get_dynamic_tools", "discovery.list_actions"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.list", "related_tools": ["discovery.get_platform_surfaces", "docs_nav.search"], "source": "overlay", "title": "Discovery List", "when_to_use": "Full MCP catalog alias — same as GET /mcp/actions."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Full MCP catalog alias — same as GET /mcp/actions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.get_platform_surfaces", "docs_nav.search"], "safe_action": "discovery_list", "summary": "List all MCP actions (alias for GET /mcp/actions catalog). Includes execute_budget (sync 60s / one heavy LLM step) and write_modes (merge|replace|append|delete — pass write_mode on collection/body wri", "title": "Discovery List", "when_to_use": "Full MCP catalog alias — same as GET /mcp/actions.", "write_mode": null}, {"action": "discovery.summary", "aliases": ["discovery.actions_summary"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.summary", "source": "overlay", "title": "Discovery Summary", "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without ful…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_summary", "summary": "Lightweight MCP catalog totals (alias for GET /mcp/actions/summary).", "title": "Discovery Summary", "when_to_use": "Optional read-only health check (recipe mcp_read_bootstrap) — catalog totals and etag without full catalog. Session bootstrap is mcp_session_setup, not this action.", "write_mode": null}, {"action": "discovery.status", "aliases": ["discovery.bootstrap"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.status", "related_tools": ["discovery.summary", "discovery.list", "discovery.search"], "source": "overlay", "title": "Discovery Status", "when_to_use": "Step 0 discovery ladder — before full catalog load."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Step 0 discovery ladder — before full catalog load.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.summary", "discovery.list", "discovery.search"], "safe_action": "discovery_status", "summary": "Registry status — version, catalog etag, action/domain/recipe totals.", "title": "Discovery Status", "when_to_use": "Step 0 discovery ladder — before full catalog load.", "write_mode": null}, {"action": "discovery.recipes", "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.recipes", "source": "overlay", "title": "Discovery Recipes", "when_to_use": "Pick a named recipe before agentstack.execute recipe_id."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Pick a named recipe before agentstack.execute recipe_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_recipes", "summary": "List onboarding MCP recipes (instruction plane SoT).", "title": "Discovery Recipes", "when_to_use": "Pick a named recipe before agentstack.execute recipe_id.", "write_mode": null}, {"action": "discovery.domain", "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.domain", "source": "overlay", "title": "Discovery Domain", "when_to_use": "Browse one domain without full catalog."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Browse one domain without full catalog.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_domain", "summary": "List actions in one catalog domain (wrapper over discovery.search).", "title": "Discovery Domain", "when_to_use": "Browse one domain without full catalog.", "write_mode": null}, {"action": "discovery.search", "aliases": ["discovery.search_actions"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.search", "source": "overlay", "title": "Discovery Search", "when_blocked": {"no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search"}, "when_to_use": "Find 3–20 actions by domain/intent without loading full catalog. When response_mode=workflow, follow actions[] order — primary_action may mirror step_actions[0]."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Find 3–20 actions by domain/intent without loading full catalog. When response_mode=workflow, fol…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_search", "summary": "Compact catalog search — returns ≤50 matching actions (not full discovery.list).", "title": "Discovery Search", "when_blocked": {"no_match": "Broaden q or use discovery.list domain= — no_match is not a missing product", "session_setup_required": "Run agentstack_session_setup — bind context.project_id before domain search"}, "when_to_use": "Find 3–20 actions by domain/intent without loading full catalog. When response_mode=workflow, follow actions[] order — primary_action may mirror step_actions[0].", "write_mode": null}, {"action": "discovery.describe", "aliases": ["agents.describe", "agents.describe_action", "agents.get_schema", "discovery.action", "discovery.action_info", "discovery.action_schema", "discovery.describe_action", "discovery.get", "discovery.get_action", "discovery.get_tool", "system.describe_tool"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.describe", "related_tools": ["discovery.search", "discovery.list", "discovery.status"], "source": "overlay", "title": "Discovery Describe", "when_blocked": {"action_required": "Pass params.action with the canonical tool name from discovery.search or GET /mcp/actions.", "invalid_parameters": "Required param action missing — pass action=<canonical MCP action id> (e.g. agents.plan_get).", "not_found": "Unknown action — discovery.search q=… then retry describe with the canonical name."}, "when_to_use": "Before mutation when inputSchema is missing from hot catalog. Pass action=<canonical id>."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "Before mutation when inputSchema is missing from hot catalog. Pass action=<canonical id>.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "related_tools": ["discovery.search", "discovery.list", "discovery.status"], "safe_action": "discovery_describe", "summary": "Full descriptor for one MCP action (schema + instruction_slice).", "title": "Discovery Describe", "when_blocked": {"action_required": "Pass params.action with the canonical tool name from discovery.search or GET /mcp/actions.", "invalid_parameters": "Required param action missing — pass action=<canonical MCP action id> (e.g. agents.plan_get).", "not_found": "Unknown action — discovery.search q=… then retry describe with the canonical name."}, "when_to_use": "Before mutation when inputSchema is missing from hot catalog. Pass action=<canonical id>.", "write_mode": null}, {"action": "discovery.job_status", "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "discovery.job_status", "source": "overlay", "title": "Discovery Job Status", "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed."}, "domain_title": "Discovery MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.discovery.gen1"], "instruction_hint": "After options.async execute returns job_id; poll until status is completed or failed.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.discovery", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.discovery.gen1", "related_prompts": ["agentstack_closed_loop_autonomy", "agentstack_inverse_orchestrator_playbook"], "safe_action": "discovery_job_status", "summary": "Poll an async agentstack.execute job (options.async=true). Cheap. Use after a multi-step heavy batch; do not re-run bots.simulate to check status.", "title": "Discovery Job Status", "when_to_use": "After options.async execute returns job_id; poll until status is completed or failed.", "write_mode": null}], "dna": [{"action": "dna.lineage.get_ancestors", "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_ancestors", "source": "overlay", "title": "Dna Lineage Get Ancestors", "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage."}, "domain_title": "Dna Lineage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "8DNA ancestor chain for sandbox/prod lineage triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"nodes": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.dna.lineage.gen1", "required_cap": "8dna.read", "safe_action": "dna_lineage_get_ancestors", "summary": "Walk ancestor chain for an 8DNA row (materialized path or scoped CTE fallback).", "title": "Dna Lineage Get Ancestors", "when_to_use": "8DNA ancestor chain for sandbox/prod lineage triage.", "write_mode": null}, {"action": "dna.lineage.get_descendants", "capability_descriptor": {"complexity": "intermediate", "domain": "dna", "genetic_tags": ["shared.dna.lineage.gen1"], "id": "dna.lineage.get_descendants", "source": "overlay", "title": "Dna Lineage Get Descendants", "when_to_use": "List child generations under parent UUID."}, "domain_title": "Dna Lineage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.dna.lineage.gen1"], "instruction_hint": "List child generations under parent UUID.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.dna_lineage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"nodes": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.dna.lineage.gen1", "required_cap": "8dna.read", "safe_action": "dna_lineage_get_descendants", "summary": "List descendant rows under a parent UUID within project scope.", "title": "Dna Lineage Get Descendants", "when_to_use": "List child generations under parent UUID.", "write_mode": null}], "docs_nav": [{"action": "docs_nav.resolve", "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.resolve", "source": "overlay", "title": "Docs Nav Resolve", "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing."}, "domain_title": "Docs Nav MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Resolve genetic tag to AI_INDEX path — not MCP tool routing.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"gene": {"description": "string|null", "type": "any"}, "indexes": {"description": "list", "type": "any"}, "tag": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "repo.engineering.ai_navigation.gen1", "safe_action": "docs_nav_resolve", "summary": "Resolve a genetic navigation tag to AI_INDEX path(s) from TAG_CATALOG. For code/docs navigation only — for runtime MCP tools use discover/by_intent.", "title": "Docs Nav Resolve", "when_to_use": "Resolve genetic tag to AI_INDEX path — not MCP tool routing.", "write_mode": null}, {"action": "docs_nav.search", "capability_descriptor": {"complexity": "intermediate", "domain": "docs", "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "id": "docs_nav.search", "source": "overlay", "title": "Docs Nav Search", "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions."}, "domain_title": "Docs Nav MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["repo.engineering.ai_navigation.gen1"], "instruction_hint": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.docs_nav", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"hits": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "repo.engineering.ai_navigation.gen1", "safe_action": "docs_nav_search", "summary": "BM25-lite search over AI navigation catalog (map/index triggers). Returns genetic tags + AI_INDEX paths. Not for selecting runtime MCP tools.", "title": "Docs Nav Search", "when_to_use": "Docs-nav BM25 only — runtime tools: discover/by_intent or /mcp/actions.", "write_mode": null}], "energy": [{"action": "energy.get_balance", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.get_balance", "source": "overlay", "title": "Energy Get Balance", "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs."}, "domain_title": "Energy MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.energy.gen1"], "instruction_hint": "LLM prepaid energy before heavy knowledge/agents runs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.energy.gen1", "required_cap": "mcp_read", "safe_action": "energy_get_balance", "summary": "LLM prepaid energy balance for user or project pool.", "title": "Energy Get Balance", "when_to_use": "LLM prepaid energy before heavy knowledge/agents runs.", "write_mode": null}, {"action": "energy.list_packs", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.list_packs", "source": "overlay", "title": "Energy List Packs", "when_to_use": "List purchasable energy packs and USD prices."}, "domain_title": "Energy MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.energy.gen1"], "instruction_hint": "List purchasable energy packs and USD prices.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.energy.gen1", "required_cap": "mcp_read", "safe_action": "energy_list_packs", "summary": "Available LLM energy pack tiers (small/medium/large) and USD prices.", "title": "Energy List Packs", "when_to_use": "List purchasable energy packs and USD prices.", "write_mode": null}, {"action": "energy.purchase", "capability_descriptor": {"complexity": "intermediate", "domain": "ai_builder", "genetic_tags": ["core.mcp.energy.gen1"], "id": "energy.purchase", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "source": "overlay", "title": "Energy Purchase", "when_to_use": "Buy LLM energy pack from wallet or quote for card."}, "domain_title": "Energy MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.energy.gen1"], "instruction_hint": "Buy LLM energy pack from wallet or quote for card.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.energy", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.energy.gen1", "related_tools": ["finance.pay.quote", "finance.pay.execute", "energy.list_packs"], "required_cap": "project_admin", "safe_action": "energy_purchase", "summary": "Purchase energy pack via unified finance.pay (wallet) or payments.create (card).", "title": "Energy Purchase", "when_to_use": "Buy LLM energy pack from wallet or quote for card.", "write_mode": null}], "finance": [{"action": "finance.portfolio", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.portfolio", "source": "overlay", "title": "Finance Portfolio", "when_to_use": "User finance hub aggregate (personal rails)."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "User finance hub aggregate (personal rails).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_portfolio", "summary": "User finance portfolio aggregate (three rails + JSON wallets).", "title": "Finance Portfolio", "when_to_use": "User finance hub aggregate (personal rails).", "write_mode": null}, {"action": "finance.activity", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.activity", "source": "overlay", "title": "Finance Activity", "when_to_use": "Unified wallet activity feed for user."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Unified wallet activity feed for user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_activity", "summary": "Unified wallet activity feed.", "title": "Finance Activity", "when_to_use": "Unified wallet activity feed for user.", "write_mode": null}, {"action": "finance.project.portfolio", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.portfolio", "source": "handler", "title": "Finance Project Portfolio", "when_to_use": "Project treasury + operating balances."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Project treasury + operating balances.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "payments|agentcoin", "safe_action": "finance_project_portfolio", "summary": "Project business portfolio (operating + treasury + AGNT).", "title": "Finance Project Portfolio", "when_to_use": "Project treasury + operating balances.", "write_mode": null}, {"action": "finance.dashboard_bundle", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.dashboard_bundle", "source": "overlay", "title": "Finance Dashboard Bundle", "when_to_use": "Finance landing KPI bundle for profile hub."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance landing KPI bundle for profile hub.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_dashboard_bundle", "summary": "Finance hub landing aggregate (portfolio + billing + activity preview).", "title": "Finance Dashboard Bundle", "when_to_use": "Finance landing KPI bundle for profile hub.", "write_mode": null}, {"action": "finance.project.analytics", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.analytics", "source": "overlay", "title": "Finance Project Analytics", "when_to_use": "Finance dashboard KPIs and charts for workspace tenants."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance dashboard KPIs and charts for workspace tenants.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_project_analytics", "summary": "Project finance analytics (revenue/expense trends) for hosted vertical widgets.", "title": "Finance Project Analytics", "when_to_use": "Finance dashboard KPIs and charts for workspace tenants.", "write_mode": null}, {"action": "finance.project.fund", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.fund", "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "source": "overlay", "title": "Finance Project Fund", "when_to_use": "Transfer ecosystem USD into project wallet."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "example_params": {"amount": 123.45, "from_wallet_id": "example_string", "idempotency_key": "example_string", "project_id": 123}, "genetic_tags": ["core.mcp.finance.gen1"], "inputSchema": {"properties": {"amount": {"description": "", "type": "number"}, "from_wallet_id": {"description": "", "type": "string"}, "idempotency_key": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "from_wallet_id", "amount", "idempotency_key"], "type": "object"}, "instruction_hint": "Transfer ecosystem USD into project wallet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "related_tools": ["finance.project.portfolio", "payments.get_balance", "wallets.list"], "required_cap": "payments|project_admin", "rollback": [], "safe_action": "finance_project_fund", "summary": "Fund a project via ecosystem USD transfer.", "title": "Finance Project Fund", "verification": ["finance.project.portfolio", "payments.get_balance"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "payments.get_balance", "predicate": "named resource is visible"}], "when_to_use": "Transfer ecosystem USD into project wallet.", "write_mode": null}, {"action": "finance.project.contribute", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.finance.user_read_model.gen1"], "id": "finance.project.contribute", "source": "overlay", "title": "Finance Project Contribute", "when_to_use": "Member contribution from personal wallet to project."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "example_params": {"amount": 123.45, "anonymous": true, "from_wallet_id": "example_string", "idempotency_key": "example_string", "message": "example_string", "project_id": 123}, "genetic_tags": ["core.mcp.finance.gen1"], "inputSchema": {"properties": {"amount": {"description": "", "type": "number"}, "anonymous": {"description": "", "type": "boolean"}, "from_wallet_id": {"description": "", "type": "string"}, "idempotency_key": {"description": "", "type": "string"}, "message": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "from_wallet_id", "amount", "idempotency_key"], "type": "object"}, "instruction_hint": "Member contribution from personal wallet to project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "payments|project_admin", "rollback": [], "safe_action": "finance_project_contribute", "summary": "Member contribution: USD only from personal ecosystem wallet (project_id=1) to project treasury. Not for custom/game currencies.", "title": "Finance Project Contribute", "verification": ["finance.project.portfolio", "finance.project.contributions.list"], "verify": [{"action": "finance.project.portfolio", "predicate": "named resource is visible"}, {"action": "finance.project.contributions.list", "predicate": "named resource is visible"}], "when_to_use": "Member contribution from personal wallet to project.", "write_mode": null}, {"action": "finance.project.contributions.list", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.project.contributions.list", "source": "overlay", "title": "Finance Project Contributions List", "when_to_use": "Audit member contributions (FAP-masked)."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Audit member contributions (FAP-masked).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_project_contributions_list", "summary": "List member contributions for a project (FAP-masked).", "title": "Finance Project Contributions List", "when_to_use": "Audit member contributions (FAP-masked).", "write_mode": null}, {"action": "finance.pay.quote", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.quote", "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "source": "overlay", "title": "Finance Pay Quote", "when_to_use": "Get pay quote before wallet debit or AGNT purchase."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Get pay quote before wallet debit or AGNT purchase.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "related_tools": ["finance.pay.execute", "wallets.list", "energy.list_packs"], "required_cap": "mcp_read", "safe_action": "finance_pay_quote", "summary": "Quote a unified pay intent (energy_pack, subscription, compute_credits, fund, contribute).", "title": "Finance Pay Quote", "when_to_use": "Get pay quote before wallet debit or AGNT purchase.", "write_mode": null}, {"action": "finance.pay.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.pay.execute", "related_tools": ["finance.pay.quote", "payments.get_balance"], "source": "overlay", "title": "Finance Pay Execute", "when_to_use": "Complete wallet-funded energy, subscription, or contribution."}, "domain_title": "Finance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Complete wallet-funded energy, subscription, or contribution.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "related_tools": ["finance.pay.quote", "payments.get_balance"], "required_cap": "project_admin", "safe_action": "finance_pay_execute", "summary": "Execute a quoted pay intent with idempotency key.", "title": "Finance Pay Execute", "when_to_use": "Complete wallet-funded energy, subscription, or contribution.", "write_mode": null}, {"action": "finance.expense.create", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.create", "mutation_risk": "low", "source": "overlay", "title": "Finance Expense Create", "when_to_use": "Record a project expense before finance.expense.list review."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Record a project expense before finance.expense.list review.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"expense": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "project_admin", "safe_action": "finance_expense_create", "summary": "Create an expense row on data.money.expenses[].", "title": "Finance Expense Create", "when_to_use": "Record a project expense before finance.expense.list review.", "write_mode": null}, {"action": "finance.expense.list", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.list", "source": "overlay", "title": "Finance Expense List", "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated,…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"coverage": {"description": "object", "type": "any"}, "expenses": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_expense_list", "summary": "List project expenses on the canonical money.expenses leaf. Not inside a generation sandbox. Filter by date_from/date_to then limit.", "title": "Finance Expense List", "when_to_use": "Canonical money.expenses, not a sandbox leaf. Read coverage.stored_cap (512), coverage.truncated, and category_coerced.", "write_mode": null}, {"action": "finance.expense.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.expense.delete", "mutation_risk": "high", "source": "overlay", "title": "Finance Expense Delete", "when_to_use": "Remove a mistaken expense by id from finance.expense.list."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove a mistaken expense by id from finance.expense.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "project_admin", "safe_action": "finance_expense_delete", "summary": "Delete expense by id.", "title": "Finance Expense Delete", "when_to_use": "Remove a mistaken expense by id from finance.expense.list.", "write_mode": null}, {"action": "finance.revenue.record", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.record", "source": "overlay", "title": "Finance Revenue Record", "when_to_use": "After delivering a project or manual revenue adjustment."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "After delivering a project or manual revenue adjustment.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revenue": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_revenue_record", "summary": "Record paid freelancer revenue on data.money.invoices[] (EDITFLOW deal close).", "title": "Finance Revenue Record", "when_to_use": "After delivering a project or manual revenue adjustment.", "write_mode": null}, {"action": "finance.revenue.list", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.list", "source": "overlay", "title": "Finance Revenue List", "when_to_use": "Finance page revenue list after finance.revenue.record."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Finance page revenue list after finance.revenue.record.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revenues": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "mcp_read", "safe_action": "finance_revenue_list", "summary": "List paid freelancer revenue rows on data.money.invoices[] (actor-scoped).", "title": "Finance Revenue List", "when_to_use": "Finance page revenue list after finance.revenue.record.", "write_mode": null}, {"action": "finance.revenue.update", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.update", "mutation_risk": "low", "source": "overlay", "title": "Finance Revenue Update", "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Correct a mistaken revenue entry from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revenue": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "project_admin", "safe_action": "finance_revenue_update", "summary": "Update paid freelancer revenue amount or description (actor-owned).", "title": "Finance Revenue Update", "when_to_use": "Correct a mistaken revenue entry from finance.revenue.list.", "write_mode": null}, {"action": "finance.revenue.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "finance", "genetic_tags": ["core.mcp.finance.gen1"], "id": "finance.revenue.delete", "mutation_risk": "high", "source": "overlay", "title": "Finance Revenue Delete", "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list."}, "domain_title": "Finance Expense MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.finance.gen1"], "instruction_hint": "Remove duplicate or mistaken revenue from finance.revenue.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.finance_expense", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.finance.gen1", "related_prompts": ["agentstack_commerce_flows", "agentstack_tenant_subscription_monetization", "agentstack_tenant_buff_grant", "agentstack_hosting_storefront", "agentstack_project_treasury"], "required_cap": "project_admin", "safe_action": "finance_revenue_delete", "summary": "Delete a paid freelancer revenue row by id (actor-owned).", "title": "Finance Revenue Delete", "when_to_use": "Remove duplicate or mistaken revenue from finance.revenue.list.", "write_mode": null}], "fundraising": [{"action": "fundraising.narrative.lint", "capability_descriptor": {"complexity": "intermediate", "domain": "commerce", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.narrative.lint", "related_tools": ["fundraising.packet.compose"], "source": "overlay", "title": "Fundraising Narrative Lint", "when_to_use": "Before pasting grant copy or publishing a deck snippet."}, "domain_title": "Fundraising MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Before pasting grant copy or publishing a deck snippet.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "docs.grants.portfolio.gen1", "related_tools": ["fundraising.packet.compose"], "required_cap": "mcp_read", "safe_action": "fundraising_narrative_lint", "summary": "Scan text for forbidden fundraising phrases from NARRATIVE_REGISTRY.yaml.", "title": "Fundraising Narrative Lint", "when_to_use": "Before pasting grant copy or publishing a deck snippet.", "write_mode": null}, {"action": "fundraising.packet.compose", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["docs.grants.portfolio.gen1"], "id": "fundraising.packet.compose", "related_tools": ["grants.compose.checklist", "agentnet.admin.launch_readiness"], "source": "overlay", "title": "Fundraising Packet Compose", "when_to_use": "Grant submit prep — attachment checklist for a program."}, "domain_title": "Fundraising MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["docs.grants.portfolio.gen1"], "instruction_hint": "Grant submit prep — attachment checklist for a program.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.fundraising", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "docs.grants.portfolio.gen1", "related_tools": ["grants.compose.checklist", "agentnet.admin.launch_readiness"], "required_cap": "mcp_read", "safe_action": "fundraising_packet_compose", "summary": "List attachment paths for a grant program packet (registry + evidence). Ecosystem owner only — prefer grants.compose.checklist for Grant OS CRM.", "title": "Fundraising Packet Compose", "when_to_use": "Grant submit prep — attachment checklist for a program.", "write_mode": null}], "generation": [{"action": "generation.list", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.list", "source": "handler", "title": "Generation List", "when_to_use": "List sandbox generations. list_unavailable is a failed read, not zero anchors. A missing preferred uuid is stale: generation.diff_vs_prod, do not fork again."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Fork anchor UUID for stale/hydrate hints (defaults to generation_env_uuid in batch context)", "format": "uuid", "type": "string"}, "include_gates": {"description": "When true, run gate chain per environment (REST list parity)", "type": "boolean"}, "include_status": {"default": "all", "description": "Filter anchors: all | open | comma-separated statuses (e.g. realigned,forked)", "type": "string"}, "project_id": {"description": "Logical project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "List sandbox generations. list_unavailable is a failed read, not zero anchors. A missing preferre…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"canonical_revision": {"description": "Anchor generation counter for poll/stale detection", "type": "any"}, "environments": {"description": "Sandbox environment anchors", "type": "any"}, "include_status": {"description": "Filter applied: all | open | comma-separated statuses", "type": "any"}, "list_contract": {"description": "historical_all — full anchor history (ADR GENERATION_LIST_CONTRACT)", "type": "any"}, "project_id": {"description": "Logical project id", "type": "any"}, "projection": {"description": "Read-model lag envelope (stale, filtered, verification_action)", "type": "any"}, "projection.filtered": {"description": "True when include_status narrowed the SQL list", "type": "any"}, "projection_revision": {"description": "Hydrated list size signal (distinct from canonical_revision)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_list", "summary": "List sandbox environment anchors for a project (names, status, CalVer, auto_created flags). error_code list_unavailable means the read failed.", "title": "Generation List", "when_to_use": "List sandbox generations. list_unavailable is a failed read, not zero anchors. A missing preferred uuid is stale: generation.diff_vs_prod, do not fork again.", "write_mode": null}, {"action": "generation.status", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.status", "source": "handler", "title": "Generation Status", "when_to_use": "Lightweight generation + canary status for UI banners and agents."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"project_id": {"description": "Logical project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Lightweight generation + canary status for UI banners and agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"status": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_status", "summary": "Lightweight generation + canary status for UI banners and agents.", "title": "Generation Status", "when_to_use": "Lightweight generation + canary status for UI banners and agents.", "write_mode": null}, {"action": "generation.supply_status", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.supply_status", "source": "overlay", "title": "Generation Supply Status", "when_to_use": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pending/canary state. Alias for agents (same SoT as GET /api/sandbox/limits + generation.status)."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pe…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"status": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_supply_status", "summary": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pending/canary state. Alias for agents (same SoT as GET /api/sandbox/limits + generation.status).", "title": "Generation Supply Status", "when_to_use": "Tenant generation supply snapshot: owner tier, open-env quota usage, auto_generation settings, pending/canary state. Alias for agents (same SoT as GET /api/sandbox/limits + generation.status).", "write_mode": null}, {"action": "generation.settings.get", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.get", "related_tools": ["generation.settings.patch", "generation.status"], "source": "overlay", "title": "Generation Settings Get", "when_to_use": "Inspect auto_generation_mode before tenant MCP mutations."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Inspect auto_generation_mode before tenant MCP mutations.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"project_id": {"description": "int", "type": "any"}, "settings": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.settings.patch", "generation.status"], "required_cap": "mcp_read", "safe_action": "generation_settings_get", "summary": "Read per-project auto_generation settings (REST parity: GET /api/generations/{id}/settings).", "title": "Generation Settings Get", "when_to_use": "Inspect auto_generation_mode before tenant MCP mutations.", "write_mode": null}, {"action": "generation.settings.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.settings.patch", "mutation_risk": "low", "related_tools": ["generation.settings.get", "generation.promote", "generation.status"], "source": "overlay", "title": "Generation Settings Patch", "when_to_use": "Enable tenant 8DNA generation supply (e.g. project 1444): auto_generation_mode + auto_promote_strategy + require_approval."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Enable tenant 8DNA generation supply (e.g. project 1444): auto_generation_mode + auto_promote_str…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"project_id": {"description": "int", "type": "any"}, "settings": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.settings.get", "generation.promote", "generation.status"], "required_cap": "project_admin", "safe_action": "generation_settings_patch", "summary": "PATCH auto_generation settings on the production project slice. Enable auto_generation_mode so tracked MCP mutations auto-fork to sandbox. REST parity: PATCH /api/generations/{id}/settings.", "title": "Generation Settings Patch", "when_to_use": "Enable tenant 8DNA generation supply (e.g. project 1444): auto_generation_mode + auto_promote_strategy + require_approval.", "write_mode": null}, {"action": "generation.queue", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.queue", "source": "overlay", "title": "Generation Queue", "when_to_use": "Promotion queue: pending sandbox generations with gate evaluation (REST parity)."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Promotion queue: pending sandbox generations with gate evaluation (REST parity).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"pending": {"description": "list", "type": "any"}, "project_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_queue", "summary": "Promotion queue: pending sandbox generations with gate evaluation (REST parity).", "title": "Generation Queue", "when_to_use": "Promotion queue: pending sandbox generations with gate evaluation (REST parity).", "write_mode": null}, {"action": "generation.fork", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.fork", "mutation_risk": "low", "related_tools": ["generation.diff_vs_prod", "generation.gates", "generation.promote"], "source": "handler", "title": "Generation Fork", "when_to_use": "Fork sandbox generation anchor before tracked tenant mutations."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"env_name": "example_string", "env_type": "example_string", "project_id": 123, "source_project_id": 123}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_name": {"description": "Environment name (default: mcp-fork)", "type": "string"}, "env_type": {"description": "sandbox|staging|feature", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "source_project_id": {"description": "Source project id (default: same as project_id)", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Fork sandbox generation anchor before tracked tenant mutations.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"anchor_uuid": {"description": "string", "type": "any"}, "generation": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.diff_vs_prod", "generation.gates", "generation.promote"], "required_cap": "project_admin", "rollback": ["generation.realign_to_prod"], "safe_action": "generation_fork", "summary": "Fork production project into a new sandbox environment generation.", "title": "Generation Fork", "verification": ["generation.list", "generation.status"], "verify": [{"action": "generation.list", "predicate": "named resource is visible"}, {"action": "generation.status", "predicate": "named resource is visible"}], "when_to_use": "Fork sandbox generation anchor before tracked tenant mutations.", "write_mode": null}, {"action": "generation.canary.advance", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.advance", "mutation_risk": "low", "source": "handler", "title": "Generation Canary Advance", "when_to_use": "Advance canary rollout to the next traffic weight step."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Advance canary rollout to the next traffic weight step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"status": {"description": "string", "type": "any"}, "step": {"description": "int", "type": "any"}, "traffic_weight": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "project_admin", "safe_action": "generation_canary_advance", "summary": "Advance canary rollout to the next traffic weight step.", "title": "Generation Canary Advance", "when_to_use": "Advance canary rollout to the next traffic weight step.", "write_mode": null}, {"action": "generation.canary.abort", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.canary.abort", "mutation_risk": "high", "source": "handler", "title": "Generation Canary Abort", "when_to_use": "Abort canary rollout and restore previous production pointer."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "mark_failed": {"description": "When true (or rollout_mode=test on watchdog), mark env failed instead of aborted", "type": "boolean"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Abort canary rollout and restore previous production pointer.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"restored_to": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}, "traffic_weight": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "project_admin", "safe_action": "generation_canary_abort", "summary": "Abort canary rollout and restore previous production pointer.", "title": "Generation Canary Abort", "when_to_use": "Abort canary rollout and restore previous production pointer.", "write_mode": null}, {"action": "generation.hosting.release", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.hosting.release", "mutation_risk": "low", "source": "handler", "title": "Generation Hosting Release", "when_to_use": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does not swap canonical /s/ URL — follow with hosting.release.promote."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Sandbox anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "publish_preview": {"description": "Refresh {name}-preview route (default true)", "type": "boolean"}, "site_id": {"description": "Hosting site_id", "type": "string"}}, "required": ["project_id", "site_id"], "type": "object"}, "instruction_hint": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does n…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"preview_url": {"description": "string", "type": "any"}, "release_uuid": {"description": "string", "type": "any"}, "sandbox_generation": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "project_admin", "safe_action": "generation_hosting_release", "summary": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does not swap canonical /s/ URL — follow with hosting.release.promote.", "title": "Generation Hosting Release", "when_to_use": "Snapshot live hosting workspace into an immutable release labeled with sandbox generation. Does not swap canonical /s/ URL — follow with hosting.release.promote.", "write_mode": null}, {"action": "generation.diff", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.diff", "source": "handler", "title": "Generation Diff", "when_to_use": "Structured diff between two resolved generation entity states (same table/project)."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid_a": {"description": "First entity UUID", "format": "uuid", "type": "string"}, "env_uuid_b": {"description": "Second entity UUID", "format": "uuid", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "table": {"description": "DNA table (default data_projects_8dna)", "type": "string"}}, "required": ["project_id", "env_uuid_a", "env_uuid_b"], "type": "object"}, "instruction_hint": "Structured diff between two resolved generation entity states (same table/project).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"diff": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_diff", "summary": "Structured diff between two resolved generation entity states (same table/project).", "title": "Generation Diff", "when_to_use": "Structured diff between two resolved generation entity states (same table/project).", "write_mode": null}, {"action": "generation.diff_vs_prod", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.diff_vs_prod", "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates"], "source": "handler", "title": "Generation Diff Vs Prod", "when_blocked": {"anchor_missing_from_list": "diff by UUID — do not fork again", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "list_unavailable": "generation.list failed — retry once, do not fork to fill"}, "when_to_use": "Review sandbox diff before promote (tenant supply chain)."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Sandbox environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "path_prefixes": {"description": "Optional dotted path prefixes to filter diff (e.g. config.knowledge)", "type": "array"}, "project_id": {"description": "Project id", "type": "integer"}, "table": {"description": "DNA table (default data_projects_8dna)", "type": "string"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Review sandbox diff before promote (tenant supply chain).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_context": {"description": "object", "type": "any"}, "diff": {"description": "object", "type": "any"}, "prod_head_uuid": {"description": "string", "type": "any"}, "sandbox_head_uuid": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.promote", "generation.realign_to_prod", "generation.gates"], "required_cap": "mcp_read", "safe_action": "generation_diff_vs_prod", "summary": "Diff stable production head vs pending sandbox head. Includes agent_context summary for diagnosis (counts, domains, sample paths).", "title": "Generation Diff Vs Prod", "when_blocked": {"anchor_missing_from_list": "diff by UUID — do not fork again", "env_uuid_not_found": "omit generation_env_uuid — server keeps sandbox head", "list_unavailable": "generation.list failed — retry once, do not fork to fill"}, "when_to_use": "Review sandbox diff before promote (tenant supply chain).", "write_mode": null}, {"action": "generation.realign_to_prod", "aliases": ["generation.discard"], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.realign_to_prod", "mutation_risk": "high", "source": "handler", "title": "Generation Realign To Prod", "when_to_use": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"dry_run": true, "env_uuid": "example_string", "path_prefixes": [], "project_id": 123}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"dry_run": {"description": "Plan only — no writes", "type": "boolean"}, "env_uuid": {"description": "Sandbox anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "path_prefixes": {"description": "Only revert paths under these dotted prefixes", "type": "array"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / pa…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_context": {"description": "object", "type": "any"}, "applied_deletes": {"description": "int", "type": "any"}, "applied_sets": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "project_admin", "rollback": [], "safe_action": "generation_realign_to_prod", "summary": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert.", "title": "Generation Realign To Prod", "verification": ["generation.diff_vs_prod", "generation.list"], "verify": [{"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}, {"action": "generation.list", "predicate": "named resource is visible"}], "when_to_use": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert.", "write_mode": null}, {"action": "generation.discard", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1", "core.tenant.8dna_generation_supply.gen1"], "id": "generation.realign_to_prod", "mutation_risk": "high", "source": "handler", "title": "Generation Realign To Prod", "when_to_use": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / pa…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"agent_context": {"description": "object", "type": "any"}, "applied_deletes": {"description": "int", "type": "any"}, "applied_sets": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_discard", "summary": "Discard sandbox changes (Postel alias for generation.realign_to_prod). Defaults to dry_run=true — set dry_run=false to apply.", "title": "Generation Realign To Prod", "when_to_use": "Revert pending sandbox DNA toward stable production by applying inverse diff (leaf jsonb_set / path delete on sandbox anchor — no full-blob wipe). Optional path_prefixes for partial revert.", "write_mode": null}, {"action": "generation.promote", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.promote", "mutation_risk": "high", "related_tools": ["generation.gates", "generation.timeline", "generation.status"], "source": "handler", "title": "Generation Promote", "when_blocked": {"env_uuid_not_found": "omit generation_env_uuid — server clears stale uuid and retries", "gates_not_passed": "generation.gates — re-poll soak pending", "parallel_canonical_drift": "generation.realign_to_prod dry_run — do not promote again"}, "when_to_use": "Promote sandbox to prod per project auto_promote_strategy."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"env_uuid": "example_string", "project_id": 123, "require_gates_passed": true, "rollout_mode": "example_string", "rollout_steps": [], "segment_id": "example_string", "strategy": "example_string"}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "require_gates_passed": {"description": "When true, block promote unless all gates pass", "type": "boolean"}, "rollout_mode": {"description": "standard | test — test extends canary (100% traffic, failed on watchdog abort)", "type": "string"}, "rollout_steps": {"description": "Canary rollout steps [{weight, pause_minutes, auto_advance}]", "type": "array"}, "segment_id": {"description": "Optional audience segment id for canary/test routing", "type": "string"}, "strategy": {"description": "immediate | canary | blue_green — defaults to project auto_promote_strategy; 'manual' is alias for blue_green", "type": "string"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Promote sandbox to prod per project auto_promote_strategy.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checks": {"description": "object", "type": "any"}, "promotion_request_uuid": {"description": "string", "type": "any"}, "status": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.gates", "generation.timeline", "generation.status"], "required_cap": "project_admin", "rollback": ["generation.rollback", "generation.checkpoint"], "safe_action": "generation_promote", "summary": "Promote a sandbox environment to production (runs promotion checks first).", "title": "Generation Promote", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_blocked": {"env_uuid_not_found": "omit generation_env_uuid — server clears stale uuid and retries", "gates_not_passed": "generation.gates — re-poll soak pending", "parallel_canonical_drift": "generation.realign_to_prod dry_run — do not promote again"}, "when_to_use": "Promote sandbox to prod per project auto_promote_strategy.", "write_mode": null}, {"action": "generation.approve", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.approve", "mutation_risk": "low", "source": "handler", "title": "Generation Approve", "when_to_use": "Mark manual generation approval on anchor and re-run gate evaluation."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"env_uuid": "example_string", "note": "example_string", "project_id": 123}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "note": {"description": "Optional audit note", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Mark manual generation approval on anchor and re-run gate evaluation.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"gates": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "project_admin", "rollback": [], "safe_action": "generation_approve", "summary": "Mark manual generation approval on anchor and re-run gate evaluation.", "title": "Generation Approve", "verification": ["generation.gates", "generation.status"], "verify": [{"action": "generation.gates", "predicate": "named resource is visible"}, {"action": "generation.status", "predicate": "named resource is visible"}], "when_to_use": "Mark manual generation approval on anchor and re-run gate evaluation.", "write_mode": null}, {"action": "generation.gates", "aliases": ["generation.run_gates"], "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.gates", "source": "handler", "title": "Generation Gates", "when_to_use": "Run promotion gates on an anchor env_uuid."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Environment anchor UUID (omit; the server keeps the sandbox head. Pass it to choose a second head)", "format": "uuid", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Run promotion gates on an anchor env_uuid.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"gates": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_gates", "summary": "Run generation gate chain for an environment (schema, conflict, health, soak, metrics, optional manual).", "title": "Generation Gates", "when_to_use": "Run promotion gates on an anchor env_uuid.", "write_mode": null}, {"action": "generation.notify", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.notify", "related_tools": ["generation.status", "generation.timeline"], "source": "overlay", "title": "Generation Notify", "when_to_use": "Notify operators about a generation event (REST POST /generations/{id}/notify parity)."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Notify operators about a generation event (REST POST /generations/{id}/notify parity).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "related_tools": ["generation.status", "generation.timeline"], "required_cap": "project_admin", "safe_action": "generation_notify", "summary": "Manual generation notify — webhooks, audit log, optional in-app notification.", "title": "Generation Notify", "when_to_use": "Notify operators about a generation event (REST POST /generations/{id}/notify parity).", "write_mode": null}, {"action": "generation.checkpoint", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.checkpoint", "source": "overlay", "title": "Generation Checkpoint", "when_to_use": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before risky bulk edits; rollback via generation.rollback."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "instruction_hint": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"checkpoint_uuid": {"description": "string", "type": "any"}, "generation": {"description": "int", "type": "any"}, "label": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_checkpoint", "summary": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before risky bulk edits; rollback via generation.rollback.", "title": "Generation Checkpoint", "when_to_use": "Materialise merged production/sandbox DNA into a checkpoint generation (rollback SoT). Use before risky bulk edits; rollback via generation.rollback.", "write_mode": null}, {"action": "generation.rollback", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.rollback", "source": "overlay", "title": "Generation Rollback", "when_to_use": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via generation.promote to restore production DNA."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": true, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"checkpoint_uuid": "example_string", "env_name": "example_string", "project_id": 123}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"checkpoint_uuid": {"description": "Checkpoint uuid", "format": "uuid", "type": "string"}, "env_name": {"description": "Rollback env name", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id", "checkpoint_uuid"], "type": "object"}, "instruction_hint": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via gen…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"env_name": {"description": "string", "type": "any"}, "generation": {"description": "int", "type": "any"}, "rollback_uuid": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "rollback": [], "safe_action": "generation_rollback", "summary": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via generation.promote to restore production DNA.", "title": "Generation Rollback", "verification": ["generation.status", "generation.diff_vs_prod"], "verify": [{"action": "generation.status", "predicate": "named resource is visible"}, {"action": "generation.diff_vs_prod", "predicate": "named resource is visible"}], "when_to_use": "Open a checkpoint as a new sandbox generation (draft). Promote the returned rollback_uuid via generation.promote to restore production DNA.", "write_mode": null}, {"action": "generation.timeline", "capability_descriptor": {"complexity": "intermediate", "domain": "generation", "genetic_tags": ["core.generation_flow.gen1"], "id": "generation.timeline", "source": "handler", "title": "Generation Timeline", "when_to_use": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requests (newest first). Items include strategy, traffic_weight, calver_label when recorded."}, "domain_title": "Generations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.generation_flow.gen1"], "inputSchema": {"properties": {"limit": {"description": "Max rows (default 20)", "type": "integer"}, "offset": {"description": "Offset for pagination", "type": "integer"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requ…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.generations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "list", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.generation_flow.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_8dna_supply", "agentstack_closed_loop_autonomy", "agentstack_plan_graph", "agentstack_tenant_ops_mcp_first", "agentstack_key2unity_site"], "required_cap": "mcp_read", "safe_action": "generation_timeline", "summary": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requests (newest first). Items include strategy, traffic_weight, calver_label when recorded.", "title": "Generation Timeline", "when_to_use": "Promotion history for a project: completed, active canary (rolling_out), failed, and aborted requests (newest first). Items include strategy, traffic_weight, calver_label when recorded.", "write_mode": null}], "goals": [{"action": "goals.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.upsert", "mutation_risk": "low", "source": "overlay", "title": "Goals Upsert", "when_to_use": "Set or update a monthly finance, projects, or hours target."}, "domain_title": "Goals MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"kind": "example_string", "period": "example_string", "project_id": 123, "target": 123.45, "title": "example_string"}, "genetic_tags": ["core.mcp.goals.gen1"], "inputSchema": {"properties": {"kind": {"description": "", "type": "string"}, "period": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}, "target": {"description": "", "type": "number"}, "title": {"description": "", "type": "string"}}, "required": ["project_id", "kind", "target", "period"], "type": "object"}, "instruction_hint": "Set or update a monthly finance, projects, or hours target.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"goal": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.goals.gen1", "required_cap": "project_admin", "rollback": ["goals.delete"], "safe_action": "goals_upsert", "summary": "Upsert a monthly goal (finance|projects|hours).", "title": "Goals Upsert", "verification": ["goals.list", "goals.progress"], "verify": [{"action": "goals.list", "predicate": "named resource is visible"}, {"action": "goals.progress", "predicate": "named resource is visible"}], "when_to_use": "Set or update a monthly finance, projects, or hours target.", "write_mode": null}, {"action": "goals.progress", "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.progress", "source": "overlay", "title": "Goals Progress", "when_to_use": "Show goal attainment after goals.upsert or at month close."}, "domain_title": "Goals MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Show goal attainment after goals.upsert or at month close.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"goals": {"description": "array", "type": "any"}, "month": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.goals.gen1", "required_cap": "mcp_read", "safe_action": "goals_progress", "summary": "Compute goal progress from finance/CRM/time BFFs.", "title": "Goals Progress", "when_to_use": "Show goal attainment after goals.upsert or at month close.", "write_mode": null}, {"action": "goals.list", "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.list", "source": "overlay", "title": "Goals List", "when_to_use": "Enumerate stored goals before upsert or progress checks."}, "domain_title": "Goals MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Enumerate stored goals before upsert or progress checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"goals": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.goals.gen1", "required_cap": "mcp_read", "safe_action": "goals_list", "summary": "List goals stored in data.goals[].", "title": "Goals List", "when_to_use": "Enumerate stored goals before upsert or progress checks.", "write_mode": null}, {"action": "goals.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "goals", "genetic_tags": ["core.mcp.goals.gen1"], "id": "goals.delete", "mutation_risk": "high", "source": "overlay", "title": "Goals Delete", "when_to_use": "Remove an obsolete goal by id from goals.list."}, "domain_title": "Goals MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.goals.gen1"], "instruction_hint": "Remove an obsolete goal by id from goals.list.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.goals", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}, "goal_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.goals.gen1", "required_cap": "project_admin", "safe_action": "goals_delete", "summary": "Delete a goal by id from data.goals[].", "title": "Goals Delete", "when_to_use": "Remove an obsolete goal by id from goals.list.", "write_mode": null}], "grants": [{"action": "grants.crm.list", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.list", "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "source": "overlay", "title": "Grants Crm List", "when_to_use": "Prioritize which platform grant/bounty to work next."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Prioritize which platform grant/bounty to work next.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "safe_action": "grants_crm_list", "summary": "List AgentStack platform Grant OS pipeline ranked by FitAndWinScorer (cash-first). Ecosystem owner only — not for tenant users.", "title": "Grants Crm List", "when_to_use": "Prioritize which platform grant/bounty to work next.", "write_mode": null}, {"action": "grants.crm.seed", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.seed", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Crm Seed", "when_to_use": "First-time Grant OS setup or after registry changes."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "First-time Grant OS setup or after registry changes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_crm_seed", "summary": "Seed Grant OS CRM rows from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Crm Seed", "when_to_use": "First-time Grant OS setup or after registry changes.", "write_mode": null}, {"action": "grants.crm.transition", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.transition", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Crm Transition", "when_to_use": "Mark submitted / awarded / remediation after portal action."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Mark submitted / awarded / remediation after portal action.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_crm_transition", "summary": "Transition a Grant OS application status (lifecycle FSM). Ecosystem owner.", "title": "Grants Crm Transition", "when_to_use": "Mark submitted / awarded / remediation after portal action.", "write_mode": null}, {"action": "grants.packet.build", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.packet.build", "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "source": "overlay", "title": "Grants Packet Build", "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Before platform grant submit — refresh packet evidence and CRM status.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["fundraising.packet.compose", "grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_packet_build", "summary": "Rebuild grant packets and sync CRM blockers from packet.json (ecosystem).", "title": "Grants Packet Build", "when_to_use": "Before platform grant submit — refresh packet evidence and CRM status.", "write_mode": null}, {"action": "grants.compose.checklist", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.compose.checklist", "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "source": "overlay", "title": "Grants Compose Checklist", "when_to_use": "Before uploading zip/attachments to a grant portal."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Before uploading zip/attachments to a grant portal.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "fundraising.packet.compose"], "required_cap": "mcp_read", "safe_action": "grants_compose_checklist", "summary": "Attachment checklist for a platform grant portal submit.", "title": "Grants Compose Checklist", "when_to_use": "Before uploading zip/attachments to a grant portal.", "write_mode": null}, {"action": "grants.crm.sync", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.sync", "related_tools": ["grants.packet.build", "grants.crm.list"], "source": "overlay", "title": "Grants Crm Sync", "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.packet.build", "grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_crm_sync", "summary": "Sync Grant OS CRM statuses from packet.json blockers (GW-CRM-001).", "title": "Grants Crm Sync", "when_to_use": "After metrics/packet refresh — derive evidence_pending vs submit_ready.", "write_mode": null}, {"action": "grants.crm.overview", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.overview", "related_tools": ["grants.crm.list", "grants.crm.integrity"], "source": "overlay", "title": "Grants Crm Overview", "when_to_use": "Dashboard snapshot of platform fundraising pipeline."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Dashboard snapshot of platform fundraising pipeline.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.integrity"], "required_cap": "mcp_read", "safe_action": "grants_crm_overview", "summary": "Grant OS CRM overview counts by status (ecosystem owner).", "title": "Grants Crm Overview", "when_to_use": "Dashboard snapshot of platform fundraising pipeline.", "write_mode": null}, {"action": "grants.crm.integrity", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.integrity", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Crm Integrity", "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Before submit — fail if submit_ready has blockers or registry missing.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_crm_integrity", "summary": "Assert Grant OS CRM integrity (GW-CRM-001 + docs mount).", "title": "Grants Crm Integrity", "when_to_use": "Before submit — fail if submit_ready has blockers or registry missing.", "write_mode": null}, {"action": "grants.crm.hub_snapshot", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.crm.hub_snapshot", "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "source": "overlay", "title": "Grants Crm Hub Snapshot", "when_to_use": "Single read for Grant OS DevShell without four separate calls."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Single read for Grant OS DevShell without four separate calls.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.overview", "grants.reminders.list"], "required_cap": "mcp_read", "safe_action": "grants_crm_hub_snapshot", "summary": "Grant OS hub snapshot — overview, pipeline, reminders, integrity (ecosystem owner). Mirrors GET /api/admin/grants/hub-snapshot.", "title": "Grants Crm Hub Snapshot", "when_to_use": "Single read for Grant OS DevShell without four separate calls.", "write_mode": null}, {"action": "grants.anchor.nsf_pitch", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.nsf_pitch", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Anchor Nsf Pitch", "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_anchor_nsf_pitch", "summary": "Render NSF SBIR-style Project Pitch from Grant OS anchor atoms.", "title": "Grants Anchor Nsf Pitch", "when_to_use": "Non-crypto non-dilutive path for AgentStack platform — draft NSF pitch.", "write_mode": null}, {"action": "grants.anchor.update", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.anchor.update", "mutation_risk": "low", "related_tools": ["grants.anchor.nsf_pitch"], "source": "overlay", "title": "Grants Anchor Update", "when_to_use": "Save anchor document before NSF pitch export."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Save anchor document before NSF pitch export.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.anchor.nsf_pitch"], "required_cap": "project_admin", "safe_action": "grants_anchor_update", "summary": "Update Grant OS NSF anchor atoms (ecosystem owner).", "title": "Grants Anchor Update", "when_to_use": "Save anchor document before NSF pitch export.", "write_mode": null}, {"action": "grants.w0.get", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.get", "related_tools": ["grants.w0.patch"], "source": "overlay", "title": "Grants W0 Get", "when_to_use": "Track founder W0 evidence gates."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Track founder W0 evidence gates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.patch"], "required_cap": "mcp_read", "safe_action": "grants_w0_get", "summary": "Read W0 cash-gates checklist (ecosystem owner).", "title": "Grants W0 Get", "when_to_use": "Track founder W0 evidence gates.", "write_mode": null}, {"action": "grants.w0.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.w0.patch", "mutation_risk": "low", "related_tools": ["grants.w0.get"], "source": "overlay", "title": "Grants W0 Patch", "when_to_use": "Mark W0 gate done after portal action."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Mark W0 gate done after portal action.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.w0.get"], "required_cap": "project_admin", "safe_action": "grants_w0_patch", "summary": "Patch W0 checklist item statuses.", "title": "Grants W0 Patch", "when_to_use": "Mark W0 gate done after portal action.", "write_mode": null}, {"action": "grants.reminders.list", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reminders.list", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Reminders List", "when_to_use": "Friday follow-up cadence."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Friday follow-up cadence.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_reminders_list", "summary": "Relationship follow-up reminders for Grant OS pipeline.", "title": "Grants Reminders List", "when_to_use": "Friday follow-up cadence.", "write_mode": null}, {"action": "grants.reports.monthly", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.reports.monthly", "related_tools": ["grants.crm.list"], "source": "overlay", "title": "Grants Reports Monthly", "when_to_use": "End-of-month grant reporting."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "End-of-month grant reporting.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list"], "required_cap": "mcp_read", "safe_action": "grants_reports_monthly", "summary": "Generate monthly post-award markdown/json report.", "title": "Grants Reports Monthly", "when_to_use": "End-of-month grant reporting.", "write_mode": null}, {"action": "grants.applications.detail", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.detail", "related_tools": ["grants.crm.list", "grants.crm.transition"], "source": "overlay", "title": "Grants Applications Detail", "when_to_use": "Inspect blockers and earning playbooks for one program."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Inspect blockers and earning playbooks for one program.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.list", "grants.crm.transition"], "required_cap": "mcp_read", "safe_action": "grants_applications_detail", "summary": "Grant OS application detail with score breakdown.", "title": "Grants Applications Detail", "when_to_use": "Inspect blockers and earning playbooks for one program.", "write_mode": null}, {"action": "grants.applications.milestone", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.milestone", "related_tools": ["grants.applications.detail", "grants.crm.transition"], "source": "overlay", "title": "Grants Applications Milestone", "when_to_use": "Mark evidence milestones done before submit_ready transition."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Mark evidence milestones done before submit_ready transition.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.applications.detail", "grants.crm.transition"], "required_cap": "mcp_read", "safe_action": "grants_applications_milestone", "summary": "Toggle Grant OS application milestone completion (ecosystem owner).", "title": "Grants Applications Milestone", "when_to_use": "Mark evidence milestones done before submit_ready transition.", "write_mode": null}, {"action": "grants.earning.list", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.list", "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "source": "overlay", "title": "Grants Earning List", "when_to_use": "Map grant submit to platform revenue levers."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Map grant submit to platform revenue levers.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.get", "grants.earning.upsert", "grants.applications.detail"], "required_cap": "mcp_read", "safe_action": "grants_earning_list", "summary": "List AgentStack ecosystem earning playbooks for grant leverage.", "title": "Grants Earning List", "when_to_use": "Map grant submit to platform revenue levers.", "write_mode": null}, {"action": "grants.earning.get", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.get", "related_tools": ["grants.earning.upsert", "grants.earning.list"], "source": "overlay", "title": "Grants Earning Get", "when_to_use": "Read lane before patch."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Read lane before patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.upsert", "grants.earning.list"], "required_cap": "mcp_read", "safe_action": "grants_earning_get", "summary": "Get one earning playbook from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Get", "when_to_use": "Read lane before patch.", "write_mode": null}, {"action": "grants.earning.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.upsert", "mutation_risk": "low", "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "source": "overlay", "title": "Grants Earning Upsert", "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.catalog.upsert"], "required_cap": "project_admin", "safe_action": "grants_earning_upsert", "summary": "Merge earning playbook fields into EARNING_PLAYBOOKS.yaml (atomic backup). Agents use this to add/update revenue lanes without editing repo files.", "title": "Grants Earning Upsert", "when_to_use": "Add or tune AgentStack earning lane linked to grant_synergy program ids.", "write_mode": null}, {"action": "grants.earning.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.earning.delete", "mutation_risk": "high", "related_tools": ["grants.earning.list", "grants.earning.upsert"], "source": "overlay", "title": "Grants Earning Delete", "when_to_use": "Retire a revenue lane (creates .bak backup)."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Retire a revenue lane (creates .bak backup).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.earning.list", "grants.earning.upsert"], "required_cap": "project_admin", "safe_action": "grants_earning_delete", "summary": "Remove an earning playbook row from EARNING_PLAYBOOKS.yaml.", "title": "Grants Earning Delete", "when_to_use": "Retire a revenue lane (creates .bak backup).", "write_mode": null}, {"action": "grants.bundle.download", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.bundle.download", "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "source": "overlay", "title": "Grants Bundle Download", "when_to_use": "One-click bundle when compose checklist has no missing attachments."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "One-click bundle when compose checklist has no missing attachments.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.compose.checklist", "fundraising.packet.compose"], "required_cap": "mcp_read", "safe_action": "grants_bundle_download", "summary": "Build submission zip for a program (ecosystem owner). Returns base64 zip bytes when include_content=true (default).", "title": "Grants Bundle Download", "when_to_use": "One-click bundle when compose checklist has no missing attachments.", "write_mode": null}, {"action": "grants.catalog.list", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.list", "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "source": "overlay", "title": "Grants Catalog List", "when_to_use": "Discover catalog before upsert or CRM seed."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Discover catalog before upsert or CRM seed.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.get", "grants.opportunity.upsert"], "required_cap": "mcp_read", "safe_action": "grants_catalog_list", "summary": "List grant programs from PROGRAM_REGISTRY.yaml (ecosystem owner).", "title": "Grants Catalog List", "when_to_use": "Discover catalog before upsert or CRM seed.", "write_mode": null}, {"action": "grants.catalog.get", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.get", "related_tools": ["grants.catalog.upsert"], "source": "overlay", "title": "Grants Catalog Get", "when_to_use": "Read catalog row before patch."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Read catalog row before patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert"], "required_cap": "mcp_read", "safe_action": "grants_catalog_get", "summary": "Get one program from PROGRAM_REGISTRY.yaml.", "title": "Grants Catalog Get", "when_to_use": "Read catalog row before patch.", "write_mode": null}, {"action": "grants.catalog.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.catalog.upsert", "mutation_risk": "low", "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "source": "overlay", "title": "Grants Catalog Upsert", "when_to_use": "Add or update a grant program in catalog without hand-editing YAML."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Add or update a grant program in catalog without hand-editing YAML.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.opportunity.upsert", "grants.crm.seed"], "required_cap": "project_admin", "safe_action": "grants_catalog_upsert", "summary": "Merge program fields into PROGRAM_REGISTRY.yaml (atomic backup).", "title": "Grants Catalog Upsert", "when_to_use": "Add or update a grant program in catalog without hand-editing YAML.", "write_mode": null}, {"action": "grants.applications.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.applications.patch", "mutation_risk": "low", "related_tools": ["grants.crm.transition", "grants.applications.detail"], "source": "overlay", "title": "Grants Applications Patch", "when_to_use": "Update grant row metadata without full transition."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Update grant row metadata without full transition.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.crm.transition", "grants.applications.detail"], "required_cap": "project_admin", "safe_action": "grants_applications_patch", "summary": "Partial CRM application update (title, deadline, apply_url, notes, evidence URLs).", "title": "Grants Applications Patch", "when_to_use": "Update grant row metadata without full transition.", "write_mode": null}, {"action": "grants.opportunity.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["frontend.grants.os.gen1"], "id": "grants.opportunity.upsert", "mutation_risk": "low", "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "source": "overlay", "title": "Grants Opportunity Upsert", "when_to_use": "Agent discovers a new grant — one call to register + CRM."}, "domain_title": "Grants Os MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["frontend.grants.os.gen1"], "instruction_hint": "Agent discovers a new grant — one call to register + CRM.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.grants_os", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "frontend.grants.os.gen1", "related_prompts": ["agentstack_grants_os_content"], "related_tools": ["grants.catalog.upsert", "grants.crm.sync"], "required_cap": "project_admin", "safe_action": "grants_opportunity_upsert", "summary": "Upsert catalog program + seed CRM row (+ optional packet sync) in one step.", "title": "Grants Opportunity Upsert", "when_to_use": "Agent discovers a new grant — one call to register + CRM.", "write_mode": null}], "guidance": [{"action": "guidance.list_capability_tasks", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_capability_tasks", "related_tools": ["discovery.get_platform_surfaces"], "source": "overlay", "title": "Guidance List Capability Tasks", "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["discovery.get_platform_surfaces"], "required_cap": "mcp_read", "safe_action": "guidance_list_capability_tasks", "summary": "List Platform Task Capability (PTC) atoms from shared/fixtures/capability_tasks_v1.json. Use before Compass playbooks with kind=capability or agentstack.execute task hints.", "title": "Guidance List Capability Tasks", "when_to_use": "Discover taskId, domain, and comfortBudget for platform micro-tasks.", "write_mode": null}, {"action": "guidance.list", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["core.mcp.guidance.gen1"], "id": "guidance.list", "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "source": "live", "title": "Guidance List", "when_to_use": "Discover canonical PlaybookIds before guidance.match_playbook or guidance.start_path."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Discover canonical PlaybookIds before guidance.match_playbook or guidance.start_path.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.start_path", "guidance.list_capability_tasks"], "required_cap": "mcp_read", "safe_action": "guidance_list", "summary": "List platform Compass playbook definitions plus tenant path overlays for a project. Mirror of REST GET /api/projects/{id}/guidance/definitions.", "title": "Guidance List", "when_to_use": "Discover canonical PlaybookIds before guidance.match_playbook or guidance.start_path.", "write_mode": null}, {"action": "guidance.recommend_skills", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.recommend_skills", "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "source": "overlay", "title": "Guidance Recommend Skills", "when_blocked": {"invalid_parameters": "Required param text missing (and project_id) — pass text=<user goal> plus context.project_id."}, "when_to_use": "External AI should see 3-5 instruction cards before raw MCP catalog. Pass text=<goal>."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "External AI should see 3-5 instruction cards before raw MCP catalog. Pass text=<goal>.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"skill_pack": {"description": "object", "type": "any"}, "skills": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.preview_instructions", "guidance.match_playbook", "discovery.search"], "required_cap": "project_admin", "safe_action": "guidance_recommend_skills", "summary": "Outcome-oriented skill pack for a goal (no LLM, no extra tools).", "title": "Guidance Recommend Skills", "when_blocked": {"invalid_parameters": "Required param text missing (and project_id) — pass text=<user goal> plus context.project_id."}, "when_to_use": "External AI should see 3-5 instruction cards before raw MCP catalog. Pass text=<goal>.", "write_mode": null}, {"action": "guidance.preview_instructions", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["core.mcp.guidance.gen1"], "id": "guidance.preview_instructions", "source": "live", "title": "Guidance Preview Instructions", "when_to_use": "Developer preview — what an agent receives for this user goal."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Developer preview — what an agent receives for this user goal.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"instruction_packet": {"description": "object", "type": "any"}, "route": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "required_cap": "mcp_read", "safe_action": "guidance_preview_instructions", "summary": "Read-only: route goal → playbook, quality, instruction packet, allowed actions (no LLM).", "title": "Guidance Preview Instructions", "when_to_use": "Developer preview — what an agent receives for this user goal.", "write_mode": null}, {"action": "guidance.match_playbook", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.match_playbook", "related_tools": ["guidance.path_status", "guidance.start_session"], "source": "overlay", "title": "Guidance Match Playbook", "when_to_use": "Start or recommend a Compass playbook from agent chat. Enriched compass_playbooks_intents_v1.json (51/51); response includes catalog_entry + verifyKinds."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Start or recommend a Compass playbook from agent chat. Enriched compass_playbooks_intents_v1.json…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "safe_action": "guidance_match_playbook", "summary": "Match natural-language goal text to a Platform Compass playbook id using bundled intent patterns + RU/EN synonyms. Returns verifyKinds for bot/commerce paths.", "title": "Guidance Match Playbook", "when_to_use": "Start or recommend a Compass playbook from agent chat. Enriched compass_playbooks_intents_v1.json (51/51); response includes catalog_entry + verifyKinds.", "write_mode": null}, {"action": "guidance.path_status", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.path_status", "related_tools": ["guidance.match_playbook", "bots.list"], "source": "overlay", "title": "Guidance Path Status", "when_to_use": "Check whether bot commerce path steps are satisfied without opening the SPA."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Check whether bot commerce path steps are satisfied without opening the SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "bots.list"], "required_cap": "mcp_read", "safe_action": "guidance_path_status", "summary": "Snapshot Compass verify gates for a project: botExists, botLive, botChannelAttached, hostedVitrinePublished. Use after playbook steps or before go-live checks.", "title": "Guidance Path Status", "when_to_use": "Check whether bot commerce path steps are satisfied without opening the SPA.", "write_mode": null}, {"action": "guidance.funnel_stats", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.funnel_stats", "related_tools": ["guidance.path_status", "guidance.start_session"], "source": "overlay", "title": "Guidance Funnel Stats", "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.start_session"], "required_cap": "mcp_read", "safe_action": "guidance_funnel_stats", "summary": "O(1) in-process Compass funnel counters for messaging-channel-bot: path_started, per-task completions, channel mix, dual_channel_attach. No database scan.", "title": "Guidance Funnel Stats", "when_to_use": "Ops/agent checks cross-user bot Compass funnel without OpTrace ring scan.", "write_mode": null}, {"action": "guidance.start_session", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.start_session", "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "source": "overlay", "title": "Guidance Start Session", "when_to_use": "External agent starts a guided bot/commerce path for a user."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "External agent starts a guided bot/commerce path for a user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.match_playbook", "guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "safe_action": "guidance_start_session", "summary": "Start a Platform Compass guidance session on the server (8DNA data.guidance). Use with messaging-channel-bot for cross-device resume.", "title": "Guidance Start Session", "when_to_use": "External agent starts a guided bot/commerce path for a user.", "write_mode": null}, {"action": "guidance.start_path", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.start_path", "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "source": "handler", "title": "Guidance Start Path", "when_to_use": "Agent starts any Compass playbook path (alias of guidance.start_session)."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "example_params": {"initial_answers": {}, "playbook_id": "example_string", "project_id": 123}, "genetic_tags": ["shared.guidance.gen1"], "inputSchema": {"properties": {"initial_answers": {"description": "Optional seed answers", "type": "object"}, "playbook_id": {"description": "Playbook id, e.g. host-static-site", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}}, "required": ["project_id", "playbook_id"], "type": "object"}, "instruction_hint": "Agent starts any Compass playbook path (alias of guidance.start_session).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.complete_step", "guidance.path_status"], "required_cap": "mcp_read", "rollback": [], "safe_action": "guidance_start_path", "summary": "Alias for guidance.start_session — start a Platform Compass guided path on the server. Prefer this name in agent playbooks; identical parameters and response.", "title": "Guidance Start Path", "verification": ["guidance.path_status", "guidance.get_session"], "verify": [{"action": "guidance.path_status", "predicate": "named resource is visible"}, {"action": "guidance.get_session", "predicate": "named resource is visible"}], "when_to_use": "Agent starts any Compass playbook path (alias of guidance.start_session).", "write_mode": null}, {"action": "guidance.record_step", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.record_step", "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "source": "overlay", "title": "Guidance Record Step", "when_to_use": "Record path progress after an agent completes a playbook step."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Record path progress after an agent completes a playbook step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.start_session", "guidance.get_session", "guidance.path_status"], "required_cap": "mcp_read", "safe_action": "guidance_record_step", "summary": "Patch an active guidance session state (answers, currentNodeId, completedNodeIds, percent). Agent parity with SPA pathServerSync step PATCH.", "title": "Guidance Record Step", "when_to_use": "Record path progress after an agent completes a playbook step.", "write_mode": null}, {"action": "guidance.list_active_sessions", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_sessions", "related_tools": ["guidance.get_session", "guidance.start_session"], "source": "overlay", "title": "Guidance List Active Sessions", "when_to_use": "Resume or inspect in-progress Compass paths from an agent."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Resume or inspect in-progress Compass paths from an agent.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.get_session", "guidance.start_session"], "required_cap": "mcp_read", "safe_action": "guidance_list_active_sessions", "summary": "List active guidance sessions for the authenticated user in a project.", "title": "Guidance List Active Sessions", "when_to_use": "Resume or inspect in-progress Compass paths from an agent.", "write_mode": null}, {"action": "guidance.list_active_paths", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.list_active_paths", "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "source": "overlay", "title": "Guidance List Active Paths", "when_to_use": "List in-progress guided paths before choosing resume or complete_step."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "List in-progress guided paths before choosing resume or complete_step.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.start_path", "guidance.complete_step"], "required_cap": "mcp_read", "safe_action": "guidance_list_active_paths", "summary": "Alias for guidance.list_active_sessions — active Compass paths with percent and state. Use for agent resume decisions.", "title": "Guidance List Active Paths", "when_to_use": "List in-progress guided paths before choosing resume or complete_step.", "write_mode": null}, {"action": "guidance.get_session", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["shared.guidance.gen1"], "id": "guidance.get_session", "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "source": "overlay", "title": "Guidance Get Session", "when_to_use": "Hydrate path state before completing or verifying steps."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Hydrate path state before completing or verifying steps.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.list_active_sessions", "guidance.record_step"], "required_cap": "mcp_read", "safe_action": "guidance_get_session", "summary": "Get one guidance session by id for the authenticated user.", "title": "Guidance Get Session", "when_to_use": "Hydrate path state before completing or verifying steps.", "write_mode": null}, {"action": "guidance.complete_step", "capability_descriptor": {"complexity": "intermediate", "domain": "guidance", "genetic_tags": ["frontend.platform.compass.gen1"], "id": "guidance.complete_step", "related_tools": ["guidance.path_status", "guidance.record_step"], "source": "overlay", "title": "Guidance Complete Step", "when_to_use": "Complete a playbook step after performing the underlying MCP/domain action."}, "domain_title": "Guidance MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["shared.guidance.gen1"], "instruction_hint": "Complete a playbook step after performing the underlying MCP/domain action.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "tenant_ops", "organ_id": "mcp.guidance", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "shared.guidance.gen1", "related_prompts": ["agentstack_plan_graph", "agentstack_plan_backlog_ops", "agentstack_inverse_orchestrator_playbook", "agentstack_guidance_compass"], "related_tools": ["guidance.path_status", "guidance.record_step"], "required_cap": "mcp_read", "safe_action": "guidance_complete_step", "summary": "Mark a guidance step complete with optional artifact after server verify gates. Agent parity with SPA completePathStep.", "title": "Guidance Complete Step", "when_to_use": "Complete a playbook step after performing the underlying MCP/domain action.", "write_mode": null}], "hosting": [{"action": "hosting.demo.status", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo.status", "source": "overlay", "title": "Hosting Demo Status", "when_to_use": "Public demo hosting pool status (enabled, depth, sandbox project id)."}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Public demo hosting pool status (enabled, depth, sandbox project id).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"enabled": {"description": "boolean", "type": "any"}, "pool_depth": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_demo_status", "summary": "Public demo hosting pool status (enabled, depth, sandbox project id).", "title": "Hosting Demo Status", "when_to_use": "Public demo hosting pool status (enabled, depth, sandbox project id).", "write_mode": null}, {"action": "hosting.demo_store.status", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.demo_store.status", "source": "overlay", "title": "Hosting Demo Store Status", "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`)."}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucke…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_name": {"description": "string", "type": "any"}, "build_id": {"description": "string?", "type": "any"}, "listing_count": {"description": "integer", "type": "any"}, "project_id": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_demo_store_status", "summary": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "title": "Hosting Demo Store Status", "when_to_use": "Golden promo demo-store vitrine: catalog row count on sandbox, published build id, manifest bucket (`frontend.commerce.hosted_storefront.gen1`).", "write_mode": null}, {"action": "hosting.site.quick_start", "aliases": ["hosting.bucket.create", "hosting.buckets.create", "hosting.create_site", "hosting.site.create", "sites.create"], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.quick_start", "mutation_risk": "low", "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "source": "handler", "title": "Hosting Site Quick Start", "when_to_use": "Only when hosting.project.status has no primary_public_url. An existing /s/ site is one hosting.bucket.file.patch search_replace, not a second bucket."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"html": "example_string", "project_id": 123, "publish": true, "slug": "example_string"}, "genetic_tags": ["core.hosting.bucket.gen1"], "inputSchema": {"properties": {"html": {"description": "Initial index.html body uploaded to the new bucket", "type": "string"}, "project_id": {"description": "Logical project id owning the hosted bucket", "type": "integer"}, "publish": {"description": "Publish to /s/{project_id}/{slug}/ after upload (default true)", "type": "boolean"}, "slug": {"description": "Bucket slug / name segment (default auto-generated)", "type": "string"}}, "required": ["project_id", "html"], "type": "object"}, "instruction_hint": "Only when hosting.project.status has no primary_public_url. An existing /s/ site is one hosting.b…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_id": {"description": "string", "type": "any"}, "bucket_name": {"description": "string", "type": "any"}, "public_path": {"description": "string", "type": "any"}, "url": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "related_tools": ["hosting.deploy_files", "hosting.release.promote", "hosting.project.status"], "required_cap": "project_admin", "rollback": [], "safe_action": "hosting_site_quick_start", "summary": "Create bucket, upload HTML index, optional publish; returns public /s/{project_id}/{bucket_name}/ URL.", "title": "Create Hosted Site", "verification": ["hosting.site.resolve", "hosting.project.status"], "verify": [{"action": "hosting.site.resolve", "predicate": "named resource is visible"}, {"action": "hosting.project.status", "predicate": "named resource is visible"}], "when_to_use": "Only when hosting.project.status has no primary_public_url. An existing /s/ site is one hosting.bucket.file.patch search_replace, not a second bucket.", "write_mode": null}, {"action": "hosting.site.resolve", "aliases": ["hosting.bucket.get"], "anti_pattern": "Resolve is not a file read. A known string is hosting.bucket.file.patch. GET only when the bytes are unknown.", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.resolve", "source": "overlay", "title": "Hosting Site Resolve", "when_to_use": "Resolve public /s/ URL and routing metadata for a bucket."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Resolve public /s/ URL and routing metadata for a bucket.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_id": {"description": "string", "type": "any"}, "bucket_name": {"description": "string", "type": "any"}, "public_path": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_site_resolve", "summary": "Resolve hosting bucket_name to bucket_id and public URL hints.", "title": "Hosting Site Resolve", "when_to_use": "Resolve public /s/ URL and routing metadata for a bucket.", "write_mode": null}, {"action": "hosting.files.put", "aliases": ["hosting.bucket.file.put"], "anti_pattern": "Many pages: one hosting.deploy_files batch, not parallel hosting.files.put (each put forks a generation).", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.files.put", "mutation_risk": "low", "source": "overlay", "title": "Hosting Files Put", "when_to_use": "Put one file into the active bucket tree."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "content_base64": "example_string", "path": "example_string", "project_id": 123}, "genetic_tags": ["core.hosting.bucket.gen1"], "inputSchema": {"properties": {"bucket_id": {"description": "", "type": "string"}, "bucket_name": {"description": "", "type": "string"}, "content": {"description": "", "type": "string"}, "content_base64": {"description": "", "type": "string"}, "path": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}}, "required": ["project_id", "path"], "type": "object"}, "instruction_hint": "Put one file into the active bucket tree.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bytes": {"description": "integer", "type": "any"}, "path": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "rollback": ["hosting.release.promote"], "safe_action": "hosting_files_put", "summary": "Upload or replace one file in a hosting bucket. Many files: one hosting.deploy_files call. List: hosting.bucket.files.list.", "title": "Hosting Files Put", "verification": ["hosting.bucket.files.list", "hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.files.list", "predicate": "named resource is visible"}, {"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_to_use": "Put one file into the active bucket tree.", "write_mode": null}, {"action": "hosting.release.snapshot", "aliases": ["releases.snapshot"], "anti_pattern": "Snapshot is not a file edit. HTML/CSS bytes are hosting.bucket.file.patch.", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.snapshot", "mutation_risk": "low", "source": "overlay", "title": "Hosting Release Snapshot", "when_to_use": "Recovery copy of the public site. Identical bytes return the existing release and do not copy. Not user storage and not app source. One text file is file.patch, not a snapshot."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Recovery copy of the public site. Identical bytes return the existing release and do not copy. No…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"release": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_release_snapshot", "summary": "Create immutable snapshot (archive bucket copy) for a site.", "title": "Hosting Release Snapshot", "when_to_use": "Recovery copy of the public site. Identical bytes return the existing release and do not copy. Not user storage and not app source. One text file is file.patch, not a snapshot.", "write_mode": null}, {"action": "hosting.release.list", "aliases": ["hosting.list", "releases.list"], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.list", "source": "overlay", "title": "Hosting Release List", "when_to_use": "List releases. To undo a publish, promote a prior release_uuid, not the head. Do not snapshot first."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "List releases. To undo a publish, promote a prior release_uuid, not the head. Do not snapshot first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"releases": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_release_list", "summary": "List site release history (newest first).", "title": "List Hosting Releases", "when_to_use": "List releases. To undo a publish, promote a prior release_uuid, not the head. Do not snapshot first.", "write_mode": null}, {"action": "hosting.release.promote", "aliases": ["hosting.rollback", "hosting.upgrade", "releases.promote"], "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.promote", "mutation_risk": "low", "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "source": "overlay", "title": "Hosting Release Promote", "when_to_use": "Promote a release generation live (rollback via prior release.promote)."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "example_params": {"project_id": 123, "release_uuid": "example_string"}, "genetic_tags": ["core.hosting.bucket.gen1"], "inputSchema": {"properties": {"project_id": {"description": "", "type": "integer"}, "release_uuid": {"description": "", "format": "uuid", "type": "string"}}, "required": ["project_id", "release_uuid"], "type": "object"}, "instruction_hint": "Promote a release generation live (rollback via prior release.promote).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"skipped": {"description": "boolean", "type": "any"}, "url": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "related_tools": ["hosting.release.list", "hosting.project.status", "hosting.site.edge_health"], "required_cap": "project_admin", "rollback": ["hosting.release.promote"], "safe_action": "hosting_release_promote", "summary": "Promote a release snapshot to the live site bucket and publish.", "title": "Promote Release", "verification": ["hosting.site.edge_health"], "verify": [{"action": "hosting.site.edge_health", "predicate": "ready"}], "when_to_use": "Promote a release generation live (rollback via prior release.promote).", "write_mode": null}, {"action": "hosting.release.delete", "aliases": ["hosting.release.prune", "releases.delete"], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.delete", "mutation_risk": "low", "source": "overlay", "title": "Hosting Release Delete", "when_to_use": "Delete an unpinned hosting release (optional bucket purge)."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Delete an unpinned hosting release (optional bucket purge).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_release_delete", "summary": "Delete an unpinned hosting release (optional bucket purge).", "title": "Hosting Release Delete", "when_to_use": "Delete an unpinned hosting release (optional bucket purge).", "write_mode": null}, {"action": "hosting.release.clone_site", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.release.clone_site", "mutation_risk": "low", "source": "overlay", "title": "Hosting Release Clone Site", "when_to_use": "Clone a new site from a release snapshot."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Clone a new site from a release snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"site": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_release_clone_site", "summary": "Clone a new site from a release snapshot.", "title": "Hosting Release Clone Site", "when_to_use": "Clone a new site from a release snapshot.", "write_mode": null}, {"action": "hosting.storage.import_folder", "anti_pattern": "Import moves storage → bucket. One text edit is hosting.bucket.file.patch, not a GET.", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.storage.import_folder", "mutation_risk": "low", "source": "overlay", "title": "Hosting Storage Import Folder", "when_to_use": "Bulk copy storage folder into site bucket — not for single-file patch."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Bulk copy storage folder into site bucket — not for single-file patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bytes_copied": {"description": "integer", "type": "any"}, "files_copied": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_storage_import_folder", "summary": "Import a project storage folder into a hosting bucket.", "title": "Hosting Storage Import Folder", "when_to_use": "Bulk copy storage folder into site bucket — not for single-file patch.", "write_mode": null}, {"action": "hosting.project.status", "aliases": ["hosting.bucket.usage", "hosting.site.get", "hosting.site.list", "hosting.sites.get", "hosting.sites.list"], "anti_pattern": "Do not read file content here — use hosting.bucket.file.get with bucket_id from plane.", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.status", "source": "overlay", "title": "Hosting Project Status", "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ladder": {"description": "object", "type": "any"}, "next_actions": {"description": "array", "type": "any"}, "sites": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_project_status", "summary": "Project hosting plane: Host/Sell/Scale ladder, sites summary, next_actions.", "title": "Inspect Project Hosting", "when_to_use": "Hosting plane overview — buckets and primary_public_url. This read does not start a file patch.", "write_mode": null}, {"action": "hosting.project.set_primary_site", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.project.set_primary_site", "mutation_risk": "low", "source": "overlay", "title": "Hosting Project Set Primary Site", "when_to_use": "Set the project's primary public site URL when multiple sites exist (PH-18)."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Set the project's primary public site URL when multiple sites exist (PH-18).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "boolean", "type": "any"}, "primary_site_bucket_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_project_set_primary_site", "summary": "Set the project's primary public site URL when multiple sites exist (PH-18).", "title": "Hosting Project Set Primary Site", "when_to_use": "Set the project's primary public site URL when multiple sites exist (PH-18).", "write_mode": null}, {"action": "hosting.site.edge_health", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.edge_health", "source": "overlay", "title": "Hosting Site Edge Health", "when_to_use": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"edge_ready": {"description": "boolean", "type": "any"}, "hints": {"description": "array", "type": "any"}, "live_url_ready": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_site_edge_health", "summary": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket.", "title": "Check Edge Health", "when_to_use": "Check nginx edge readiness (symlinks, index.html) for a hosting bucket.", "write_mode": null}, {"action": "hosting.deploy_files", "aliases": ["hosting.deploy", "hosting.publish"], "anti_pattern": "Do not deploy_files for one-line CSS — use hosting.bucket.file.patch.", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.deploy_files", "mutation_risk": "low", "related_tools": ["hosting.release.snapshot", "hosting.release.promote", "hosting.site.resolve"], "source": "handler", "title": "Hosting Deploy Files", "when_to_use": "Upload static files to a hosting bucket (HTML, assets, ZIP extract)."}, "domain_title": "Demo Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"bucket_id": "example_string", "bucket_name": "example_string", "dry_run": true, "files": [], "project_id": 123, "publish": true}, "genetic_tags": ["core.hosting.bucket.gen1"], "inputSchema": {"properties": {"bucket_id": {"description": "", "type": "string"}, "bucket_name": {"description": "", "type": "string"}, "dry_run": {"description": "Preview paths only. Does not write or publish.", "type": "boolean"}, "files": {"description": "[{path, content?|content_base64?}]", "type": "array"}, "project_id": {"description": "", "type": "integer"}, "publish": {"description": "", "type": "boolean"}}, "required": ["project_id", "files"], "type": "object"}, "instruction_hint": "Upload static files to a hosting bucket (HTML, assets, ZIP extract).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.demo_hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"paths": {"description": "array", "type": "any"}, "skipped": {"description": "boolean", "type": "any"}, "url": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "related_tools": ["hosting.release.snapshot", "hosting.release.promote", "hosting.site.resolve"], "required_cap": "project_admin", "rollback": ["hosting.release.promote"], "safe_action": "hosting_deploy_files", "summary": "Batch-upload files to a bucket and optionally publish (max 50 files per call).", "title": "Hosting Deploy Files", "verification": ["hosting.project.status", "hosting.site.edge_health"], "verify": [{"action": "hosting.project.status", "predicate": "named resource is visible"}, {"action": "hosting.site.edge_health", "predicate": "named resource is visible"}], "when_to_use": "Upload static files to a hosting bucket (HTML, assets, ZIP extract).", "write_mode": null}, {"action": "hosting.bucket.files.list", "aliases": ["hosting.bucket.file.list", "hosting.bucket.list", "hosting.bucket.list_files", "hosting.buckets.list", "hosting.files.list", "hosting.site.list_files"], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.list", "source": "overlay", "title": "Hosting Bucket Files List", "when_to_use": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring filter)."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring fil…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files": {"description": "array", "type": "any"}, "next_cursor": {"description": "string", "type": "any"}, "total": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_bucket_files_list", "summary": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring filter).", "title": "Hosting Bucket Files List", "when_to_use": "List files in a hosting bucket (optional prefix, cursor pagination, optional q path substring filter).", "write_mode": null}, {"action": "hosting.bucket.grep", "aliases": ["hosting.bucket.search", "hosting.files.grep"], "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.grep", "source": "overlay", "title": "Hosting Bucket Grep", "when_to_use": "Find which site files contain a string before batch search_replace patches."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Find which site files contain a string before batch search_replace patches.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files_scanned": {"description": "integer", "type": "any"}, "matches": {"description": "array", "type": "any"}, "truncated": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_bucket_grep", "summary": "Search UTF-8 bucket text files for a substring or regex. Optional glob (e.g. *.html) and prefix narrow the scan.", "title": "Hosting Bucket Grep", "when_to_use": "Find which site files contain a string before batch search_replace patches.", "write_mode": null}, {"action": "hosting.gc.ix", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.gc.ix", "source": "overlay", "title": "Hosting Gc Ix", "when_to_use": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix)."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dry_run": {"description": "boolean", "type": "any"}, "removed": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_gc_ix", "summary": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix).", "title": "Hosting Gc Ix", "when_to_use": "Prune orphan hosting_buckets/_ix symlinks (admin diagnostics broken_ix).", "write_mode": null}, {"action": "hosting.bucket.file.get", "anti_pattern": "Do not use storage.upload to read /s/ site files.", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.get", "source": "overlay", "title": "Hosting Bucket File Get", "when_to_use": "Read site bytes when the edit is unknown. A long file returns a window; pass offset. A known search_replace skips this GET."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Read site bytes when the edit is unknown. A long file returns a window; pass offset. A known sear…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"content": {"description": "string", "type": "any"}, "content_sha256": {"description": "string", "type": "any"}, "encoding": {"description": "string", "type": "any"}, "next_offset": {"description": "integer", "type": "any"}, "path": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_bucket_file_get", "summary": "Read a single bucket file (text or base64, max 2MB).", "title": "Hosting Bucket File Get", "when_to_use": "Read site bytes when the edit is unknown. A long file returns a window; pass offset. A known search_replace skips this GET.", "write_mode": null}, {"action": "hosting.bucket.file.patch", "ai_tips": "One HTML/CSS/JS edit on /s/. Omit bucket_id. Identical bytes skip gzip. A real change refreshes the .gz sibling. Do not delete it.", "aliases": ["hosting.bucket.file.content_patch", "hosting.file.patch", "hosting.files.patch"], "anti_pattern": "Do not use storage.upload for in-place site edits.", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1", "core.hosting.mcp_file_edit.gen1"], "id": "hosting.bucket.file.patch", "mutation_risk": "low", "source": "overlay", "title": "Hosting Bucket File Patch", "when_blocked": {"content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "extension_not_patchable": "Text patch allows html, css, js, ts, json, md, txt, svg only", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "site_not_found": "hosting.project.status — confirm primary site before file ops", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch"}, "when_to_use": "One HTML/CSS/JS edit on /s/. Omit bucket_id. Identical bytes skip gzip. A real change refreshes the .gz sibling. Do not delete it."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "example_params": {"allow_shrink": true, "bucket_id": "example_string", "bucket_name": "example_string", "content": "example_string", "dry_run": true, "expected_sha256": "example_string", "path": "example_string", "project_id": 123, "replacements": [], "strict_diff": true, "unified_diff": "example_string", "write_mode": "example_string"}, "genetic_tags": ["core.hosting.bucket.gen1"], "inputSchema": {"properties": {"allow_shrink": {"description": "", "type": "boolean"}, "bucket_id": {"description": "", "type": "string"}, "bucket_name": {"description": "", "type": "string"}, "content": {"description": "", "type": "string"}, "dry_run": {"description": "", "type": "boolean"}, "expected_sha256": {"description": "", "type": "string"}, "path": {"description": "", "type": "string"}, "project_id": {"description": "Defaults to context.project_id when omitted.", "type": "integer"}, "replacements": {"description": "search_replace only: [{\"find\":\"text\",\"replace\":\"new\"}] (aliases search/old deprecated)", "type": "array"}, "strict_diff": {"description": "", "type": "boolean"}, "unified_diff": {"description": "", "type": "string"}, "write_mode": {"description": "replace|append|prepend|unified_diff|search_replace", "type": "string"}}, "required": ["path", "write_mode"], "type": "object"}, "instruction_hint": "One HTML/CSS/JS edit on /s/. Omit bucket_id. Identical bytes skip gzip. A real change refreshes t…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"apply_method": {"description": "string", "type": "any"}, "content_sha256": {"description": "string", "type": "any"}, "dry_run": {"description": "boolean", "type": "any"}, "path": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "rollback": ["hosting.release.promote"], "safe_action": "hosting_bucket_file_patch", "summary": "Patch one UTF-8 bucket text file. search_replace does not need a prior GET. Omit bucket_id on the primary site. Identical bytes skip the disk write and gzip. A real change refreshes the .gz sibling an", "title": "Patch Hosted File", "verification": ["hosting.bucket.file.get"], "verify": [{"action": "hosting.bucket.file.get", "predicate": "named resource is visible"}], "when_blocked": {"content_shrink_blocked": "allow_shrink=true when intentional, else search_replace for a partial edit", "extension_not_patchable": "Text patch allows html, css, js, ts, json, md, txt, svg only", "patch_apply_failed": "hosting.bucket.file.get, then search_replace or strict_diff=true", "replacement_not_found": "search_replace needs find and replace — hosting.bucket.file.get and confirm the substring", "site_not_found": "hosting.project.status — confirm primary site before file ops", "validation_error": "content_base64: strip whitespace, pad to length % 4 — or use UTF-8 content / hosting.bucket.file.patch"}, "when_to_use": "One HTML/CSS/JS edit on /s/. Omit bucket_id. Identical bytes skip gzip. A real change refreshes the .gz sibling. Do not delete it.", "write_mode": null}, {"action": "hosting.site.delete", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.site.delete", "mutation_risk": "low", "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "source": "overlay", "title": "Hosting Site Delete", "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slu…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bucket_id": {"description": "string", "type": "any"}, "purged": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "related_tools": ["hosting.release.snapshot", "hosting.project.status"], "required_cap": "project_admin", "safe_action": "hosting_site_delete", "summary": "Remove a hosted site bucket (same as REST DELETE /api/hosting/buckets/{bucket_id}).", "title": "Hosting Site Delete", "when_to_use": "Remove one hosted /s/ bucket. Read hosting.project.status first and delete only the duplicate slug, not the primary site.", "write_mode": null}, {"action": "hosting.bucket.file.rename", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.file.rename", "mutation_risk": "low", "source": "overlay", "title": "Hosting Bucket File Rename", "when_to_use": "Rename or move a file within a bucket."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Rename or move a file within a bucket.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"from": {"description": "string", "type": "any"}, "to": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_bucket_file_rename", "summary": "Rename or move a file within a bucket.", "title": "Hosting Bucket File Rename", "when_to_use": "Rename or move a file within a bucket.", "write_mode": null}, {"action": "hosting.bucket.files.bulk_delete", "capability_descriptor": {"complexity": "simple", "domain": "hosting", "genetic_tags": ["core.hosting.bucket.gen1"], "id": "hosting.bucket.files.bulk_delete", "mutation_risk": "low", "source": "overlay", "title": "Hosting Bucket Files Bulk Delete", "when_to_use": "Delete multiple files by path list or prefix."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "Delete multiple files by path list or prefix.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "integer", "type": "any"}, "deleted": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "project_admin", "safe_action": "hosting_bucket_files_bulk_delete", "summary": "Delete multiple files by path list or prefix.", "title": "Hosting Bucket Files Bulk Delete", "when_to_use": "Delete multiple files by path list or prefix.", "write_mode": null}, {"action": "hosting.visual.inspect", "capability_descriptor": {"complexity": "intermediate", "domain": "hosting", "genetic_tags": ["core.mcp.hosting.gen1"], "id": "hosting.visual.inspect", "source": "overlay", "title": "Hosting Visual Inspect", "when_to_use": "After publish — verify layout overflow and CTA presence at mobile/desktop widths."}, "domain_title": "Hosting MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.hosting.bucket.gen1"], "instruction_hint": "After publish — verify layout overflow and CTA presence at mobile/desktop widths.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.hosting", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"artifacts": {"description": "array", "type": "any"}, "checks": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.hosting.bucket.gen1", "related_prompts": ["agentstack_key2unity_site", "agentstack_hosting_storefront", "agentstack_hosting_edit_site", "agentstack_hosting_static_landing", "agentstack_hosting_react_dist", "agentstack_hosting_file_edit"], "required_cap": "mcp_read", "safe_action": "hosting_visual_inspect", "summary": "Capture viewport screenshots for visual QA (375 and 1440). Requires preview_url.", "title": "Hosting Visual Inspect", "when_to_use": "After publish — verify layout overflow and CTA presence at mobile/desktop widths.", "write_mode": null}], "integrations": [{"action": "integrations.list_recipes", "aliases": ["discovery.list_recipes"], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_recipes", "source": "overlay", "title": "Integrations List Recipes", "when_to_use": "Discover installable integration recipes before install_recipe."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Discover installable integration recipes before install_recipe.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"recipes": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_recipes", "summary": "List integration recipe templates (Stripe, GitHub, Telegram, etc.).", "title": "List Integration Recipes", "when_to_use": "Discover installable integration recipes before install_recipe.", "write_mode": null}, {"action": "integrations.install_recipe", "aliases": ["webhooks.create_endpoint", "webhooks.register"], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.install_recipe", "mutation_risk": "low", "related_tools": ["integrations.list_connections", "integrations.test_hook", "logic.create"], "source": "handler", "title": "Integrations Install Recipe", "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "recipe_id": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"idempotency_key": {"description": "Client-supplied dedupe key; retrying with the same key within 24h returns a duplicate_request error instead of installing twice", "type": "string"}, "label": {"description": "Connection label", "type": "string"}, "owner_kind": {"description": "project (default) | personal", "type": "string"}, "project_id": {"description": "Tenant project id", "type": "integer"}, "recipe_id": {"description": "Recipe id", "type": "string"}, "secrets": {"description": "Provider secrets (stored in protected, never in 8DNA data)", "type": "object"}, "slug": {"description": "Inbound hook slug", "type": "string"}, "user_id": {"description": "Acting user id (defaults to context user_id)", "type": "integer"}}, "required": ["recipe_id", "project_id"], "type": "object"}, "instruction_hint": "Install inbound/outbound recipe — replaces legacy webhooks.register.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection_id": {"description": "string", "type": "any"}, "hook_url": {"description": "string", "type": "any"}, "logic_id": {"description": "string", "type": "any"}, "owner_kind": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.test_hook", "logic.create"], "required_cap": "project_admin", "rollback": ["generation.realign_to_prod"], "safe_action": "integrations_install_recipe", "summary": "Install a recipe: creates connection + declarative logic rule.", "title": "Integrations Install Recipe", "verification": ["integrations.list_connections", "integrations.connection_health"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}, {"action": "integrations.connection_health", "predicate": "named resource is visible"}], "when_to_use": "Install inbound/outbound recipe — replaces legacy webhooks.register.", "write_mode": null}, {"action": "integrations.list_connections", "aliases": ["webhooks.get", "webhooks.list"], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_connections", "related_tools": ["integrations.rotate_secret", "integrations.replay_delivery"], "source": "handler", "title": "Integrations List Connections", "when_to_use": "List hooks and connectors for the project scope."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"owner_kind": {"description": "project (default) | personal", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "provider": {"description": "Filter by provider", "type": "string"}, "user_id": {"description": "Required for personal scope when not inferable from context", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "List hooks and connectors for the project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connections": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.rotate_secret", "integrations.replay_delivery"], "required_cap": "mcp_read", "safe_action": "integrations_list_connections", "summary": "List integration connections for project or personal (ecosystem user) scope.", "title": "Integrations List Connections", "when_to_use": "List hooks and connectors for the project scope.", "write_mode": null}, {"action": "integrations.get_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_connection", "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "source": "overlay", "title": "Integrations Get Connection", "when_to_use": "Load connector config after integrations.list_connections."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Load connector config after integrations.list_connections.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "object", "type": "any"}, "secrets_redacted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.list_connections", "integrations.delete_connection"], "required_cap": "mcp_read", "safe_action": "integrations_get_connection", "summary": "Get integration connection metadata (secrets redacted).", "title": "Integrations Get Connection", "when_to_use": "Load connector config after integrations.list_connections.", "write_mode": null}, {"action": "integrations.delete_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.delete_connection", "related_tools": ["integrations.get_connection", "integrations.list_connections"], "source": "overlay", "title": "Integrations Delete Connection", "when_to_use": "Rollback after certification or remove stale connectors."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rollback after certification or remove stale connectors.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.get_connection", "integrations.list_connections"], "required_cap": "mcp_read", "safe_action": "integrations_delete_connection", "summary": "Delete an integration connection and unregister webhook bindings.", "title": "Integrations Delete Connection", "when_to_use": "Rollback after certification or remove stale connectors.", "write_mode": null}, {"action": "integrations.create_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_connection", "mutation_risk": "low", "related_tools": ["integrations.install_recipe", "integrations.list_connections"], "source": "overlay", "title": "Integrations Create Connection", "when_to_use": "Low-level connector birth when no recipe covers the provider."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"config": {}, "direction": "example_string", "generation": 123, "idempotency_key": "example_string", "label": "example_string", "owner_kind": "example_string", "project_id": 123, "provider": "example_string", "secrets": {}, "slug": "example_string", "user_id": 123}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"config": {"description": "Non-secret config", "type": "object"}, "direction": {"description": "inbound | outbound | bidirectional (default bidirectional)", "type": "string"}, "generation": {"description": "Sandbox generation anchor when auto_generation_mode is on", "type": "integer"}, "idempotency_key": {"description": "Dedupe retries within 24h (409 duplicate_request on collision)", "type": "string"}, "label": {"description": "Human label", "type": "string"}, "owner_kind": {"description": "project (default) | personal", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "provider": {"description": "Connector provider id", "type": "string"}, "secrets": {"description": "Signing secrets (protected column, not 8DNA data)", "type": "object"}, "slug": {"description": "URL slug / hook segment", "type": "string"}, "user_id": {"description": "Required for personal scope when not inferable from context", "type": "integer"}}, "required": ["project_id", "provider", "label", "slug"], "type": "object"}, "instruction_hint": "Low-level connector birth when no recipe covers the provider.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "related_tools": ["integrations.install_recipe", "integrations.list_connections"], "required_cap": "project_admin", "rollback": ["integrations.delete_connection"], "safe_action": "integrations_create_connection", "summary": "Create an integration connection (REST POST /api/integrations/connections parity). Prefer integrations.install_recipe for packaged inbound webhooks.", "title": "Integrations Create Connection", "verification": ["integrations.list_connections"], "verify": [{"action": "integrations.list_connections", "predicate": "named resource is visible"}], "when_to_use": "Low-level connector birth when no recipe covers the provider.", "write_mode": null}, {"action": "integrations.test_hook", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.test_hook", "source": "handler", "title": "Integrations Test Hook", "when_to_use": "Dry-run inbound hook signature + payload mapping."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"body_json": {"description": "Sample JSON body (object)", "type": "object"}, "headers": {"description": "HTTP headers map for signature verify", "type": "object"}, "owner_kind": {"description": "project (default) | personal", "type": "string"}, "project_id": {"description": "Project id", "type": "integer"}, "provider": {"description": "Provider id", "type": "string"}, "slug": {"description": "Connection slug", "type": "string"}, "user_id": {"description": "Personal scope user id", "type": "integer"}}, "required": ["project_id", "provider", "slug"], "type": "object"}, "instruction_hint": "Dry-run inbound hook signature + payload mapping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"duplicate": {"description": "bool", "type": "any"}, "matched": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_test_hook", "summary": "Dry-run inbound hook verify + normalize (sync dispatch to logic).", "title": "Integrations Test Hook", "when_to_use": "Dry-run inbound hook signature + payload mapping.", "write_mode": null}, {"action": "integrations.export_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection", "source": "overlay", "title": "Integrations Export Connection", "when_to_use": "Export connection public spec + config (secrets redacted)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Export connection public spec + config (secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "object", "type": "any"}, "secrets_redacted": {"description": "bool", "type": "any"}, "version": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_export_connection", "summary": "Export connection public spec + config (secrets redacted).", "title": "Integrations Export Connection", "when_to_use": "Export connection public spec + config (secrets redacted).", "write_mode": null}, {"action": "integrations.import_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_connection", "mutation_risk": "low", "source": "overlay", "title": "Integrations Import Connection", "when_to_use": "Import connection from export JSON (optionally with secrets)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Import connection from export JSON (optionally with secrets).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "project_admin", "safe_action": "integrations_import_connection", "summary": "Import connection from export JSON (optionally with secrets).", "title": "Integrations Import Connection", "when_to_use": "Import connection from export JSON (optionally with secrets).", "write_mode": null}, {"action": "integrations.rotate_secret", "aliases": ["webhooks.rotate_secret"], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.rotate_secret", "mutation_risk": "low", "source": "handler", "title": "Integrations Rotate Secret", "when_to_use": "Rotate signing secret atomically for a connection."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"connection_id": {"description": "", "type": "string"}, "key": {"description": "", "type": "string"}, "value": {"description": "", "type": "string"}}, "required": ["connection_id", "key", "value"], "type": "object"}, "instruction_hint": "Rotate signing secret atomically for a connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "project_admin", "safe_action": "integrations_rotate_secret", "summary": "Rotate a protected secret key for a connection.", "title": "Integrations Rotate Secret", "when_to_use": "Rotate signing secret atomically for a connection.", "write_mode": null}, {"action": "integrations.replay_delivery", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery", "source": "handler", "title": "Integrations Replay Delivery", "when_to_use": "Replay outbound delivery by durable delivery_id (execution log)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "inputSchema": {"properties": {"delivery_id": {"description": "", "type": "string"}, "owner_kind": {"description": "project (default) or personal", "type": "string"}, "project_id": {"description": "", "type": "integer"}, "user_id": {"description": "Required when owner_kind=personal", "type": "integer"}}, "required": ["project_id", "delivery_id"], "type": "object"}, "instruction_hint": "Replay outbound delivery by durable delivery_id (execution log).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_replay_delivery", "summary": "Replay outbound delivery by durable delivery_id (execution log).", "title": "Integrations Replay Delivery", "when_to_use": "Replay outbound delivery by durable delivery_id (execution log).", "write_mode": null}, {"action": "integrations.replay_delivery_url", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.replay_delivery_url", "source": "overlay", "title": "Integrations Replay Delivery Url", "when_to_use": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_replay_delivery_url", "summary": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query).", "title": "Integrations Replay Delivery Url", "when_to_use": "Replay outbound POST to an explicit target_url (same as REST deliveries/replay query).", "write_mode": null}, {"action": "integrations.connection_health", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connection_health", "source": "overlay", "title": "Integrations Connection Health", "when_to_use": "Read connection health snapshot (public spec only)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Read connection health snapshot (public spec only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"health": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_connection_health", "summary": "Read connection health snapshot (public spec only).", "title": "Integrations Connection Health", "when_to_use": "Read connection health snapshot (public spec only).", "write_mode": null}, {"action": "integrations.connector_schema", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.connector_schema", "source": "overlay", "title": "Integrations Connector Schema", "when_to_use": "Provider setup schema metadata for wizard/agents."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Provider setup schema metadata for wizard/agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"schema": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_connector_schema", "summary": "Provider setup schema (required secrets, setup_steps, quick_setup) — call before install_recipe or create_connection so agents know which secrets= keys to pass.", "title": "Read Connector Schema", "when_to_use": "Provider setup schema metadata for wizard/agents.", "write_mode": null}, {"action": "integrations.process_inbox_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_inbox_batch", "source": "overlay", "title": "Integrations Process Inbox Batch", "when_to_use": "Process durable inbound integration inbox (worker-style batch)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process durable inbound integration inbox (worker-style batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"outcomes": {"description": "list", "type": "any"}, "processed": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_process_inbox_batch", "summary": "Process durable inbound integration inbox (worker-style batch).", "title": "Integrations Process Inbox Batch", "when_to_use": "Process durable inbound integration inbox (worker-style batch).", "write_mode": null}, {"action": "integrations.process_outbound_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.process_outbound_batch", "source": "overlay", "title": "Integrations Process Outbound Batch", "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"outcomes": {"description": "list", "type": "any"}, "processed": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_process_outbound_batch", "summary": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "title": "Integrations Process Outbound Batch", "when_to_use": "Process outbound webhook delivery work queue (webhooks.outbound batch).", "write_mode": null}, {"action": "integrations.process_polling_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.process_polling_batch", "source": "overlay", "title": "Integrations Process Polling Batch", "when_to_use": "Poll due integration connections (config.poll_enabled, cursor watermark)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Poll due integration connections (config.poll_enabled, cursor watermark).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"outcomes": {"description": "list", "type": "any"}, "processed": {"description": "int", "type": "any"}, "skipped_not_due": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_process_polling_batch", "summary": "Poll due integration connections (config.poll_enabled, cursor watermark).", "title": "Integrations Process Polling Batch", "when_to_use": "Poll due integration connections (config.poll_enabled, cursor watermark).", "write_mode": null}, {"action": "integrations.hydrate_triggers", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.hydrate_triggers", "source": "overlay", "title": "Integrations Hydrate Triggers", "when_to_use": "Hydrate integration trigger registry from connection DNA (cold start recovery)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Hydrate integration trigger registry from connection DNA (cold start recovery).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"errors": {"description": "list", "type": "any"}, "hydrated_bindings": {"description": "int", "type": "any"}, "logic_rules_scanned": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_hydrate_triggers", "summary": "Hydrate integration trigger registry from connection DNA (cold start recovery).", "title": "Integrations Hydrate Triggers", "when_to_use": "Hydrate integration trigger registry from connection DNA (cold start recovery).", "write_mode": null}, {"action": "integrations.rebind_triggers", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.rebind_triggers", "source": "overlay", "title": "Integrations Rebind Triggers", "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Re-sync enabled logic rule triggers for a project or all connection projects.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"projects_scanned": {"description": "int", "type": "any"}, "rebound_rules": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_rebind_triggers", "summary": "Re-sync enabled logic rule triggers for a project or all connection projects.", "title": "Integrations Rebind Triggers", "when_to_use": "Re-sync enabled logic rule triggers for a project or all connection projects.", "write_mode": null}, {"action": "integrations.list_inbox_events", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_inbox_events", "source": "overlay", "title": "Integrations List Inbox Events", "when_to_use": "List durable integration inbox audit rows for a project."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List durable integration inbox audit rows for a project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"events": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_inbox_events", "summary": "List durable integration inbox audit rows for a project.", "title": "Integrations List Inbox Events", "when_to_use": "List durable integration inbox audit rows for a project.", "write_mode": null}, {"action": "integrations.replay_inbox", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.replay_inbox", "source": "overlay", "title": "Integrations Replay Inbox", "when_to_use": "Replay a durable inbox event through the test-hook intake path."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Replay a durable inbox event through the test-hook intake path.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"duplicate": {"description": "bool", "type": "any"}, "matched": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_replay_inbox", "summary": "Replay a durable inbox event through the test-hook intake path.", "title": "Integrations Replay Inbox", "when_to_use": "Replay a durable inbox event through the test-hook intake path.", "write_mode": null}, {"action": "integrations.export_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.export_scenario", "source": "overlay", "title": "Integrations Export Scenario", "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"export_version": {"description": "int", "type": "any"}, "format": {"description": "string", "type": "any"}, "scenario": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_export_scenario", "summary": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "title": "Integrations Export Scenario", "when_to_use": "Export portable scenario bundle (rule document + field maps, secrets redacted).", "write_mode": null}, {"action": "integrations.preview_scenario_maps", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.preview_scenario_maps", "source": "overlay", "title": "Integrations Preview Scenario Maps", "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Evaluate scenario field maps against a sample payload (secrets redacted).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"field_maps_count": {"description": "int", "type": "any"}, "preview": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_preview_scenario_maps", "summary": "Evaluate scenario field maps against a sample payload (secrets redacted).", "title": "Integrations Preview Scenario Maps", "when_to_use": "Evaluate scenario field maps against a sample payload (secrets redacted).", "write_mode": null}, {"action": "integrations.generate_signing_secret", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.generate_signing_secret", "mutation_risk": "low", "source": "overlay", "title": "Integrations Generate Signing Secret", "when_to_use": "Rotate signing_secret server-side without reading the old value."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Rotate signing_secret server-side without reading the old value.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection_id": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "project_admin", "safe_action": "integrations_generate_signing_secret", "summary": "Rotate signing_secret server-side without reading the old value.", "title": "Integrations Generate Signing Secret", "when_to_use": "Rotate signing_secret server-side without reading the old value.", "write_mode": null}, {"action": "integrations.export_connection_manifest", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.export_connection_manifest", "source": "overlay", "title": "Integrations Export Connection Manifest", "when_to_use": "Export project integration connections as JSON manifest for agent tool loops."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Export project integration connections as JSON manifest for agent tool loops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connections": {"description": "list", "type": "any"}, "version": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_export_connection_manifest", "summary": "Export project integration connections as JSON manifest for agent tool loops.", "title": "Integrations Export Connection Manifest", "when_to_use": "Export project integration connections as JSON manifest for agent tool loops.", "write_mode": null}, {"action": "integrations.import_zapier_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_zapier_preview", "mutation_risk": "low", "source": "overlay", "title": "Integrations Import Zapier Preview", "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dry_run": {"description": "bool", "type": "any"}, "preview": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_import_zapier_preview", "summary": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "title": "Integrations Import Zapier Preview", "when_to_use": "Dry-run preview: map Zapier export JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.import_make_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.import_make_preview", "mutation_risk": "low", "source": "overlay", "title": "Integrations Import Make Preview", "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dry_run": {"description": "bool", "type": "any"}, "preview": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_import_make_preview", "summary": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "title": "Integrations Import Make Preview", "when_to_use": "Dry-run preview: map Make scenario JSON to recipe + logic block draft.", "write_mode": null}, {"action": "integrations.list_issues", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.list_issues", "source": "overlay", "title": "Integrations List Issues", "when_to_use": "Cluster failed outbound deliveries into issues (Hookdeck-style)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cluster failed outbound deliveries into issues (Hookdeck-style).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"issues": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_issues", "summary": "Cluster failed outbound deliveries into issues (Hookdeck-style).", "title": "Integrations List Issues", "when_to_use": "Cluster failed outbound deliveries into issues (Hookdeck-style).", "write_mode": null}, {"action": "integrations.get_diagnostics", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.get_diagnostics", "source": "overlay", "title": "Integrations Get Diagnostics", "when_to_use": "Integration Hub diagnostics rollup and worker flags."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Integration Hub diagnostics rollup and worker flags.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connections_count": {"description": "int", "type": "any"}, "hints": {"description": "list", "type": "any"}, "metrics": {"description": "object", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "rollup_7d": {"description": "object", "type": "any"}, "runbook": {"description": "string", "type": "any"}, "workers": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_get_diagnostics", "summary": "Integration Hub diagnostics rollup and worker flags.", "title": "Integrations Get Diagnostics", "when_to_use": "Integration Hub diagnostics rollup and worker flags.", "write_mode": null}, {"action": "integrations.get_platform_diagnostics", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_platform_diagnostics", "source": "overlay", "title": "Integrations Get Platform Diagnostics", "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Cross-tenant Integration Hub rollup (platform admin ops).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connections_total": {"description": "int", "type": "any"}, "poll_enabled_connections": {"description": "int", "type": "any"}, "registered_modules_total": {"description": "int", "type": "any"}, "rollup_7d": {"description": "object", "type": "any"}, "top_projects": {"description": "list", "type": "any"}, "workers": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_get_platform_diagnostics", "summary": "Cross-tenant Integration Hub rollup (platform admin ops).", "title": "Integrations Get Platform Diagnostics", "when_to_use": "Cross-tenant Integration Hub rollup (platform admin ops).", "write_mode": null}, {"action": "integrations.get_hubspot_relay_stats", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_hubspot_relay_stats", "source": "overlay", "title": "Integrations Get Hubspot Relay Stats", "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"hubspot_relay": {"description": "object", "type": "any"}, "runbook": {"description": "string", "type": "any"}, "workers": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_get_hubspot_relay_stats", "summary": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "title": "Integrations Get Hubspot Relay Stats", "when_to_use": "HubSpot platform relay rollup (7d success/denied/no-connection/missing portal).", "write_mode": null}, {"action": "integrations.migrate_legacy_webhooks", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.migrate_legacy_webhooks", "source": "overlay", "title": "Integrations Migrate Legacy Webhooks", "when_to_use": "Copy projects.config.webhooks into integration_connection rows."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Copy projects.config.webhooks into integration_connection rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection_ids": {"description": "list", "type": "any"}, "migrated": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_migrate_legacy_webhooks", "summary": "Copy projects.config.webhooks into integration_connection rows.", "title": "Integrations Migrate Legacy Webhooks", "when_to_use": "Copy projects.config.webhooks into integration_connection rows.", "write_mode": null}, {"action": "integrations.poll_connection", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.mcp.integrations.gen1"], "id": "integrations.poll_connection", "source": "overlay", "title": "Integrations Poll Connection", "when_to_use": "Run connector polling for a connection (cursor watermark in config.poll_state)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Run connector polling for a connection (cursor watermark in config.poll_state).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "polled": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_poll_connection", "summary": "Run connector polling for a connection (cursor watermark in config.poll_state).", "title": "Integrations Poll Connection", "when_to_use": "Run connector polling for a connection (cursor watermark in config.poll_state).", "write_mode": null}, {"action": "integrations.oauth_begin", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.oauth_begin", "source": "overlay", "title": "Integrations Oauth Begin", "when_to_use": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"authorization_url": {"description": "string", "type": "any"}, "connection_id": {"description": "string", "type": "any"}, "state": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_oauth_begin", "summary": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url).", "title": "Integrations Oauth Begin", "when_to_use": "Start OAuth 2.0 PKCE flow for an integration connection (returns authorization_url).", "write_mode": null}, {"action": "integrations.refresh_token", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.refresh_token", "source": "overlay", "title": "Integrations Refresh Token", "when_to_use": "Refresh OAuth access token for a connection when expired (protected storage)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Refresh OAuth access token for a connection when expired (protected storage).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection_id": {"description": "string", "type": "any"}, "refreshed": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_refresh_token", "summary": "Refresh OAuth access token for a connection when expired (protected storage).", "title": "Integrations Refresh Token", "when_to_use": "Refresh OAuth access token for a connection when expired (protected storage).", "write_mode": null}, {"action": "integrations.activate_webhook", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.activate_webhook", "source": "overlay", "title": "Integrations Activate Webhook", "when_to_use": "Register provider inbound webhook for a connection (post-OAuth or manual retry)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Register provider inbound webhook for a connection (post-OAuth or manual retry).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activation": {"description": "object", "type": "any"}, "auto_activated": {"description": "bool", "type": "any"}, "connection_id": {"description": "string", "type": "any"}, "hook_url": {"description": "string", "type": "any"}, "provider": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_activate_webhook", "summary": "Register provider inbound webhook for a connection (post-OAuth or manual retry).", "title": "Integrations Activate Webhook", "when_to_use": "Register provider inbound webhook for a connection (post-OAuth or manual retry).", "write_mode": null}, {"action": "integrations.update_connection", "aliases": ["webhooks.delete"], "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.update_connection", "source": "overlay", "title": "Integrations Update Connection", "when_to_use": "Patch integration connection metadata (label, status, config, direction)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Patch integration connection metadata (label, status, config, direction).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"connection": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_update_connection", "summary": "Patch integration connection metadata (label, status, config, direction).", "title": "Integrations Update Connection", "when_to_use": "Patch integration connection metadata (label, status, config, direction).", "write_mode": null}, {"action": "integrations.list_scenarios", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenarios", "source": "overlay", "title": "Integrations List Scenarios", "when_to_use": "List integration scenarios for a project scope."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration scenarios for a project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"scenarios": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_scenarios", "summary": "List integration scenarios for a project scope.", "title": "Integrations List Scenarios", "when_to_use": "List integration scenarios for a project scope.", "write_mode": null}, {"action": "integrations.create_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.create_scenario", "source": "overlay", "title": "Integrations Create Scenario", "when_to_use": "Create a draft integration scenario with backing logic rule."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Create a draft integration scenario with backing logic rule.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"scenario": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_create_scenario", "summary": "Create a draft integration scenario with backing logic rule.", "title": "Integrations Create Scenario", "when_to_use": "Create a draft integration scenario with backing logic rule.", "write_mode": null}, {"action": "integrations.save_scenario_draft", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.save_scenario_draft", "source": "overlay", "title": "Integrations Save Scenario Draft", "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"scenario": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_save_scenario_draft", "summary": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "title": "Integrations Save Scenario Draft", "when_to_use": "Save scenario draft (spec and/or logic patch). Parity with REST POST /scenarios/{id}/draft.", "write_mode": null}, {"action": "integrations.unpublish_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.unpublish_scenario", "source": "overlay", "title": "Integrations Unpublish Scenario", "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"scenario": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_unpublish_scenario", "summary": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "title": "Integrations Unpublish Scenario", "when_to_use": "Unpublish scenario (pause) and disable backing logic. Parity with REST unpublish.", "write_mode": null}, {"action": "integrations.publish_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.publish_scenario", "source": "overlay", "title": "Integrations Publish Scenario", "when_to_use": "Publish scenario (live) and enable backing logic."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Publish scenario (live) and enable backing logic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"scenario": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_publish_scenario", "summary": "Publish scenario (live) and enable backing logic.", "title": "Integrations Publish Scenario", "when_to_use": "Publish scenario (live) and enable backing logic.", "write_mode": null}, {"action": "integrations.test_scenario_step", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.test_scenario_step", "source": "overlay", "title": "Integrations Test Scenario Step", "when_to_use": "Dry-run a scenario step via logic simulation."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Dry-run a scenario step via logic simulation.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"run_id": {"description": "string", "type": "any"}, "steps": {"description": "list", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_test_scenario_step", "summary": "Dry-run a scenario step via logic simulation.", "title": "Integrations Test Scenario Step", "when_to_use": "Dry-run a scenario step via logic simulation.", "write_mode": null}, {"action": "integrations.list_scenario_runs", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_scenario_runs", "source": "overlay", "title": "Integrations List Scenario Runs", "when_to_use": "List recorded test/run history for a scenario."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List recorded test/run history for a scenario.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"runs": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_scenario_runs", "summary": "List recorded test/run history for a scenario.", "title": "Integrations List Scenario Runs", "when_to_use": "List recorded test/run history for a scenario.", "write_mode": null}, {"action": "integrations.list_apps", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_apps", "source": "overlay", "title": "Integrations List Apps", "when_to_use": "List integration app catalog entries (connectors + recipe metadata)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration app catalog entries (connectors + recipe metadata).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"apps": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_apps", "summary": "List integration app catalog entries (connectors + recipe metadata).", "title": "Integrations List Apps", "when_to_use": "List integration app catalog entries (connectors + recipe metadata).", "write_mode": null}, {"action": "integrations.get_app", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.get_app", "source": "overlay", "title": "Integrations Get App", "when_to_use": "Get a single integration app definition by provider id."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Get a single integration app definition by provider id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"app": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_get_app", "summary": "Get a single integration app definition by provider id.", "title": "Integrations Get App", "when_to_use": "Get a single integration app definition by provider id.", "write_mode": null}, {"action": "integrations.dynamic_fields", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.dynamic_fields", "source": "overlay", "title": "Integrations Dynamic Fields", "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List dynamic field sources for an integration app (schema-only in Phase 1).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"fields": {"description": "list", "type": "any"}, "provider": {"description": "string", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_dynamic_fields", "summary": "List dynamic field sources for an integration app (schema-only in Phase 1).", "title": "Integrations Dynamic Fields", "when_to_use": "List dynamic field sources for an integration app (schema-only in Phase 1).", "write_mode": null}, {"action": "integrations.list_dlq_deliveries", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_dlq_deliveries", "source": "overlay", "title": "Integrations List Dlq Deliveries", "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List integration outbound deliveries in DLQ or terminal failure state.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deliveries": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_dlq_deliveries", "summary": "List integration outbound deliveries in DLQ or terminal failure state.", "title": "Integrations List Dlq Deliveries", "when_to_use": "List integration outbound deliveries in DLQ or terminal failure state.", "write_mode": null}, {"action": "integrations.generate_scenario", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.generate_scenario", "source": "overlay", "title": "Integrations Generate Scenario", "when_to_use": "NL → RuleDocumentV1 draft for integration scenario (copilot stub)."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "NL → RuleDocumentV1 draft for integration scenario (copilot stub).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"document": {"description": "object", "type": "any"}, "summary": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_generate_scenario", "summary": "NL → RuleDocumentV1 draft for integration scenario (copilot stub).", "title": "Integrations Generate Scenario", "when_to_use": "NL → RuleDocumentV1 draft for integration scenario (copilot stub).", "write_mode": null}, {"action": "integrations.import_n8n_preview", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.import_n8n_preview", "source": "overlay", "title": "Integrations Import N8N Preview", "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). stub is true when a node has no AgentStack action."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Map known nodes (webhook, set, manual, schedule, if). stub is true when a node has no AgentStack …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"preview": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_import_n8n_preview", "summary": "Preview n8n workflow JSON as AgentStack steps. Does not install or run it.", "title": "Integrations Import N8N Preview", "when_to_use": "Map known nodes (webhook, set, manual, schedule, if). stub is true when a node has no AgentStack action.", "write_mode": null}, {"action": "integrations.list_modules", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_modules", "source": "overlay", "title": "Integrations List Modules", "when_to_use": "List reusable sub-scenario module stubs."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List reusable sub-scenario module stubs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"modules": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_modules", "summary": "List reusable sub-scenario module stubs.", "title": "Integrations List Modules", "when_to_use": "List reusable sub-scenario module stubs.", "write_mode": null}, {"action": "integrations.register_module", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.register_module", "source": "overlay", "title": "Integrations Register Module", "when_to_use": "Register a reusable sub-scenario module stub on a parent connection."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "Register a reusable sub-scenario module stub on a parent connection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"module_id": {"description": "string", "type": "any"}, "registered": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_register_module", "summary": "Register a reusable sub-scenario module stub on a parent connection.", "title": "Integrations Register Module", "when_to_use": "Register a reusable sub-scenario module stub on a parent connection.", "write_mode": null}, {"action": "integrations.list_module_registrations", "capability_descriptor": {"complexity": "intermediate", "domain": "integrations", "genetic_tags": ["core.integrations.hub.gen1"], "id": "integrations.list_module_registrations", "source": "overlay", "title": "Integrations List Module Registrations", "when_to_use": "List module registrations persisted on connection DNA rows."}, "domain_title": "Integrations MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.integrations.hub.gen1"], "instruction_hint": "List module registrations persisted on connection DNA rows.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.integrations", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"registrations": {"description": "list", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.integrations.hub.gen1", "related_prompts": ["agentstack_integrations_hub"], "required_cap": "mcp_read", "safe_action": "integrations_list_module_registrations", "summary": "List module registrations persisted on connection DNA rows.", "title": "Integrations List Module Registrations", "when_to_use": "List module registrations persisted on connection DNA rows.", "write_mode": null}], "knowledge": [{"action": "knowledge.config.get", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.get", "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "source": "overlay", "title": "Knowledge Config Get", "when_to_use": "Read knowledge config leaf before patch or playground."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Read knowledge config leaf before patch or playground.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.patch", "knowledge.prompt.get", "knowledge.health"], "required_cap": "bots_run", "safe_action": "knowledge_config_get", "summary": "MCP tool knowledge.config.get", "title": "Knowledge Config Get", "when_to_use": "Read knowledge config leaf before patch or playground.", "write_mode": null}, {"action": "knowledge.prompt.get", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.get", "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "source": "overlay", "title": "Knowledge Prompt Get", "when_to_use": "Load mentor Plan instructions before prompt.patch."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Load mentor Plan instructions before prompt.patch.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.patch", "knowledge.playground", "knowledge.kb.ingest"], "required_cap": "bots_run", "safe_action": "knowledge_prompt_get", "summary": "Grounded assistant preamble + plan_instructions (same as GET /knowledge/prompt). Returns full strings plus system_preamble_chars / plan_instructions_chars. Always GET before knowledge.prompt.patch rep", "title": "Knowledge Prompt Get", "when_to_use": "Load mentor Plan instructions before prompt.patch.", "write_mode": null}, {"action": "knowledge.prompt.patch", "ai_tips": "GET first and check plan_instructions_chars. Sending a short stub as plan_instructions used to wipe a 7k-char plan. write_mode=append adds a bullet. Stub replace → prompt_shrink_blocked unless allow_shrink=true. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "anti_pattern": "Sending a 7-line plan_instructions as a patch — omit-unset is keys only; the sent string replaces the whole field.", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.prompt.patch", "mutation_risk": "low", "related_tools": ["knowledge.prompt.get"], "source": "overlay", "title": "Knowledge Prompt Patch", "when_to_use": "Edit Plan bullets; use append mode for new lines."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Edit Plan bullets; use append mode for new lines.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.prompt.get"], "required_cap": "bots_run", "safe_action": "knowledge_prompt_patch", "summary": "Patch grounded assistant system_preamble and/or plan_instructions (same as PATCH /knowledge/prompt). omit-unset keeps unsent keys; a sent field is the full string. Writes prompt_settings leaf via patc", "title": "Knowledge Prompt Patch", "when_to_use": "Edit Plan bullets; use append mode for new lines.", "write_mode": ["replace", "write", "append", "prepend"], "write_mode_note": "omit-unset keeps unsent keys only. A sent plan_instructions / system_preamble replaces that entire string. GET first; write_mode=append for a new bullet; stub replace → prompt_shrink_blocked."}, {"action": "knowledge.access.grant", "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.grant", "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "source": "overlay", "title": "Knowledge Access Grant", "when_to_use": "Grant product/tier access to a principal user (entitlement row)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Grant product/tier access to a principal user (entitlement row).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.access.list", "knowledge.access.revoke", "knowledge.health"], "required_cap": "bots_run", "safe_action": "knowledge_access_grant", "summary": "MCP tool knowledge.access.grant", "title": "Knowledge Access Grant", "when_to_use": "Grant product/tier access to a principal user (entitlement row).", "write_mode": null}, {"action": "knowledge.access.revoke", "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.revoke", "mutation_risk": "high", "source": "overlay", "title": "Knowledge Access Revoke", "when_to_use": "Revoke a principal product grant after refund or role change."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Revoke a principal product grant after refund or role change.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_access_revoke", "summary": "MCP tool knowledge.access.revoke", "title": "Knowledge Access Revoke", "when_to_use": "Revoke a principal product grant after refund or role change.", "write_mode": null}, {"action": "knowledge.access.list", "capability_descriptor": {"complexity": "intermediate", "domain": "entitlement", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.access.list", "source": "overlay", "title": "Knowledge Access List", "when_to_use": "List access grants before grant/revoke or entitlement QA."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "List access grants before grant/revoke or entitlement QA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_access_list", "summary": "MCP tool knowledge.access.list", "title": "Knowledge Access List", "when_to_use": "List access grants before grant/revoke or entitlement QA.", "write_mode": null}, {"action": "knowledge.kb.ingest", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.ingest", "related_tools": ["knowledge.playground", "knowledge.eval.run", "knowledge.export"], "source": "handler", "title": "Knowledge Kb Ingest", "when_to_use": "Ingest KB document into project knowledge index."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"collection": "example_string", "collection_id": "example_string", "dedupe": true, "documents": [], "enqueue": true, "ingest_run_id": "example_string", "project_id": 123, "text": "example_string", "title": "example_string", "user_id": 123}, "genetic_tags": ["core.knowledge.platform.gen1"], "inputSchema": {"properties": {"collection": {"description": "Alias of collection_id.", "type": "string"}, "collection_id": {"description": "KB collection id (e.g. content_registry)", "type": "string"}, "dedupe": {"default": true, "description": "", "type": "boolean"}, "documents": {"description": "Document objects. Each item accepts content, text, or body, plus title. A single title and text on the call is the same as one document.", "type": "array"}, "enqueue": {"default": true, "description": "Queue async ingest (default true)", "type": "boolean"}, "ingest_run_id": {"description": "", "type": "string"}, "project_id": {"description": "", "type": "integer"}, "text": {"description": "Body when documents is omitted. Aliases: content, body.", "type": "string"}, "title": {"description": "Title stored on the document metadata.", "type": "string"}, "user_id": {"description": "", "type": "integer"}}, "required": ["collection_id"], "type": "object"}, "instruction_hint": "Ingest KB document into project knowledge index.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.playground", "knowledge.eval.run", "knowledge.export"], "required_cap": "bots_run", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_kb_ingest", "summary": "MCP tool knowledge.kb.ingest", "title": "Knowledge Kb Ingest", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_to_use": "Ingest KB document into project knowledge index.", "write_mode": null}, {"action": "knowledge.kb.heal_index", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.kb.heal_index", "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "source": "overlay", "title": "Knowledge Kb Heal Index", "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Fix rag_index_sha256_mismatch without wiping collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.health", "knowledge.kb.ingest", "knowledge.content.list"], "required_cap": "bots_run", "safe_action": "knowledge_kb_heal_index", "summary": "Realign DNA storage_ref.sha256 to on-disk sqlite for a KB collection (no wipe). Fixes rag_index_sha256_mismatch. Default collection_id=content_registry.", "title": "Knowledge Kb Heal Index", "when_to_use": "Fix rag_index_sha256_mismatch without wiping collection.", "write_mode": null}, {"action": "knowledge.export", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.export", "source": "overlay", "title": "Knowledge Export", "when_to_use": "Export knowledge config + KB snapshot for backup."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Export knowledge config + KB snapshot for backup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_export", "summary": "MCP tool knowledge.export", "title": "Knowledge Export", "when_to_use": "Export knowledge config + KB snapshot for backup.", "write_mode": null}, {"action": "knowledge.eval.run", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run", "source": "overlay", "title": "Knowledge Eval Run", "when_to_use": "Run single eval case against knowledge config."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Run single eval case against knowledge config.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_eval_run", "summary": "MCP tool knowledge.eval.run", "title": "Knowledge Eval Run", "when_to_use": "Run single eval case against knowledge config.", "write_mode": null}, {"action": "knowledge.config.patch", "ai_tips": "safety_playbooks_write_mode: patch (default) overlays one playbook; replace wipes to the sent dict only; merge fills empty template fields only. Use knowledge.policy_templates.apply for catalog overlays. context_lanes sets faq|consult|coding|design|architecture collections and a preamble. coding/design/architecture default to project_code, project_design, project_architecture. context_limits (prompt_tail_chars, lane_preamble_chars, builder_snippet_chars, resource_text_chars, lane_collection_cap) is the size SoT — patch it instead of assuming a fixed cap. Ingest design CSS/HTML with knowledge.kb.ingest content_type css|html|style|code.", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.config.patch", "mutation_risk": "low", "related_tools": ["knowledge.config.get", "knowledge.policy_templates.status", "knowledge.policy_templates.apply"], "source": "overlay", "title": "Knowledge Config Patch", "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Patch one knowledge config key — prefer leaf paths over full blob.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.policy_templates.status", "knowledge.policy_templates.apply"], "required_cap": "bots_run", "safe_action": "knowledge_config_patch", "summary": "Patch knowledge DNA config + safety playbooks (same as PATCH /knowledge/config). gene_pack merges by name; safety_playbooks default write_mode is patch (per-playbook overlay — other playbook ids are k", "title": "Knowledge Config Patch", "when_to_use": "Patch one knowledge config key — prefer leaf paths over full blob.", "write_mode": null}, {"action": "knowledge.policy_templates.list", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.list", "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "source": "overlay", "title": "Knowledge Policy Templates List", "when_to_use": "Discover safety/policy templates before apply."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Discover safety/policy templates before apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.apply", "knowledge.prompt.get"], "required_cap": "bots_run", "safe_action": "knowledge_policy_templates_list", "summary": "Platform policy templates (synthesis / crisis / situational needles / gate). Same catalog as GET /knowledge/policy-templates. Apply writes 8DNA via existing prompt+config PATCH — not a second bus.", "title": "Knowledge Policy Templates List", "when_to_use": "Discover safety/policy templates before apply.", "write_mode": null}, {"action": "knowledge.policy_templates.status", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.status", "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "source": "overlay", "title": "Knowledge Policy Templates Status", "when_to_use": "Read which policy templates are active on project."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Read which policy templates are active on project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.policy_templates.apply", "knowledge.prompt.get", "knowledge.config.get"], "required_cap": "bots_run", "safe_action": "knowledge_policy_templates_status", "summary": "Read-only policy snapshot: synthesis [policy:id] markers in plan_instructions, playbook ids, gate mode, situational needle count. Same as GET /knowledge/policy-templates/status.", "title": "Knowledge Policy Templates Status", "when_to_use": "Read which policy templates are active on project.", "write_mode": null}, {"action": "knowledge.policy_templates.apply", "ai_tips": "Default slots = all slots on the template. Re-apply is a no-op (skipped). Do not put program track names in Core — templates are generic; Unity stays in tenant Plan. knowledge.prompt.patch omit-unset is still keys-only.", "anti_pattern": "Inventing a second policy service or full-blob DNA write.", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.policy_templates.apply", "mutation_risk": "low", "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "source": "overlay", "title": "Knowledge Policy Templates Apply", "when_to_use": "Apply curated policy template slots to project config."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Apply curated policy template slots to project config.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.policy_templates.list", "knowledge.config.patch"], "required_cap": "bots_run", "safe_action": "knowledge_policy_templates_apply", "summary": "Apply a platform policy template onto the tenant: plan_instructions append (marker [policy:id]), merge crisis match_any (keep tenant template), union gene_pack.situational_needles, optional safety_fai", "title": "Knowledge Policy Templates Apply", "when_to_use": "Apply curated policy template slots to project config.", "write_mode": null}, {"action": "knowledge.journal.list", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.journal.list", "source": "overlay", "title": "Knowledge Journal List", "when_to_use": "Audit mentor turn journal — support escalations and replay triage."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Audit mentor turn journal — support escalations and replay triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_journal_list", "summary": "MCP tool knowledge.journal.list", "title": "Knowledge Journal List", "when_to_use": "Audit mentor turn journal — support escalations and replay triage.", "write_mode": null}, {"action": "knowledge.eval.run_all", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.eval.run_all", "source": "overlay", "title": "Knowledge Eval Run All", "when_to_use": "Run full platform eval harness (hit-rate gate before promote)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Run full platform eval harness (hit-rate gate before promote).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_eval_run_all", "summary": "MCP tool knowledge.eval.run_all", "title": "Knowledge Eval Run All", "when_to_use": "Run full platform eval harness (hit-rate gate before promote).", "write_mode": null}, {"action": "knowledge.health", "aliases": ["knowledge.list"], "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.health", "related_tools": ["knowledge.kb.ingest", "knowledge.config.get", "knowledge.eval.run"], "source": "overlay", "title": "Knowledge Health", "when_to_use": "Knowledge plane health before ingest or playground."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Knowledge plane health before ingest or playground.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.kb.ingest", "knowledge.config.get", "knowledge.eval.run"], "required_cap": "bots_run", "safe_action": "knowledge_health", "summary": "MCP tool knowledge.health", "title": "Knowledge Health", "when_to_use": "Knowledge plane health before ingest or playground.", "write_mode": null}, {"action": "knowledge.content.list", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.list", "source": "overlay", "title": "Knowledge Content List", "when_to_use": "List operator KB documents with joined text preview."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "List operator KB documents with joined text preview.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_content_list", "summary": "List operator KB documents. Each item includes title, source_doc_id, chunk_count, and joined text (same as GET /knowledge/content).", "title": "Knowledge Content List", "when_to_use": "List operator KB documents with joined text preview.", "write_mode": null}, {"action": "knowledge.content.get", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.get", "source": "overlay", "title": "Knowledge Content Get", "when_to_use": "Read full indexed body before content.patch replace."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Read full indexed body before content.patch replace.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_content_get", "summary": "Get one KB document by source_doc_id (chunks + joined text). Always call this before knowledge.content.patch replace. text uses the same \\n\\n join as list; check text_chars before rewriting.", "title": "Knowledge Content Get", "when_to_use": "Read full indexed body before content.patch replace.", "write_mode": null}, {"action": "knowledge.content.patch", "ai_tips": "Always pass write_mode. GET the doc first for replace. A truncated body vs the indexed length returns content_shrink_blocked; pass allow_shrink=true only when the shorter body is intentional. See GET /mcp/actions write_modes and prompt agentstack_write_modes.", "anti_pattern": "Sending one H2 as text without write_mode=append — that used to wipe the rest of the card.", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.patch", "mutation_risk": "low", "related_tools": ["knowledge.content.get", "knowledge.content.list"], "source": "overlay", "title": "Knowledge Content Patch", "when_to_use": "Replace or append KB document after content.get."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Replace or append KB document after content.get.", "kind": "mcp_domain", "mutation_kind": "body", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.content.get", "knowledge.content.list"], "required_cap": "bots_run", "safe_action": "knowledge_content_patch", "summary": "Patch a KB document: metadata (title, gene_stems, …) and/or body. Body write_mode is replace (full text), append, or prepend — never a silent section splice. Same as PATCH /knowledge/content/{id}.", "title": "Knowledge Content Patch", "when_to_use": "Replace or append KB document after content.get.", "write_mode": ["replace", "write", "append", "prepend"], "write_mode_note": "text is a full body unless write_mode=append|prepend. GET the document first; shrinking a long body needs allow_shrink=true. SDK Studio sets allow_shrink for operator save — AI must GET first."}, {"action": "knowledge.content.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.content.delete", "mutation_risk": "high", "source": "overlay", "title": "Knowledge Content Delete", "when_to_use": "Remove KB document by source_doc_id (irreversible)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Remove KB document by source_doc_id (irreversible).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_content_delete", "summary": "Deactivate or hard-delete a KB document by source_doc_id. Same as DELETE /knowledge/content/{id}.", "title": "Knowledge Content Delete", "when_to_use": "Remove KB document by source_doc_id (irreversible).", "write_mode": null}, {"action": "knowledge.registry.list", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.list", "source": "overlay", "title": "Knowledge Registry List", "when_to_use": "List content registry entries before upsert."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "List content registry entries before upsert.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_registry_list", "summary": "MCP tool knowledge.registry.list", "title": "Knowledge Registry List", "when_to_use": "List content registry entries before upsert.", "write_mode": null}, {"action": "knowledge.registry.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.registry.upsert", "mutation_risk": "low", "source": "overlay", "title": "Knowledge Registry Upsert", "when_to_use": "Upsert registry metadata for FAQ/guide documents."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Upsert registry metadata for FAQ/guide documents.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_registry_upsert", "summary": "MCP tool knowledge.registry.upsert", "title": "Knowledge Registry Upsert", "when_to_use": "Upsert registry metadata for FAQ/guide documents.", "write_mode": null}, {"action": "knowledge.import", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.import", "mutation_risk": "low", "source": "overlay", "title": "Knowledge Import", "when_to_use": "Import knowledge pack JSON into project scope."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"bundle": {}, "project_id": 123, "user_id": 123}, "genetic_tags": ["core.knowledge.platform.gen1"], "inputSchema": {"properties": {"bundle": {"description": "Knowledge import bundle; top-level keys used when omitted", "type": "object"}, "project_id": {"description": "", "type": "integer"}, "user_id": {"description": "", "type": "integer"}}, "required": [], "type": "object"}, "instruction_hint": "Import knowledge pack JSON into project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "rollback": ["generation.realign_to_prod"], "safe_action": "knowledge_import", "summary": "MCP tool knowledge.import", "title": "Knowledge Import", "verification": ["knowledge.health", "knowledge.config.get"], "verify": [{"action": "knowledge.health", "predicate": "named resource is visible"}, {"action": "knowledge.config.get", "predicate": "named resource is visible"}], "when_to_use": "Import knowledge pack JSON into project scope.", "write_mode": null}, {"action": "knowledge.gc.status", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.status", "source": "overlay", "title": "Knowledge Gc Status", "when_to_use": "GC queue status before reconcile or bulk ingest cleanup."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "GC queue status before reconcile or bulk ingest cleanup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_gc_status", "summary": "MCP tool knowledge.gc.status", "title": "Knowledge Gc Status", "when_to_use": "GC queue status before reconcile or bulk ingest cleanup.", "write_mode": null}, {"action": "knowledge.gc.reconcile", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.gc.reconcile", "source": "overlay", "title": "Knowledge Gc Reconcile", "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_gc_reconcile", "summary": "MCP tool knowledge.gc.reconcile", "title": "Knowledge Gc Reconcile", "when_to_use": "Enqueue principal/GetCourse GC reconcile (async heavy job).", "write_mode": null}, {"action": "knowledge.playground", "anti_pattern": "Using rag.search alone for mentor answer QA (skips gene_pack / Plan).", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.playground", "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "source": "handler", "title": "Knowledge Playground", "when_to_use": "Full mentor simulate with RAG/safety trace — one heavy step per sync execute. Preflight: action=capabilities (read-only, no text)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "heavy_llm", "conditional_mutate": "action=capabilities is read-only; omit action and pass text for heavy LLM simulate", "effect_depends_on_params": false, "execution_class": "heavy", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "inputSchema": {"properties": {"access_tier": {"description": "Optional tier override for the simulate principal", "type": "string"}, "action": {"description": "Optional: capabilities — return playground params and related tools without LLM (no text required).", "type": "string"}, "bot_uuid": {"description": "Grounded assistant / mentor bot uuid (alias: bot_id). Omit to use knowledge.config default_playground_bot_uuid or mentor fleet bot.", "format": "uuid", "type": "string"}, "chat_type": {"description": "private|group (default private)", "type": "string"}, "external_user_id": {"description": "Synthetic channel user id (default playground-user)", "type": "string"}, "principal_user_id": {"description": "Platform user id for entitlement / staff caps", "type": "integer"}, "text": {"description": "User message to simulate (alias: message). Omit when action=capabilities (read-only tool metadata).", "type": "string"}}, "required": [], "type": "object"}, "instruction_hint": "Full mentor simulate with RAG/safety trace — one heavy step per sync execute. Preflight: action=c…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["bots.simulate", "knowledge.config.get", "knowledge.prompt.get"], "required_cap": "bots_run", "safe_action": "knowledge_playground", "summary": "Full bot simulate with RAG/safety/gene-lock trace (REST playground). Heavy LLM: one per sync agentstack.execute. Prefer over raw rag.search for mentor fidelity. Same budget as bots.simulate.", "title": "Knowledge Playground", "when_to_use": "Full mentor simulate with RAG/safety trace — one heavy step per sync execute. Preflight: action=capabilities (read-only, no text).", "write_mode": null}, {"action": "knowledge.principal.simulate", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.principal.simulate", "source": "overlay", "title": "Knowledge Principal Simulate", "when_to_use": "Simulate principal-tier retrieval without live channel."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Simulate principal-tier retrieval without live channel.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_principal_simulate", "summary": "MCP tool knowledge.principal.simulate", "title": "Knowledge Principal Simulate", "when_to_use": "Simulate principal-tier retrieval without live channel.", "write_mode": null}, {"action": "knowledge.project_ai_keys.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.patch", "mutation_risk": "low", "source": "overlay", "title": "Knowledge Project Ai Keys Patch", "when_to_use": "Rotate project-scoped AI provider keys (protected leaf)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Rotate project-scoped AI provider keys (protected leaf).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_project_ai_keys_patch", "summary": "Patch tenant project AI keys in project.protected (KeySelector). Same storage as PUT /api/projects/{id}/ai-keys — no secret values in GET.", "title": "Knowledge Project Ai Keys Patch", "when_to_use": "Rotate project-scoped AI provider keys (protected leaf).", "write_mode": null}, {"action": "knowledge.project_ai_keys.status", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_ai_keys.status", "source": "overlay", "title": "Knowledge Project Ai Keys Status", "when_to_use": "Read AI key binding status without exposing secrets."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Read AI key binding status without exposing secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_project_ai_keys_status", "summary": "AI key presence + ai_settings flags (no secret values).", "title": "Knowledge Project Ai Keys Status", "when_to_use": "Read AI key binding status without exposing secrets.", "write_mode": null}, {"action": "knowledge.project_secrets.apply", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "knowledge.project_secrets.apply", "mutation_risk": "low", "source": "overlay", "title": "Knowledge Project Secrets Apply", "when_to_use": "Apply encrypted project secrets bundle (ops migration)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Apply encrypted project secrets bundle (ops migration).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_project_secrets_apply", "summary": "Apply Unity tenant secrets: OpenAI → project.protected, GetCourse/MAX → Integration Hub protected. Pass openai/getcourse/max fields.", "title": "Knowledge Project Secrets Apply", "when_to_use": "Apply encrypted project secrets bundle (ops migration).", "write_mode": null}, {"action": "knowledge.journal.get", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.journal.get", "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "source": "live", "title": "Knowledge Journal Get", "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.list", "knowledge.correction.propose", "knowledge.playground"], "required_cap": "bots_run", "safe_action": "knowledge_journal_get", "summary": "MCP tool knowledge.journal.get", "title": "Knowledge Journal Get", "when_to_use": "Fetch one mentor journal turn by correlation_id or turn_id for diagnose/correction.", "write_mode": null}, {"action": "knowledge.correction.propose", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.correction.propose", "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "source": "live", "title": "Knowledge Correction Propose", "when_to_use": "Draft correction steps from a journal turn — NO auto-write."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Draft correction steps from a journal turn — NO auto-write.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.journal.get", "knowledge.config.patch", "knowledge.acceptance.case.upsert"], "required_cap": "bots_run", "safe_action": "knowledge_correction_propose", "summary": "MCP tool knowledge.correction.propose", "title": "Knowledge Correction Propose", "when_to_use": "Draft correction steps from a journal turn — NO auto-write.", "write_mode": null}, {"action": "knowledge.acceptance.list", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.acceptance.list", "source": "live", "title": "Knowledge Acceptance List", "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_acceptance_list", "summary": "MCP tool knowledge.acceptance.list", "title": "Knowledge Acceptance List", "when_to_use": "List built-in acceptance fixture suites before knowledge.acceptance.run.", "write_mode": null}, {"action": "knowledge.acceptance.run", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.acceptance.run", "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "source": "live", "title": "Knowledge Acceptance Run", "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.acceptance.list", "knowledge.acceptance.case.run", "generation.promote"], "required_cap": "bots_run", "safe_action": "knowledge_acceptance_run", "summary": "MCP tool knowledge.acceptance.run", "title": "Knowledge Acceptance Run", "when_to_use": "Run acceptance suite (rule-based; eval_mode=retrieval avoids LLM).", "write_mode": null}, {"action": "knowledge.acceptance.case.run", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.acceptance.case.run", "source": "live", "title": "Knowledge Acceptance Case Run", "when_to_use": "Run one acceptance case by id from a suite."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Run one acceptance case by id from a suite.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_acceptance_case_run", "summary": "MCP tool knowledge.acceptance.case.run", "title": "Knowledge Acceptance Case Run", "when_to_use": "Run one acceptance case by id from a suite.", "write_mode": null}, {"action": "knowledge.acceptance.case.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.acceptance.case.upsert", "source": "live", "title": "Knowledge Acceptance Case Upsert", "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_acceptance_case_upsert", "summary": "MCP tool knowledge.acceptance.case.upsert", "title": "Knowledge Acceptance Case Upsert", "when_to_use": "Append regression case to config.knowledge.acceptance_cases (merge, not replace).", "write_mode": null}, {"action": "knowledge.doctor.run", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.doctor.run", "source": "live", "title": "Knowledge Doctor Run", "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_doctor_run", "summary": "MCP tool knowledge.doctor.run", "title": "Knowledge Doctor Run", "when_to_use": "Read-only mentor doctor for any project (gene pack + retrieval probe).", "write_mode": null}, {"action": "knowledge.retrieve.probe", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.retrieve.probe", "source": "live", "title": "Knowledge Retrieve Probe", "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "required_cap": "bots_run", "safe_action": "knowledge_retrieve_probe", "summary": "MCP tool knowledge.retrieve.probe", "title": "Knowledge Retrieve Probe", "when_to_use": "Hybrid retrieval probe (no LLM) — top doc_ids for a query.", "write_mode": null}, {"action": "knowledge.phenotype.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.phenotype.upsert", "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "source": "live", "title": "Knowledge Phenotype Upsert", "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch)."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.config.get", "knowledge.retrieve.probe", "knowledge.gene_pack.pinned_shape.upsert"], "required_cap": "bots_run", "safe_action": "knowledge_phenotype_upsert", "summary": "MCP tool knowledge.phenotype.upsert", "title": "Knowledge Phenotype Upsert", "when_to_use": "Partial gene_pack phenotype merge by name + compile_warnings (prefer over raw config.patch).", "write_mode": null}, {"action": "knowledge.gene_pack.pinned_shape.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.knowledge.gen1"], "id": "knowledge.gene_pack.pinned_shape.upsert", "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "source": "live", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings."}, "domain_title": "Knowledge MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.knowledge", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "related_prompts": ["agentstack_safe_project_cycle", "agentstack_tenant_ops_mcp_first", "agentstack_knowledge_mentor", "agentstack_knowledge_answer_tune", "agentstack_knowledge_safety_tune", "agentstack_context_lanes"], "related_tools": ["knowledge.phenotype.upsert", "knowledge.config.get", "knowledge.retrieve.probe"], "required_cap": "bots_run", "safe_action": "knowledge_gene_pack_pinned_shape_upsert", "summary": "MCP tool knowledge.gene_pack.pinned_shape.upsert", "title": "Knowledge Gene Pack Pinned Shape Upsert", "when_to_use": "Merge one pinned_shapes binding (phenotype → glossary_stem) + compile_warnings.", "write_mode": null}], "logic": [{"action": "logic.create", "aliases": ["logic.write", "rules.create", "rules.create_rules"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.create", "mutation_risk": "low", "related_tools": ["logic.attach_template", "logic.list", "logic.execute"], "source": "overlay", "title": "Logic Create", "when_blocked": {"insufficient_permissions": "logic_write cap + project membership on tenant PID", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry"}, "when_to_use": "When X then Y automation — prefer over custom event handlers."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"description": "Checks if user is eligible for daily reward and grants it", "enabled": true, "name": "Daily Reward Check", "priority": 5, "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}, "genetic_tags": ["core.mcp.logic.gen1"], "inputSchema": {"examples": [{"description": "Create a rule that executes when a specific command is called", "name": "Create rule with command trigger", "request": {"params": {"description": "Check and grant daily rewards to users", "enabled": true, "name": "Daily Reward Check", "priority": 5, "space": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.last_reward_date", "value": "{{now}}"}, "processor": "field_operations_processor"}], "triggers": [{"command": "check.daily_reward", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "description": "Check and grant daily rewards to users", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Daily Reward Check", "priority": 5, "space": [], "triggers": [{"command": "check.daily_reward", "type": "command"}]}, "success": true}}, {"description": "Create a rule that runs on a schedule using cron expression", "name": "Create rule with scheduler", "request": {"params": {"description": "Run daily cleanup task at 2 AM UTC", "enabled": true, "name": "Daily Cleanup", "schedulers": [{"cron": "0 2 * * *", "timezone": "UTC"}], "space": [{"action": "delete", "parameters": {"entity": "temp_data", "filters": {"created_at": {"$lt": "now-7d"}}}, "processor": "dna_operations_processor"}]}, "tool": "logic.create"}, "response": {"data": {"created_at": "2025-01-20T10:00:00Z", "enabled": true, "id": "550e8400-e29b-41d4-a716-446655440001", "name": "Daily Cleanup"}, "success": true}}, {"description": "Create a rule with multiple processor blocks executing sequentially", "name": "Create complex rule with multiple processors", "request": {"params": {"description": "Handle new user registration with multiple steps", "enabled": true, "name": "User Registration Handler", "priority": 7, "space": [{"action": "set", "parameters": {"field": "user.registration_date", "value": "{{now}}"}, "processor": "field_operations_processor"}, {"action": "set", "parameters": {"field": "user.status", "value": "active"}, "processor": "field_operations_processor"}, {"action": "send", "parameters": {"recipient": "{{user.email}}", "type": "welcome_email"}, "processor": "notification_processor"}], "triggers": [{"command": "user.register", "type": "command", "when": {}}]}, "tool": "logic.create"}, "response": {"data": {"enabled": true, "id": "550e8400-e29b-41d4-a716-446655440002", "name": "User Registration Handler"}, "success": true}}], "properties": {"description": {"default": "", "description": "Detailed description of what the rule does and when it should be executed", "example": "Checks if user is eligible for daily reward and grants it", "type": "string"}, "enabled": {"default": true, "description": "Whether rule is enabled and will execute. Disabled rules are saved but not executed. Default: true", "example": true, "type": "boolean"}, "name": {"description": "Unique rule name. Should be descriptive and identify the rule's purpose (e.g., 'Daily Reward Check', 'User Login Handler', 'Scheduled Cleanup')", "example": "Daily Reward Check", "type": "string"}, "priority": {"default": 5, "description": "Rule priority from 1 (lowest) to 10 (highest). Higher priority rules execute first when multiple rules are triggered. Default: 5", "example": 5, "type": "integer"}, "schedulers": {"description": "Array of scheduler objects for time-based execution. Each scheduler: {cron: string (cron expression like '0 2 * * *'), timezone?: string (default: 'UTC')}. At least one trigger or scheduler is required", "example": [{"cron": "0 2 * * *", "timezone": "UTC"}], "type": "array"}, "space": {"description": "Processor blocks. Alias: steps. Each block: {processor, action, parameters}. Blocks run in order.", "example": [{"action": "add", "parameters": {"field1": "user.daily_streak", "field2": 1, "result_field": "user.daily_streak"}, "processor": "field_operations_processor"}], "type": "array"}, "triggers": {"description": "Array of trigger objects that activate the rule. Each trigger: {type: 'command'|'event', command?: string (for command triggers), when?: object (conditional logic)}. At least one trigger or scheduler is required", "example": [{"command": "check.daily_reward", "type": "command", "when": {}}], "type": "array"}}, "required": ["name"], "type": "object"}, "instruction_hint": "When X then Y automation — prefer over custom event handlers.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"created_at": {"description": "string - ISO 8601 timestamp of creation", "type": "any"}, "description": {"description": "string - Rule description", "type": "any"}, "enabled": {"description": "bool - Whether rule is enabled", "type": "any"}, "id": {"description": "string - Rule UUID (unique identifier for the rule, format: UUID v4)", "type": "any"}, "name": {"description": "string - Rule name as provided", "type": "any"}, "priority": {"description": "int - Rule priority (1-10)", "type": "any"}, "schedulers": {"description": "array - Array of scheduler configurations", "type": "any"}, "space": {"description": "array - Array of processor blocks", "type": "any"}, "triggers": {"description": "array - Array of trigger configurations", "type": "any"}, "updated_at": {"description": "string - ISO 8601 timestamp of last update", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.attach_template", "logic.list", "logic.execute"], "required_cap": "logic_write", "rollback": ["logic.delete", "generation.realign_to_prod"], "safe_action": "logic_create", "summary": "Create new Logic Engine rule for project.", "title": "Logic Create", "tool_chains": ["scheduled_rewards", "game_setup", "game_setup"], "verification": ["logic.get", "logic.dry_run"], "verify": [{"action": "logic.get", "predicate": "named resource is visible"}, {"action": "logic.dry_run", "predicate": "named resource is visible"}], "when_blocked": {"insufficient_permissions": "logic_write cap + project membership on tenant PID", "invalid_parameters": "logic.get_commands + logic.signals_catalog before triggers/space", "invalid_structure": "logic.get_processors for processor ids — fix graph before retry"}, "when_to_use": "When X then Y automation — prefer over custom event handlers.", "write_mode": null}, {"action": "logic.update", "ai_tips": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node.", "aliases": ["rules.activate_rules", "rules.update_rules"], "anti_pattern": "Sending one trigger without write_mode=merge and expecting siblings to remain (omit is now merge, but be explicit).", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.update", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.delete"], "source": "overlay", "title": "Logic Update", "when_blocked": {"logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node."}, "collection_key": "uid", "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates…", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"id": {"description": "string - Rule UUID", "type": "any"}, "name": {"description": "string - Updated rule name", "type": "any"}, "updated_at": {"description": "string - Update timestamp", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.get", "logic.create", "logic.delete"], "required_cap": "logic_write", "safe_action": "logic_update", "summary": "Update existing Logic Engine rule.", "title": "Logic Update", "when_blocked": {"logic_collection_empty_blocked": "pass write_mode or non-empty collection — not wipe", "logic_not_found": "logic.list or logic.get with same project_id before update", "write_mode_invalid": "logic.get_commands — supported write_mode for triggers/space"}, "when_to_use": "Update an existing logic rule. Pass write_mode for triggers/space/schedulers; prefer path_updates for one node.", "write_mode": ["merge", "patch", "upsert", "replace", "write", "delete"], "write_mode_note": "triggers/space/schedulers are keyed lists: pass write_mode. Prefer path_updates for one node."}, {"action": "logic.delete", "aliases": ["rules.delete_rules"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.delete", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.list"], "source": "overlay", "title": "Logic Delete", "when_to_use": "Remove automation by id — irreversible."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "example_params": {"logic_id": "example_string"}, "genetic_tags": ["core.mcp.logic.gen1"], "inputSchema": {"examples": [{"description": "Delete a logic rule", "request": {"logic_id": "uuid"}, "response": {"data": {"deleted": true, "logic_id": "uuid"}, "success": true}}], "properties": {"logic_id": {"description": "Logic rule ID (UUID)", "format": "uuid", "type": "string"}}, "required": ["logic_id"], "type": "object"}, "instruction_hint": "Remove automation by id — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool - Whether rule was deleted", "type": "any"}, "logic_id": {"description": "string - Deleted rule ID", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.get", "logic.create", "logic.list"], "required_cap": "logic_write", "rollback": [], "safe_action": "logic_delete", "summary": "Delete a Logic Engine rule.", "title": "Logic Delete", "verification": ["logic.list"], "verify": [{"action": "logic.list", "predicate": "named resource is visible"}], "when_to_use": "Remove automation by id — irreversible.", "write_mode": null}, {"action": "logic.get", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get", "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "source": "overlay", "title": "Logic Get", "when_to_use": "Load rule graph before logic.execute or attach_template."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Load rule graph before logic.execute or attach_template.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"description": {"description": "string - Rule description", "type": "any"}, "enabled": {"description": "bool - Whether rule is enabled", "type": "any"}, "id": {"description": "string - Rule UUID", "type": "any"}, "name": {"description": "string - Rule name", "type": "any"}, "priority": {"description": "int - Rule priority", "type": "any"}, "schedulers": {"description": "array - Scheduler configurations", "type": "any"}, "space": {"description": "array - Processor blocks", "type": "any"}, "triggers": {"description": "array - Trigger configurations", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.execute", "logic.delete", "logic.get_commands"], "required_cap": "mcp_read", "safe_action": "logic_get", "summary": "Get detailed information about a Logic Engine rule.", "title": "Logic Get", "when_to_use": "Load rule graph before logic.execute or attach_template.", "write_mode": null}, {"action": "logic.list", "aliases": ["rules.list", "rules.list_rules"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list", "related_tools": ["logic.get", "logic.create", "logic.execute"], "source": "overlay", "title": "Logic List", "when_to_use": "Enumerate rules before get/execute/delete."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Enumerate rules before get/execute/delete.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Number of rules", "type": "any"}, "logic": {"description": "array - Array of logic rule objects", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.get", "logic.create", "logic.execute"], "required_cap": "mcp_read", "safe_action": "logic_list", "summary": "List all Logic Engine rules for project.", "title": "Logic List", "when_to_use": "Enumerate rules before get/execute/delete.", "write_mode": null}, {"action": "logic.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.execute", "mutation_risk": "low", "related_tools": ["logic.get", "logic.create", "logic.update"], "source": "handler", "title": "Logic Execute", "when_to_use": "Use this tool to test a logic rule before enabling it"}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "inputSchema": {"examples": [{"description": "Execute a logic rule for testing", "request": {"event_data": {"test": "data"}, "logic_id": "uuid"}, "response": {"data": {"executed": true, "result": {}}, "success": true}}], "properties": {"context": {"description": "Additional context", "type": "object"}, "event_data": {"additionalProperties": true, "description": "Event data for rule execution", "type": "object"}, "logic_id": {"description": "Logic rule ID (UUID)", "format": "uuid", "type": "string"}}, "required": ["logic_id", "event_data"], "type": "object"}, "instruction_hint": "Use this tool to test a logic rule before enabling it", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"executed": {"description": "bool - Whether rule was executed", "type": "any"}, "result": {"description": "object - Execution result", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.get", "logic.create", "logic.update"], "required_cap": "logic_write", "safe_action": "logic_execute", "summary": "Execute a Logic Engine rule immediately.", "title": "Logic Execute", "tool_chains": ["crud_with_logic"], "when_to_use": "Use this tool to test a logic rule before enabling it", "write_mode": null}, {"action": "logic.get_processors", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_processors", "related_tools": ["processors.list", "logic.create", "logic.update"], "source": "overlay", "title": "Logic Get Processors", "when_to_use": "Discover processor ids for logic canvas nodes."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Discover processor ids for logic canvas nodes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"processors": {"description": "array - Array of processor metadata", "type": "any"}, "total": {"description": "int - Total number of processors", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["processors.list", "logic.create", "logic.update"], "required_cap": "mcp_read", "safe_action": "logic_get_processors", "summary": "Get list of available processors (same as processors.list but in logic context).", "title": "Logic Get Processors", "when_to_use": "Discover processor ids for logic canvas nodes.", "write_mode": null}, {"action": "logic.get_commands", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.get_commands", "related_tools": ["logic.create", "logic.update"], "source": "overlay", "title": "Logic Get Commands", "when_to_use": "List registered protein commands for logic.attach."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List registered protein commands for logic.attach.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"commands": {"description": "array - Array of command strings", "type": "any"}, "count": {"description": "int - Number of commands", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.create", "logic.update"], "required_cap": "mcp_read", "safe_action": "logic_get_commands", "summary": "Get list of available commands for triggers.", "title": "Logic Get Commands", "when_to_use": "List registered protein commands for logic.attach.", "write_mode": null}, {"action": "logic.flush_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.flush_batch", "mutation_risk": "low", "related_tools": ["logic.create", "logic.list"], "source": "overlay", "title": "Logic Flush Batch", "when_to_use": "Commit coalesced logic writes after bulk edits."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Commit coalesced logic writes after bulk edits.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string - Success message", "type": "any"}, "project_id": {"description": "int - Project ID for which batch was flushed", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "related_tools": ["logic.create", "logic.list"], "required_cap": "logic_write", "safe_action": "logic_flush_batch", "summary": "Force flush logic batch for a project (saves all accumulated rules immediately)", "title": "Logic Flush Batch", "when_to_use": "Commit coalesced logic writes after bulk edits.", "write_mode": null}, {"action": "logic.dry_run", "aliases": ["rules.test_rules"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.dry_run", "mutation_risk": "low", "source": "overlay", "title": "Logic Dry Run", "when_blocked": {"invalid_parameters": "logic_id required — not template_id or inline rule spec", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "when_to_use": "Before activating a rule on production data."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Before activating a rule on production data.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"protein": {"description": "final protein state", "type": "any"}, "trace": {"description": "list of StepTrace", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "logic_write", "safe_action": "logic_dry_run", "summary": "Simulate a logic rule execution without side effects (F2.5).", "title": "Logic Dry Run", "verification_not_applicable_reason": "audit_only", "when_blocked": {"invalid_parameters": "logic_id required — not template_id or inline rule spec", "logic_execution_failed": "logic.get graph — fix processor ids via logic.get_processors", "not_found": "logic.list or logic.get — logic_id from create/attach receipt"}, "when_to_use": "Before activating a rule on production data.", "write_mode": null}, {"action": "logic.list_versions", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.list_versions", "source": "overlay", "title": "Logic List Versions", "when_to_use": "List historical snapshots stored on a rule (F2.9)."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List historical snapshots stored on a rule (F2.9).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"versions": {"description": "Array of {id, hlc, created_at, summary}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "mcp_read", "safe_action": "logic_list_versions", "summary": "List historical snapshots stored on a rule (F2.9).", "title": "Logic List Versions", "when_to_use": "List historical snapshots stored on a rule (F2.9).", "write_mode": null}, {"action": "logic.diff_versions", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.diff_versions", "source": "overlay", "title": "Logic Diff Versions", "when_to_use": "Diff two rule snapshots (F2.9)."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Diff two rule snapshots (F2.9).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"delta": {"description": "Object keyed by path with {old, new}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "mcp_read", "safe_action": "logic_diff_versions", "summary": "Diff two rule snapshots (F2.9).", "title": "Logic Diff Versions", "when_to_use": "Diff two rule snapshots (F2.9).", "write_mode": null}, {"action": "logic.restore_version", "aliases": ["logic.revert"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.restore_version", "mutation_risk": "low", "source": "overlay", "title": "Logic Restore Version", "when_to_use": "Roll a rule back to a prior snapshot (F2.9)."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Roll a rule back to a prior snapshot (F2.9).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic": {"description": "Restored rule", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "logic_write", "safe_action": "logic_restore_version", "summary": "Roll a rule back to a prior snapshot (F2.9).", "title": "Logic Restore Version", "when_to_use": "Roll a rule back to a prior snapshot (F2.9).", "write_mode": null}, {"action": "logic.export_json", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.export_json", "source": "overlay", "title": "Logic Export Json", "when_to_use": "Export a logic rule as JSON for backup / cross-project copy."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Export a logic rule as JSON for backup / cross-project copy.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic": {"description": "Exported rule body", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "mcp_read", "safe_action": "logic_export_json", "summary": "Export a logic rule as JSON for backup / cross-project copy.", "title": "Logic Export Json", "when_to_use": "Export a logic rule as JSON for backup / cross-project copy.", "write_mode": null}, {"action": "logic.import_json", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.import_json", "mutation_risk": "low", "source": "overlay", "title": "Logic Import Json", "when_to_use": "Import a logic rule from JSON (creates a new rule)."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Import a logic rule from JSON (creates a new rule).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic_id": {"description": "ID of the newly created rule", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "logic_write", "safe_action": "logic_import_json", "summary": "Import a logic rule from JSON (creates a new rule).", "title": "Logic Import Json", "when_to_use": "Import a logic rule from JSON (creates a new rule).", "write_mode": null}, {"action": "logic.install_blueprint", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.install_blueprint", "mutation_risk": "low", "source": "overlay", "title": "Logic Install Blueprint", "when_to_use": "Install a catalog blueprint into the project (alias of attach_template with field_values)."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Install a catalog blueprint into the project (alias of attach_template with field_values).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic_id": {"description": "ID of the newly created rule", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "logic_write", "safe_action": "logic_install_blueprint", "summary": "Install a catalog blueprint into the project (alias of attach_template with field_values).", "title": "Logic Install Blueprint", "when_to_use": "Install a catalog blueprint into the project (alias of attach_template with field_values).", "write_mode": null}, {"action": "logic.attach_template", "aliases": ["logic.templates_catalog"], "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.attach_template", "mutation_risk": "low", "source": "overlay", "title": "Logic Attach Template", "when_blocked": {"internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "not_found": "template_id from built-in catalog — verify id before attach_template"}, "when_to_use": "Install a template from the built-in catalog into the current project."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "Install a template from the built-in catalog into the current project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic_id": {"description": "ID of the newly created rule", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "logic_write", "safe_action": "logic_attach_template", "summary": "Install a template from the built-in catalog into the current project.", "title": "Logic Attach Template", "when_blocked": {"internal_error": "logic.list — reuse logic_id or logic.create with template blocks", "invalid_parameters": "context.project_id bound — template_id required", "not_found": "template_id from built-in catalog — verify id before attach_template"}, "when_to_use": "Install a template from the built-in catalog into the current project.", "write_mode": null}, {"action": "logic.signals_catalog", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.signals_catalog", "source": "overlay", "title": "Logic Signals Catalog", "when_to_use": "List signal channels the logic engine can subscribe to."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List signal channels the logic engine can subscribe to.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channels": {"description": "Array of signal channels", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "mcp_read", "safe_action": "logic_signals_catalog", "summary": "List signal channels the logic engine can subscribe to.", "title": "Logic Signals Catalog", "when_to_use": "List signal channels the logic engine can subscribe to.", "write_mode": null}, {"action": "logic.mcp_actions_catalog", "capability_descriptor": {"complexity": "intermediate", "domain": "logic", "genetic_tags": ["core.mcp.logic.gen1"], "id": "logic.mcp_actions_catalog", "source": "overlay", "title": "Logic Mcp Actions Catalog", "when_to_use": "List MCP actions addressable from logic rules."}, "domain_title": "Logic MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.logic.gen1"], "instruction_hint": "List MCP actions addressable from logic rules.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.logic", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"description": "Array of {name, category, description}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.logic.gen1", "related_prompts": ["create_logic_rule", "agentstack_safe_project_cycle"], "required_cap": "mcp_read", "safe_action": "logic_mcp_actions_catalog", "summary": "List MCP actions addressable from logic rules.", "title": "Logic Mcp Actions Catalog", "when_to_use": "List MCP actions addressable from logic rules.", "write_mode": null}], "mentor": [{"action": "mentor.journal.list", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.journal.list", "source": "overlay", "title": "Mentor Journal List", "when_to_use": "Mentor turn journal — prefer knowledge.journal.list."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Mentor turn journal — prefer knowledge.journal.list.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_journal_list", "summary": "MCP tool mentor.journal.list", "title": "Mentor Journal List", "when_to_use": "Mentor turn journal — prefer knowledge.journal.list.", "write_mode": null}, {"action": "mentor.eval.run", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run", "source": "overlay", "title": "Mentor Eval Run", "when_to_use": "Run single mentor eval — prefer knowledge.eval.run."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Run single mentor eval — prefer knowledge.eval.run.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_eval_run", "summary": "MCP tool mentor.eval.run", "title": "Mentor Eval Run", "when_to_use": "Run single mentor eval — prefer knowledge.eval.run.", "write_mode": null}, {"action": "mentor.eval.retrieval", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.retrieval", "source": "overlay", "title": "Mentor Eval Retrieval", "when_to_use": "Retrieval slice eval before knowledge.eval.run_all."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Retrieval slice eval before knowledge.eval.run_all.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_eval_retrieval", "summary": "MCP tool mentor.eval.retrieval", "title": "Mentor Eval Retrieval", "when_to_use": "Retrieval slice eval before knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.eval.run_all", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.eval.run_all", "source": "overlay", "title": "Mentor Eval Run All", "when_to_use": "Full eval harness — prefer knowledge.eval.run_all."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Full eval harness — prefer knowledge.eval.run_all.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_eval_run_all", "summary": "MCP tool mentor.eval.run_all", "title": "Mentor Eval Run All", "when_to_use": "Full eval harness — prefer knowledge.eval.run_all.", "write_mode": null}, {"action": "mentor.export", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.export", "source": "overlay", "title": "Mentor Export", "when_to_use": "Export mentor config — prefer knowledge.export."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Export mentor config — prefer knowledge.export.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_export", "summary": "MCP tool mentor.export", "title": "Mentor Export", "when_to_use": "Export mentor config — prefer knowledge.export.", "write_mode": null}, {"action": "mentor.principal_link.upsert", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.upsert", "mutation_risk": "low", "source": "overlay", "title": "Mentor Principal Link Upsert", "when_to_use": "Upsert principal link row after bind_code."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Upsert principal link row after bind_code.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_principal_link_upsert", "summary": "MCP tool mentor.principal_link.upsert", "title": "Mentor Principal Link Upsert", "when_to_use": "Upsert principal link row after bind_code.", "write_mode": null}, {"action": "mentor.principal_link.bind_code", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.principal_link.bind_code", "source": "overlay", "title": "Mentor Principal Link Bind Code", "when_to_use": "Bind principal/GetCourse link code to user."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Bind principal/GetCourse link code to user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_principal_link_bind_code", "summary": "MCP tool mentor.principal_link.bind_code", "title": "Mentor Principal Link Bind Code", "when_to_use": "Bind principal/GetCourse link code to user.", "write_mode": null}, {"action": "mentor.kb.ingest", "capability_descriptor": {"complexity": "intermediate", "domain": "mentor", "genetic_tags": ["core.knowledge.platform.gen1"], "id": "mentor.kb.ingest", "source": "overlay", "title": "Mentor Kb Ingest", "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest."}, "domain_title": "Mentor MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.knowledge.platform.gen1"], "instruction_hint": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.mentor", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.knowledge.platform.gen1", "required_cap": "bots_run", "safe_action": "mentor_kb_ingest", "summary": "MCP tool mentor.kb.ingest", "title": "Mentor Kb Ingest", "when_to_use": "Ingest KB for mentor — prefer knowledge.kb.ingest.", "write_mode": null}], "messaging": [{"action": "messaging.send_test_email", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_test_email", "source": "overlay", "title": "Messaging Send Test Email", "when_to_use": "Ops: send test email via messaging plane (admin)."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send test email via messaging plane (admin).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_send_test_email", "summary": "Send ecosystem test email (admin).", "title": "Messaging Send Test Email", "when_to_use": "Ops: send test email via messaging plane (admin).", "write_mode": null}, {"action": "messaging.get_config", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_config", "source": "overlay", "title": "Messaging Get Config", "when_to_use": "Ops: read Mail Hub config without secrets."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: read Mail Hub config without secrets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "object", "type": "any"}, "provider_status": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_get_config", "summary": "Get sanitized ecosystem messaging config (admin).", "title": "Messaging Get Config", "when_to_use": "Ops: read Mail Hub config without secrets.", "write_mode": null}, {"action": "messaging.test_connection", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.test_connection", "source": "overlay", "title": "Messaging Test Connection", "when_to_use": "Ops: verify Resend/SMTP credentials before send."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify Resend/SMTP credentials before send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_test_connection", "summary": "Probe configured email provider (admin).", "title": "Messaging Test Connection", "when_to_use": "Ops: verify Resend/SMTP credentials before send.", "write_mode": null}, {"action": "messaging.send_email", "aliases": ["messaging.send"], "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.send_email", "source": "overlay", "title": "Messaging Send Email", "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_send_email", "summary": "Send email to any address (ecosystem admin). Use template_name + template_data for auth templates.", "title": "Messaging Send Email", "when_to_use": "Ops: send transactional or custom email from ecosystem Mail Hub provider.", "write_mode": null}, {"action": "messaging.get_auth_email_readiness", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_auth_email_readiness", "source": "overlay", "title": "Messaging Get Auth Email Readiness", "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: verify confirm-email and password-reset can send before go-live.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"readiness": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_get_auth_email_readiness", "summary": "Probe auth email plane — provider secrets, email_confirmation + password_reset + email_otp templates.", "title": "Messaging Get Auth Email Readiness", "when_to_use": "Ops: verify confirm-email and password-reset can send before go-live.", "write_mode": null}, {"action": "messaging.put_config", "capability_descriptor": {"complexity": "intermediate", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.put_config", "source": "overlay", "title": "Messaging Put Config", "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config)."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_put_config", "summary": "Update ecosystem messaging config and provider secrets (admin).", "title": "Messaging Put Config", "when_to_use": "Ops: Mail Hub config write via MCP (same as PUT /admin/messaging/config).", "write_mode": null}, {"action": "messaging.setup_info", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.setup_info", "source": "overlay", "title": "Messaging Setup Info", "when_to_use": "Ops: Resend webhook URLs and env var checklist."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: Resend webhook URLs and env var checklist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_setup_info", "summary": "Mail Hub setup checklist, webhook URLs, DNS hints (admin).", "title": "Messaging Setup Info", "when_to_use": "Ops: Resend webhook URLs and env var checklist.", "write_mode": null}, {"action": "messaging.ensure_auth_templates", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.ensure_auth_templates", "source": "overlay", "title": "Messaging Ensure Auth Templates", "when_to_use": "Ops: seed password-reset and confirm-email templates."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: seed password-reset and confirm-email templates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_ensure_auth_templates", "summary": "Merge auth email templates into ecosystem notifications config (admin).", "title": "Messaging Ensure Auth Templates", "when_to_use": "Ops: seed password-reset and confirm-email templates.", "write_mode": null}, {"action": "messaging.get_delivery_health", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.get_delivery_health", "source": "overlay", "title": "Messaging Get Delivery Health", "when_to_use": "Ops: messaging delivery health snapshot."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: messaging delivery health snapshot.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_get_delivery_health", "summary": "Messaging ops status snapshot (admin).", "title": "Messaging Get Delivery Health", "when_to_use": "Ops: messaging delivery health snapshot.", "write_mode": null}, {"action": "messaging.list_recent_deliveries", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_recent_deliveries", "source": "overlay", "title": "Messaging List Recent Deliveries", "when_to_use": "Ops: recent delivery log rows for triage."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: recent delivery log rows for triage.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "array", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_list_recent_deliveries", "summary": "Recent messaging delivery log rows (admin).", "title": "Messaging List Recent Deliveries", "when_to_use": "Ops: recent delivery log rows for triage.", "write_mode": null}, {"action": "messaging.list_suppressions", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.list_suppressions", "source": "overlay", "title": "Messaging List Suppressions", "when_to_use": "Ops: list bounce/complaint suppressions."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: list bounce/complaint suppressions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "array", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_list_suppressions", "summary": "List ecosystem email suppression list (bounces/complaints).", "title": "Messaging List Suppressions", "when_to_use": "Ops: list bounce/complaint suppressions.", "write_mode": null}, {"action": "messaging.remove_suppression", "capability_descriptor": {"complexity": "simple", "domain": "messaging", "genetic_tags": ["core.messaging.delivery.gen1"], "id": "messaging.remove_suppression", "mutation_risk": "high", "source": "overlay", "title": "Messaging Remove Suppression", "when_to_use": "Ops: unblock email after deliverability fix."}, "domain_title": "Messaging MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.messaging.delivery.gen1"], "instruction_hint": "Ops: unblock email after deliverability fix.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.messaging", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.messaging.delivery.gen1", "required_cap": "social_read", "safe_action": "messaging_remove_suppression", "summary": "Remove an email from the ecosystem suppression list (admin).", "title": "Messaging Remove Suppression", "when_to_use": "Ops: unblock email after deliverability fix.", "write_mode": null}], "notifications": [{"action": "notifications.subscribe_push", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.subscribe_push", "source": "overlay", "title": "Notifications Subscribe Push", "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "VAPID setup hint; client still calls PushManager.subscribe.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"configured": {"description": "boolean", "type": "any"}, "hint": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "notifications_subscribe_push", "summary": "Returns VAPID status; browser must still call PushManager.subscribe.", "title": "Notifications Subscribe Push", "when_to_use": "VAPID setup hint; client still calls PushManager.subscribe.", "write_mode": null}, {"action": "notifications.send_push", "aliases": ["notifications.send", "notifications.send_notification"], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.send_push", "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "source": "overlay", "title": "Notifications Send Push", "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Enqueue OS web push — prefer over deprecated notifications.send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.subscribe_push", "notifications.list_prefs", "web_push.get_health"], "required_cap": "mcp_read", "safe_action": "notifications_send_push", "summary": "Enqueue OS web push for a user (self or admin).", "title": "Notifications Send Push", "when_to_use": "Enqueue OS web push — prefer over deprecated notifications.send.", "write_mode": null}, {"action": "notifications.deliver", "aliases": ["notifications.notify", "notifications.send_bot", "notifications.send_channel"], "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.deliver", "related_tools": ["notifications.send_push", "notifications.list_prefs", "bots.attach_channel", "bots.go_live", "messaging.send_email"], "source": "live", "title": "Notifications Deliver", "when_to_use": "Project notice to a user. Setup recipe mcp_notify_channels_v1. The user must /login in the bot first or the channel is skipped."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Project notice to a user. Setup recipe mcp_notify_channels_v1. The user must /login in the bot fi…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"delivery": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.send_push", "notifications.list_prefs", "bots.attach_channel", "bots.go_live", "messaging.send_email"], "required_cap": "mcp_read", "safe_action": "notifications_deliver", "summary": "Send one notice on email, in-app, web push, webhook, or a bound bot channel (telegram, max, whatsapp, instagram, slack, discord, sms).", "title": "Notifications Deliver", "when_to_use": "Project notice to a user. Setup recipe mcp_notify_channels_v1. The user must /login in the bot first or the channel is skipped.", "write_mode": null}, {"action": "notifications.cancel_push", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.cancel_push", "source": "overlay", "title": "Notifications Cancel Push", "when_to_use": "Cancel pending push by correlation_key prefix."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Cancel pending push by correlation_key prefix.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"removed": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "notifications_cancel_push", "summary": "Cancel pending push items by correlation key prefix.", "title": "Notifications Cancel Push", "when_to_use": "Cancel pending push by correlation_key prefix.", "write_mode": null}, {"action": "notifications.list_prefs", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.list_prefs", "related_tools": ["notifications.update_prefs", "notifications.register_category"], "source": "overlay", "title": "Notifications List Prefs", "when_to_use": "Read messenger + category×channel matrix before update_prefs."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Read messenger + category×channel matrix before update_prefs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"prefs": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.update_prefs", "notifications.register_category"], "required_cap": "mcp_read", "safe_action": "notifications_list_prefs", "summary": "Messenger prefs plus category×channel matrix and enrolled bot sources.", "title": "Notifications List Prefs", "when_to_use": "Read messenger + category×channel matrix before update_prefs.", "write_mode": null}, {"action": "notifications.update_prefs", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.update_prefs", "mutation_risk": "low", "source": "overlay", "title": "Notifications Update Prefs", "when_to_use": "Patch notification prefs matrix for signed-in user."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Patch notification prefs matrix for signed-in user.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "project_admin", "safe_action": "notifications_update_prefs", "summary": "Patch messenger prefs and/or category×channel notification matrix.", "title": "Notifications Update Prefs", "when_to_use": "Patch notification prefs matrix for signed-in user.", "write_mode": null}, {"action": "notifications.register_category", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.register_category", "source": "overlay", "title": "Notifications Register Category", "when_to_use": "Register push category id before send_push campaigns."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Register push category id before send_push campaigns.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "notifications_register_category", "summary": "Register a logical push category in user messenger prefs (persisted).", "title": "Notifications Register Category", "when_to_use": "Register push category id before send_push campaigns.", "write_mode": null}, {"action": "notifications.inbox_list", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.inbox_list", "source": "overlay", "title": "Notifications Inbox List", "when_to_use": "Hosted bell dropdown and settings inbox."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell dropdown and settings inbox.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"notifications": {"description": "array", "type": "any"}, "total": {"description": "integer", "type": "any"}, "unread_count": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "notifications_inbox_list", "summary": "List Fabric in-app inbox rows for a project (parity with GET /api/notifications/{project_id}).", "title": "Notifications Inbox List", "when_to_use": "Hosted bell dropdown and settings inbox.", "write_mode": null}, {"action": "notifications.delete_source", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.delete_source", "related_tools": ["channels.delete_source", "notifications.list_prefs"], "source": "live", "title": "Notifications Delete Source", "when_to_use": "Profile unenroll bot or web_push source."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Profile unenroll bot or web_push source.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"sources": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delete_source", "notifications.list_prefs"], "required_cap": "mcp_read", "safe_action": "notifications_delete_source", "summary": "Remove a notification source by id (parity with DELETE notification-sources).", "title": "Notifications Delete Source", "when_to_use": "Profile unenroll bot or web_push source.", "write_mode": null}, {"action": "notifications.delivery_status", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.delivery_status", "related_tools": ["channels.delivery_status", "notifications.deliver"], "source": "live", "title": "Notifications Delivery Status", "when_to_use": "Track delivery after notifications.deliver or channels.deliver."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Track delivery after notifications.deliver or channels.deliver.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"latest_status": {"description": "string", "type": "any"}, "receipts": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["channels.delivery_status", "notifications.deliver"], "required_cap": "mcp_read", "safe_action": "notifications_delivery_status", "summary": "Delivery receipts for a correlation_key (user DNA ring buffer).", "title": "Notifications Delivery Status", "when_to_use": "Track delivery after notifications.deliver or channels.deliver.", "write_mode": null}, {"action": "notifications.send_with_fallback", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.send_with_fallback", "related_tools": ["notifications.deliver", "channels.deliver", "channels.resolve_routing"], "source": "live", "title": "Notifications Send With Fallback", "when_to_use": "Guaranteed delivery for security/auth OTP and billing alerts."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "external_side_effect", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Guaranteed delivery for security/auth OTP and billing alerts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"delivery": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "related_tools": ["notifications.deliver", "channels.deliver", "channels.resolve_routing"], "required_cap": "mcp_read", "safe_action": "notifications_send_with_fallback", "summary": "Deliver with category fallback chain (security/auth/billing) and in_app escalation when all channels fail.", "title": "Notifications Send With Fallback", "when_to_use": "Guaranteed delivery for security/auth OTP and billing alerts.", "write_mode": null}, {"action": "notifications.mark_read", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "notifications.mark_read", "source": "overlay", "title": "Notifications Mark Read", "when_to_use": "Hosted bell mark-as-read."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Hosted bell mark-as-read.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "notifications_mark_read", "summary": "Mark one project inbox notification as read (parity with PATCH …/read).", "title": "Notifications Mark Read", "when_to_use": "Hosted bell mark-as-read.", "write_mode": null}], "organelle": [{"action": "organelle.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "organelle", "genetic_tags": ["core.fabric.organelle_descriptors.gen1", "shared.organelles.gen1"], "id": "organelle.execute", "mutation_risk": "low", "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "source": "handler", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge."}, "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "instruction_hint": "Call a registered organelle op through the single dispatch bridge.", "mutation_kind": "none", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"operation": {"description": "Echo of operation", "type": "any"}, "organelle_id": {"description": "Echo of organelle_id", "type": "any"}, "result": {"description": "Organelle operation return value", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "related_tools": ["storage.list_files", "storage.delete_file", "organelle.storage.meta", "organelle.work_queue.meta"], "required_cap": "mcp_read", "safe_action": "organelle_execute", "summary": "Invoke a registered organelle op via dispatch (ring_pool / cell_store today; storage & work_queue via related tools).", "title": "Execute organelle operation", "when_to_use": "Call a registered organelle op through the single dispatch bridge.", "write_mode": null}], "payments": [{"action": "payments.create", "aliases": ["payments.create_payment"], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.create", "mutation_risk": "low", "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "source": "overlay", "title": "Payments Create", "when_to_use": "AgentPay checkout for project wallet — chain payments.get for status."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "AgentPay checkout for project wallet — chain payments.get for status.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"amount": {"description": "float - Payment amount in specified currency", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp when payment was created", "type": "any"}, "currency": {"description": "string - Currency code used for payment", "type": "any"}, "description": {"description": "string - Payment description if provided", "type": "any"}, "payment_id": {"description": "string - Unique payment identifier (UUID format). Use this ID to track payment status or retrieve payment details later", "type": "any"}, "status": {"description": "string - Current payment status. Values: 'pending' (created, waiting for processing), 'processing' (payment is being processed), 'completed' (successfully paid), 'failed' (payment failed), 'cancelled' (payment was cancelled)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.list_transactions"], "required_cap": "payments", "safe_action": "payments_create", "summary": "Create a new payment transaction.", "title": "Payments Create", "tool_chains": ["payment_to_subscription", "trial_to_paid_tier", "trial_to_premium"], "when_to_use": "AgentPay checkout for project wallet — chain payments.get for status.", "write_mode": null}, {"action": "payments.get", "aliases": ["payments.get_status", "payments.status"], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.get", "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "source": "overlay", "title": "Payments Get", "when_to_use": "Poll payment status after payments.create or webhook delay."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Poll payment status after payments.create or webhook delay.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"amount": {"description": "float - Payment amount", "type": "any"}, "completed_at": {"description": "string (optional) - ISO 8601 timestamp when payment was completed (if status is 'completed')", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp when payment was created", "type": "any"}, "currency": {"description": "string - Currency code", "type": "any"}, "description": {"description": "string - Payment description", "type": "any"}, "payment_id": {"description": "string - Payment identifier (UUID)", "type": "any"}, "payment_method": {"description": "string - Payment method used", "type": "any"}, "project_id": {"description": "int - Project ID associated with payment", "type": "any"}, "status": {"description": "string - Current payment status: 'pending', 'processing', 'completed', 'failed', 'cancelled'", "type": "any"}, "updated_at": {"description": "string - ISO 8601 timestamp when payment was last updated", "type": "any"}, "user_id": {"description": "int - User ID who created the payment", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.refund", "payments.list_transactions", "payments.get_balance"], "required_cap": "payments", "safe_action": "payments_get", "summary": "Get detailed payment information by payment ID.", "title": "Payments Get", "when_to_use": "Poll payment status after payments.create or webhook delay.", "write_mode": null}, {"action": "payments.list_transactions", "aliases": ["wallets.list_transactions"], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.list_transactions", "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "source": "overlay", "title": "Payments List Transactions", "when_to_use": "Audit payment ledger — filter by user or time window."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Audit payment ledger — filter by user or time window.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Total number of transactions found", "type": "any"}, "project_id": {"description": "int - Project ID for which transactions were retrieved", "type": "any"}, "transactions": {"description": "array - Array of transaction objects. Each transaction contains: payment_id, status, amount, currency, description, payment_method, created_at, updated_at, completed_at", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.get", "payments.get_balance", "payments.create"], "required_cap": "payments", "safe_action": "payments_list_transactions", "summary": "List all payment transactions for a project.", "title": "Payments List Transactions", "when_to_use": "Audit payment ledger — filter by user or time window.", "write_mode": null}, {"action": "payments.get_balance", "aliases": ["wallets.get_balance"], "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.get_balance", "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "source": "handler", "title": "Payments Get Balance", "when_to_use": "Project wallet balance before pay, refund, or payout."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "inputSchema": {"examples": [{"description": "Retrieve current wallet balance for the current project", "name": "Get balance for current project", "request": {}, "response": {"data": {"balance": 1000.0, "currency": "USD", "project_id": 123, "updated_at": "2025-01-20T10:00:00Z"}, "success": true}}, {"description": "Retrieve current wallet balance for a specific project", "name": "Get balance for specific project", "request": {"project_id": 123}, "response": {"data": {"balance": 500.5, "currency": "EUR", "project_id": 123, "updated_at": "2025-01-20T09:30:00Z"}, "success": true}}], "properties": {"project_id": {"description": "Project ID to get balance for. If not specified, uses current project from context", "example": 123, "type": "integer"}}, "required": [], "type": "object"}, "instruction_hint": "Project wallet balance before pay, refund, or payout.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"balance": {"description": "float - Current wallet balance amount. Can be positive (funds available) or negative (overdraft)", "type": "any"}, "currency": {"description": "string - Currency code for the balance (e.g., 'USD', 'EUR')", "type": "any"}, "project_id": {"description": "int - Project ID for which balance was retrieved", "type": "any"}, "updated_at": {"description": "string - ISO 8601 timestamp when balance was last updated", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "wallets.list", "wallets.transfer"], "required_cap": "payments", "safe_action": "payments_get_balance", "summary": "Get current wallet balance for a project.", "title": "Payments Get Balance", "tool_chains": ["economy_setup"], "when_to_use": "Project wallet balance before pay, refund, or payout.", "write_mode": null}, {"action": "payments.refund", "capability_descriptor": {"complexity": "intermediate", "domain": "payments", "genetic_tags": ["core.mcp.payments.gen1"], "id": "payments.refund", "mutation_risk": "low", "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "source": "overlay", "title": "Payments Refund", "when_to_use": "Reverse a completed payment; requires payment_id from payments.get."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Reverse a completed payment; requires payment_id from payments.get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "payment_id": {"description": "string", "type": "any"}, "refund_amount": {"description": "number", "type": "any"}, "status": {"description": "refunded", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["payments.create", "payments.get", "payments.list_transactions"], "required_cap": "payments", "safe_action": "payments_refund", "summary": "Refund a completed payment.", "title": "Payments Refund", "when_to_use": "Reverse a completed payment; requires payment_id from payments.get.", "write_mode": null}], "permissions": [{"action": "permissions.effective", "aliases": ["capabilities.effective"], "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "permissions.effective", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "source": "overlay", "title": "Permissions Effective", "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths."}, "domain_title": "Permissions MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.permissions.gen1"], "instruction_hint": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.permissions", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.permissions.gen1", "related_tools": ["rbac.get_roles", "rbac.check_permission", "buffs.get_effective_limits", "data_access.test_mask", "data_access.check_field"], "required_cap": "mcp_read", "safe_action": "permissions_effective", "summary": "Effective permission surface: token caps ∩ RBAC role ∩ buff limits. Optional resource + path_prefixes for Field Access Policy write preflight.", "title": "Permissions Effective", "when_to_use": "Before destructive mutation or agents.update path_updates — understand caps and writable paths.", "write_mode": null}], "preflight": [{"action": "preflight.check", "ai_tips": "Before generation.promote or bulk tenant mutation.", "aliases": ["ai_builder.preflight"], "capability_descriptor": {"complexity": "intermediate", "domain": "discovery", "genetic_tags": ["core.mcp.discovery.gen1"], "id": "preflight.check", "related_tools": ["generation.supply_status", "rbac.check_permission"], "source": "overlay", "title": "Preflight Check", "when_to_use": "Before generation.promote or bulk tenant mutation."}, "domain_title": "Preflight MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.preflight.gen1"], "instruction_hint": "Before generation.promote or bulk tenant mutation.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "domain_playbook", "organ_id": "mcp.preflight", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.preflight.gen1", "related_tools": ["generation.supply_status", "rbac.check_permission"], "safe_action": "preflight_check", "summary": "Tenant mutation preflight — supply, limits, optional RBAC permission.", "title": "Preflight Check", "when_to_use": "Before generation.promote or bulk tenant mutation.", "write_mode": null}, {"action": "preflight.simulate", "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.preflight.gen1"], "id": "preflight.simulate", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "source": "live", "title": "Preflight Simulate", "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action."}, "domain_title": "Preflight MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.preflight.gen1"], "instruction_hint": "Before wiring automation — test PAT/session permissions without executing the action.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.preflight", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.preflight.gen1", "related_tools": ["permissions.effective", "preflight.check", "rbac.check_permission"], "required_cap": "mcp_read", "safe_action": "preflight_simulate", "summary": "IAM-style dry-run: would this session be allowed to call MCP action X? Returns L1 caps, L2 RBAC, and optional FAP path probe.", "title": "Preflight Simulate", "when_to_use": "Before wiring automation — test PAT/session permissions without executing the action.", "write_mode": null}], "processors": [{"action": "processors.list", "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.list", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "source": "overlay", "title": "Processors List", "when_to_use": "Catalog processors before processors.execute."}, "domain_title": "Processors MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Catalog processors before processors.execute.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"processors": {"description": "array - Array of processor metadata objects. Each processor contains: name (string - processor identifier), description (string - what processor does), category (string - processor category like 'data_processing', 'notifications', 'dna_operations'), input_schema (object - JSON schema for input parameters), output_schema (object - JSON schema for output), examples (array - usage examples), capabilities (array - list of available actions), ai_instructions (string - instructions for AI on how to use)", "type": "any"}, "total": {"description": "int - Total number of available processors", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.processors.gen1", "related_tools": ["processors.get_metadata", "logic.create", "logic.get_processors"], "required_cap": "mcp_read", "safe_action": "processors_list", "summary": "List all available processors with their metadata.", "title": "Processors List", "when_to_use": "Catalog processors before processors.execute.", "write_mode": null}, {"action": "processors.get_metadata", "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.get_metadata", "related_tools": ["processors.list", "processors.execute"], "source": "overlay", "title": "Processors Get Metadata", "when_blocked": {"invalid_parameters": "Required param processor_name missing — call processors.list first, then pass processor_name.", "processor_not_found": "Unknown processor_name — processors.list then retry get_metadata with an exact catalog name."}, "when_to_use": "Schema for one processor before wiring logic. Pass processor_name from processors.list."}, "domain_title": "Processors MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.processors.gen1"], "instruction_hint": "Schema for one processor before wiring logic. Pass processor_name from processors.list.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"capabilities": {"description": "array - List of capabilities", "type": "any"}, "description": {"description": "string - Processor description", "type": "any"}, "examples": {"description": "array - Usage examples", "type": "any"}, "input_schema": {"description": "object - Input parameter schema", "type": "any"}, "name": {"description": "string - Processor name", "type": "any"}, "output_schema": {"description": "object - Output schema", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.processors.gen1", "related_tools": ["processors.list", "processors.execute"], "required_cap": "mcp_read", "safe_action": "processors_get_metadata", "summary": "Get detailed metadata for a specific processor.", "title": "Processors Get Metadata", "when_blocked": {"invalid_parameters": "Required param processor_name missing — call processors.list first, then pass processor_name.", "processor_not_found": "Unknown processor_name — processors.list then retry get_metadata with an exact catalog name."}, "when_to_use": "Schema for one processor before wiring logic. Pass processor_name from processors.list.", "write_mode": null}, {"action": "processors.execute", "capability_descriptor": {"complexity": "intermediate", "domain": "processors", "genetic_tags": ["core.mcp.processors.gen1"], "id": "processors.execute", "mutation_risk": "low", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "source": "handler", "title": "Processors Execute", "when_to_use": "Use this tool to test a processor before using it in logic rules"}, "domain_title": "Processors MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.processors.gen1"], "inputSchema": {"examples": [{"description": "Execute processor to add two numbers", "name": "Execute field operations processor - add", "request": {"params": {"action": "add", "parameters": {"field1": 10, "field2": 5, "result_field": "sum"}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": 15, "success": true}, "success": true}}, {"description": "Compare two values using processor", "name": "Execute field operations processor - compare", "request": {"params": {"action": "compare", "parameters": {"field1": "user.balance", "field2": 100, "operator": ">="}, "processor_name": "field_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": true, "success": true}, "success": true}}, {"description": "Execute processor to get entity data", "name": "Execute DNA operations processor", "request": {"params": {"action": "get", "parameters": {"entity": "data_projects_8dna", "filters": {"project_id": 123}}, "processor_name": "dna_operations_processor"}, "tool": "processors.execute"}, "response": {"data": {"result": {"id": 123, "name": "My Project"}, "success": true}, "success": true}}], "properties": {"action": {"description": "Processor action to execute. Available actions depend on processor. Use processors.get_metadata to see available actions for a specific processor. Examples: 'add', 'subtract', 'get', 'create', 'send'", "example": "add", "type": "string"}, "parameters": {"description": "Processor-specific parameters object. Structure depends on processor and action. Use processors.get_metadata to see required parameters. Common fields: field1, field2, result_field (for field_operations), entity, filters (for dna_operations)", "example": {"field1": "user.balance", "field2": 100, "result_field": "user.balance"}, "type": "object"}, "processor_name": {"description": "Processor name (identifier). Use processors.list to see all available processors. Must match exactly a processor from the list", "example": "field_operations_processor", "type": "string"}}, "required": ["processor_name", "action", "parameters"], "type": "object"}, "instruction_hint": "Use this tool to test a processor before using it in logic rules", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.processors", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"execution_time_ms": {"description": "float - Execution time in milliseconds (if available)", "type": "any"}, "result": {"description": "any - Processor execution result. Type depends on processor and action. For field_operations_processor: number (for math operations) or boolean (for compare). For dna_operations_processor: object (entity data). For notification_processor: object with status", "type": "any"}, "success": {"description": "bool - Whether execution was successful", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.processors.gen1", "related_tools": ["processors.list", "processors.get_metadata", "logic.create"], "required_cap": "logic_write", "safe_action": "processors_execute", "summary": "Execute a processor directly.", "title": "Processors Execute", "when_to_use": "Use this tool to test a processor before using it in logic rules", "write_mode": null}], "projects": [{"action": "projects.get_projects", "aliases": ["projects.list", "projects.list_projects"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_projects", "related_tools": ["projects.get_project", "projects.create_project", "auth.get_profile"], "source": "overlay", "title": "Projects Get Projects", "when_to_use": "List workspaces for signed-in user."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "List workspaces for signed-in user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Total number of projects accessible to the user", "type": "any"}, "projects": {"description": "array - Array of project objects. Each project contains: id (int - project ID), name (string - project name), description (string - project description), is_active (bool - whether project is active), created_at (string - ISO timestamp), updated_at (string - ISO timestamp), user_id (int - owner user ID), config (object - project configuration)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project", "projects.create_project", "auth.get_profile"], "required_cap": "mcp_read", "safe_action": "projects_get_projects", "summary": "Get list of projects for the current user.", "title": "List Projects", "when_to_use": "List workspaces for signed-in user.", "write_mode": null}, {"action": "projects.get_project", "aliases": ["projects.get"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_project", "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "source": "overlay", "title": "Projects Get Project", "when_to_use": "Load project metadata + ids for scoped actions."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Load project metadata + ids for scoped actions.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"description": {"description": "string - Project description", "type": "any"}, "id": {"description": "int - Project ID", "type": "any"}, "is_active": {"description": "bool - Whether project is active", "type": "any"}, "name": {"description": "string - Project name", "type": "any"}, "stats": {"description": "object - Project statistics (if requested)", "type": "any"}, "users": {"description": "array - Project users (if requested)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_data", "projects.get_users", "projects.get_stats"], "required_cap": "mcp_read", "safe_action": "projects_get_project", "summary": "Get detailed information about a specific project.", "title": "Projects Get Project", "tool_chains": ["rbac_manage_members"], "when_to_use": "Load project metadata + ids for scoped actions.", "write_mode": null}, {"action": "projects.create_project", "aliases": ["projects.create"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project", "mutation_risk": "low", "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "source": "overlay", "title": "Projects Create Project", "when_to_use": "Create workspace after auth — not anonymous bootstrap."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Create workspace after auth — not anonymous bootstrap.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"api_key": {"description": "string - Generated API key for project access (if created)", "type": "any"}, "auth_key": {"description": "string - Auth key for project (if created)", "type": "any"}, "config": {"description": "object - Project configuration with settings, permissions, preset_id", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp of creation", "type": "any"}, "description": {"description": "string - Project description", "type": "any"}, "id": {"description": "int - Created project ID (logical ID, >= 1025 for user projects)", "type": "any"}, "is_active": {"description": "bool - Whether project is active (default: true)", "type": "any"}, "name": {"description": "string - Project name", "type": "any"}, "user_id": {"description": "int - Owner user ID (current user)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.add_user", "apikeys.create", "projects.get_project"], "required_cap": "project_admin", "safe_action": "projects_create_project", "summary": "Create a new project.", "title": "Projects Create Project", "tool_chains": ["multi_tenant_onboarding"], "when_to_use": "Create workspace after auth — not anonymous bootstrap.", "write_mode": null}, {"action": "projects.create_project_anonymous", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.create_project_anonymous", "mutation_risk": "low", "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile"], "source": "overlay", "title": "Projects Create Project Anonymous", "when_to_use": "Try-it / plugin bootstrap without login — returns API keys once."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Try-it / plugin bootstrap without login — returns API keys once.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"bootstrap": {"description": "object - Neutral one-time credential metadata (field names only, no secrets)", "type": "any"}, "project": {"description": "object - Project details", "type": "any"}, "project_api_key": {"description": "string - Postel alias of user_api_key (same PAT)", "type": "any"}, "project_id": {"description": "int - Created project ID", "type": "any"}, "session_token": {"description": "string - Bearer token alternative to user_api_key", "type": "any"}, "user_api_key": {"description": "string - User PAT (prefix anon_ask_) for X-API-Key header", "type": "any"}, "user_id": {"description": "int - Anonymous user ID", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project", "apikeys.create", "auth.get_profile"], "required_cap": "project_admin", "safe_action": "projects_create_project_anonymous", "summary": "Create a new anonymous project for MCP clients without prior authentication.", "title": "Projects Create Project Anonymous", "tool_chains": ["user_with_trial", "game_setup", "project_bootstrap"], "when_to_use": "Try-it / plugin bootstrap without login — returns API keys once.", "write_mode": null}, {"action": "projects.get_data", "aliases": ["dna.data.get", "kv.get", "projects.get_settings", "storage.kv.get"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_data", "path_param_semantics": "read_key", "related_tools": ["projects.patch_data", "projects.get_project"], "source": "overlay", "title": "Projects Get Data", "when_to_use": "Read one 8DNA leaf (config, limits) without loading the full project blob."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Read one 8DNA leaf (config, limits) without loading the full project blob.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"path": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "value": {"description": "any - value at path", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.patch_data", "projects.get_project"], "required_cap": "mcp_read", "safe_action": "projects_get_data", "summary": "Read one nested path under project.data (REST GET /projects/{id}/data?path=). Use before projects.patch_data when you need the current leaf.", "title": "Projects Get Data", "when_to_use": "Read one 8DNA leaf (config, limits) without loading the full project blob.", "write_mode": null}, {"action": "projects.get_my_data", "aliases": ["profile.data.get", "users.me.data", "users.me.get"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_my_data", "path_param_semantics": "read_key", "related_tools": ["projects.patch_my_data", "projects.get_data"], "source": "overlay", "title": "Projects Get My Data", "when_to_use": "Private member state. Shared project config is projects.get_data."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Private member state. Shared project config is projects.get_data.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"path": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "value": {"description": "any", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.patch_my_data", "projects.get_data"], "required_cap": "mcp_read", "safe_action": "projects_get_my_data", "summary": "Read the signed-in member's project data (REST GET /projects/{id}/users/me/data). path is optional.", "title": "Projects Get My Data", "when_to_use": "Private member state. Shared project config is projects.get_data.", "write_mode": null}, {"action": "projects.patch_my_data", "ai_tips": "Private member leaf. Do not use this for site HTML or shared project config.", "aliases": ["profile.data.set", "users.me.patch"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_my_data", "mutation_risk": "low", "related_tools": ["projects.get_my_data", "projects.patch_data"], "source": "overlay", "title": "Projects Patch My Data", "when_to_use": "Private member leaf. Do not use this for site HTML or shared project config."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Private member leaf. Do not use this for site HTML or shared project config.", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"path": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_my_data", "projects.patch_data"], "required_cap": "project_admin", "safe_action": "projects_patch_my_data", "summary": "Leaf write on the signed-in member's project data (REST PATCH /projects/{id}/users/me/data). write_mode replace sets the path; merge overlays an object.", "title": "Projects Patch My Data", "when_to_use": "Private member leaf. Do not use this for site HTML or shared project config.", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete"]}, {"action": "projects.patch_data", "ai_tips": "Write one nested leaf — preferred over projects.update_project data=.", "aliases": ["dna.data.set", "projects.update_settings"], "anti_pattern": "Putting bot_spec.commands or knowledge markdown into projects.update_project data.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.patch_data", "mutation_risk": "low", "related_tools": ["projects.get_data", "projects.get_project"], "source": "overlay", "title": "Projects Patch Data", "when_to_use": "Write one nested leaf — preferred over projects.update_project data=."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": true}, "example_params": {"env_uuid": "example_string", "patches": [], "path": "example_string", "project_id": 123, "write_mode": "replace"}, "genetic_tags": ["core.projects.hub.gen1"], "inputSchema": {"properties": {"env_uuid": {"description": "Sandbox anchor UUID (overrides generation_env_uuid batch context)", "format": "uuid", "type": "string"}, "patches": {"description": "Single leaf {path, value}. path may be a string or a list of segments.", "type": "array"}, "path": {"description": "Dot path into project.data, e.g. config.theme. Or one patches item.", "type": "string"}, "project_id": {"description": "Project ID", "type": "integer"}, "value": {"description": "Any JSON leaf value (string, number, boolean, object, array)."}, "write_mode": {"default": "replace", "description": "replace/write/set/put = SET the path; merge/patch = overlay an object; delete = remove the path (jsonb #-). Same as REST PATCH /projects/{id}/data.", "enum": ["replace", "write", "set", "put", "merge", "patch", "delete"], "type": "string"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Write one nested leaf — preferred over projects.update_project data=.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"path": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}, "write": {"description": "object - mode diagnostic", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_data", "projects.get_project"], "required_cap": "project_admin", "rollback": ["generation.realign_to_prod"], "safe_action": "projects_patch_data", "summary": "Leaf SET on project.data (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it. Do not use projects.update_project for nested bot commands or ", "title": "Projects Patch Data", "tool_chains": ["crud_with_logic"], "verification": ["projects.get_data"], "verify": [{"action": "projects.get_data", "predicate": "named resource is visible"}], "when_to_use": "Write one nested leaf — preferred over projects.update_project data=.", "write_mode": ["replace", "write", "set", "put", "merge", "patch", "delete"], "write_mode_note": "Leaf path SET (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it."}, {"action": "projects.get_notify_policy", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.get_notify_policy", "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "source": "overlay", "title": "Projects Get Notify Policy", "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "object", "type": "any"}, "project_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.put_notify_policy", "channels.resolve_routing"], "required_cap": "mcp_read", "safe_action": "projects_get_notify_policy", "summary": "Read project.data.notify_policy (channel plane tenant defaults).", "title": "Projects Get Notify Policy", "when_to_use": "Before put_notify_policy or generation.diff — inspect mandatory categories and bot allowlist.", "write_mode": null}, {"action": "projects.put_notify_policy", "ai_tips": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1", "core.messaging.channel_plane.gen1"], "id": "projects.put_notify_policy", "mutation_risk": "low", "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "source": "overlay", "title": "Projects Put Notify Policy", "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "kind": "mcp_domain", "mutation_kind": "path", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"policy": {"description": "object", "type": "any"}, "project_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_notify_policy", "generation.diff_vs_prod", "generation.promote"], "required_cap": "project_admin", "safe_action": "projects_put_notify_policy", "summary": "Merge patch into project.data.notify_policy. Paid tenants with auto_generation_mode require env_uuid (sandbox anchor).", "title": "Projects Put Notify Policy", "when_to_use": "Tenant notify policy edits in safe generation cycle → diff → gates → promote.", "write_mode": null}, {"action": "projects.update_project", "anti_pattern": "Putting bot_spec.commands or knowledge markdown into data.", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_project", "mutation_risk": "low", "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "source": "overlay", "title": "Projects Update Project", "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"id": {"description": "int - Project ID", "type": "any"}, "name": {"description": "string - Updated project name", "type": "any"}, "updated_at": {"description": "string - Update timestamp", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project", "projects.create_project", "projects.patch_data"], "required_cap": "project_admin", "safe_action": "projects_update_project", "summary": "Update an existing project.", "title": "Projects Update Project", "when_to_use": "Update project name/description/is_active. Nested JSON leaves → projects.patch_data.", "write_mode": null}, {"action": "projects.delete_project", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.delete_project", "mutation_risk": "high", "related_tools": ["projects.get_project", "projects.create_project"], "source": "overlay", "title": "Projects Delete Project", "when_to_use": "Irreversible workspace delete — confirm id twice."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Irreversible workspace delete — confirm id twice.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool - Whether project was deleted", "type": "any"}, "project_id": {"description": "int - Deleted project ID", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project", "projects.create_project"], "required_cap": "project_admin", "safe_action": "projects_delete_project", "summary": "Delete a project (PSDP).", "title": "Projects Delete Project", "when_to_use": "Irreversible workspace delete — confirm id twice.", "write_mode": null}, {"action": "projects.get_deletion_inventory", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_deletion_inventory", "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "source": "overlay", "title": "Projects Get Deletion Inventory", "when_to_use": "Before deleting a project — check blockers and obtain execution token"}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Before deleting a project — check blockers and obtain execution token", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"execution_token": {"description": "string", "type": "any"}, "inventory": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.delete_project", "projects.schedule_deletion"], "required_cap": "mcp_read", "safe_action": "projects_get_deletion_inventory", "summary": "Pre-delete inventory: blockers, warnings, and execution_token for safe delete.", "title": "Projects Get Deletion Inventory", "when_to_use": "Before deleting a project — check blockers and obtain execution token", "write_mode": null}, {"action": "projects.schedule_deletion", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.schedule_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "source": "overlay", "title": "Projects Schedule Deletion", "when_to_use": "Schedule project deletion after inventory + execution token."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Schedule project deletion after inventory + execution token.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_deletion_inventory", "projects.execute_deletion"], "required_cap": "project_admin", "safe_action": "projects_schedule_deletion", "summary": "Schedule project deletion after inventory + execution token.", "title": "Projects Schedule Deletion", "when_to_use": "Schedule project deletion after inventory + execution token.", "write_mode": null}, {"action": "projects.execute_deletion", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.execute_deletion", "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "source": "overlay", "title": "Projects Execute Deletion", "when_to_use": "Execute scheduled or immediate deletion with execution token."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Execute scheduled or immediate deletion with execution token.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_deletion_inventory", "projects.schedule_deletion"], "required_cap": "project_admin", "safe_action": "projects_execute_deletion", "summary": "Execute scheduled or immediate deletion with execution token.", "title": "Projects Execute Deletion", "when_to_use": "Execute scheduled or immediate deletion with execution token.", "write_mode": null}, {"action": "projects.get_stats", "aliases": ["analytics.get", "projects.get_activity"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_stats", "source": "overlay", "title": "Projects Get Stats", "when_to_use": "Usage counters for billing or ops dashboards."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Usage counters for billing or ops dashboards.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"api_calls": {"description": "int - Number of API calls", "type": "any"}, "project_id": {"description": "int - Project ID", "type": "any"}, "storage_mb": {"description": "float - Storage used in MB", "type": "any"}, "users_count": {"description": "int - Number of users", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "projects_get_stats", "summary": "Get project statistics.", "title": "Projects Get Stats", "when_to_use": "Usage counters for billing or ops dashboards.", "write_mode": null}, {"action": "projects.get_users", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.get_users", "related_tools": ["projects.get_project"], "source": "overlay", "title": "Projects Get Users", "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Number of users", "type": "any"}, "users": {"description": "array - Array of user objects", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project"], "required_cap": "mcp_read", "safe_action": "projects_get_users", "summary": "Get list of users in a project.", "title": "Projects Get Users", "tool_chains": ["apply_custom_buff_to_user", "rbac_manage_members"], "when_to_use": "Membership source of truth. If auth.get_profile mutation_allowed is true, do not call auth.switch_project. projects.get_projects is not membership.", "write_mode": null}, {"action": "projects.add_user", "aliases": ["projects.attach_to_user"], "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.add_user", "source": "overlay", "title": "Projects Add User", "when_to_use": "Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users.lookup."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"permissions": {}, "project_id": 123, "role": "member", "user_id": 123}, "genetic_tags": ["core.projects.hub.gen1"], "inputSchema": {"properties": {"permissions": {"description": "Optional permissions", "type": "object"}, "project_id": {"description": "Project ID", "type": "integer"}, "role": {"default": "member", "description": "Role (e.g. member, admin)", "type": "string"}, "user_id": {"description": "User ID to add to project", "type": "integer"}}, "required": ["project_id", "user_id"], "type": "object"}, "instruction_hint": "Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for …", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}, "user": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "project_admin", "rollback": ["projects.remove_user"], "safe_action": "projects_add_user", "summary": "Add a user to a project (requires manage_users or owner on that project).", "title": "Projects Add User", "verification": ["projects.get_users", "rbac.check_permission"], "verify": [{"action": "projects.get_users", "predicate": "named resource is visible"}, {"action": "rbac.check_permission", "predicate": "named resource is visible"}], "when_to_use": "Attach a user by user_id. Ecosystem operators use context.project_id=1 and params.project_id for the tenant. Resolve id via social.users.lookup.", "write_mode": null}, {"action": "projects.update_user_role", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.update_user_role", "mutation_risk": "low", "source": "overlay", "title": "Projects Update User Role", "when_to_use": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this tool)."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "access_control", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this t…", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "project_admin", "safe_action": "projects_update_user_role", "summary": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this tool).", "title": "Projects Update User Role", "when_to_use": "Update a user's role in a project (requires manage_users or owner; cannot assign owner via this tool).", "write_mode": null}, {"action": "projects.remove_user", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.remove_user", "mutation_risk": "high", "source": "overlay", "title": "Projects Remove User", "when_to_use": "Remove a user from a project (requires manage_users or owner on that project)."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Remove a user from a project (requires manage_users or owner on that project).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "success": {"description": "bool", "type": "any"}, "user_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "project_admin", "safe_action": "projects_remove_user", "summary": "Remove a user from a project (requires manage_users or owner on that project).", "title": "Projects Remove User", "when_to_use": "Remove a user from a project (requires manage_users or owner on that project).", "write_mode": null}, {"action": "projects.orchestrator.get", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.get", "source": "overlay", "title": "Projects Orchestrator Get", "when_to_use": "Get project_orchestrator 8DNA leaf config."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Get project_orchestrator 8DNA leaf config.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"orchestrator": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "projects_orchestrator_get", "summary": "Get project_orchestrator 8DNA leaf config.", "title": "Projects Orchestrator Get", "when_to_use": "Get project_orchestrator 8DNA leaf config.", "write_mode": null}, {"action": "projects.orchestrator.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.patch", "mutation_risk": "low", "source": "overlay", "title": "Projects Orchestrator Patch", "when_to_use": "Patch project_orchestrator leaf (dna_set_project_data_path)."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Patch project_orchestrator leaf (dna_set_project_data_path).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"orchestrator": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "project_admin", "safe_action": "projects_orchestrator_patch", "summary": "Patch project_orchestrator leaf (dna_set_project_data_path).", "title": "Projects Orchestrator Patch", "when_to_use": "Patch project_orchestrator leaf (dna_set_project_data_path).", "write_mode": null}, {"action": "projects.orchestrator.export_pack", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.export_pack", "source": "overlay", "title": "Projects Orchestrator Export Pack", "when_to_use": "Export portable ProjectOrchestratorPack JSON."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Export portable ProjectOrchestratorPack JSON.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"pack": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "mcp_read", "safe_action": "projects_orchestrator_export_pack", "summary": "Export portable ProjectOrchestratorPack JSON.", "title": "Projects Orchestrator Export Pack", "when_to_use": "Export portable ProjectOrchestratorPack JSON.", "write_mode": null}, {"action": "projects.orchestrator.import_from_asset", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.orchestrator.import_from_asset", "mutation_risk": "low", "source": "overlay", "title": "Projects Orchestrator Import From Asset", "when_to_use": "Fulfill orchestrator pack from commerce asset or raw pack dict."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Fulfill orchestrator pack from commerce asset or raw pack dict.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"orchestrator": {"description": "object", "type": "any"}, "primary_agent_uuid": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "required_cap": "project_admin", "safe_action": "projects_orchestrator_import_from_asset", "summary": "Fulfill orchestrator pack from commerce asset or raw pack dict.", "title": "Projects Orchestrator Import From Asset", "when_to_use": "Fulfill orchestrator pack from commerce asset or raw pack dict.", "write_mode": null}, {"action": "projects.limits.get", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.limits.get", "related_tools": ["buffs.get_effective_limits", "bots.list"], "source": "overlay", "title": "Projects Limits Get", "when_to_use": "Before fleet/commerce mutations — understand tier gates."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Before fleet/commerce mutations — understand tier gates.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"limits": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["buffs.get_effective_limits", "bots.list"], "required_cap": "mcp_read", "safe_action": "projects_limits_get", "summary": "Project effective limits — buffs + bot create gate metadata.", "title": "Projects Limits Get", "when_to_use": "Before fleet/commerce mutations — understand tier gates.", "write_mode": null}, {"action": "projects.readiness.get", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.readiness.get", "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "source": "overlay", "title": "Projects Readiness Get", "when_to_use": "Before onboarding flows — without full projects.get payload."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Before onboarding flows — without full projects.get payload.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"readiness": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_project", "generation.supply_status", "knowledge.health"], "required_cap": "mcp_read", "safe_action": "projects_readiness_get", "summary": "Lightweight project readiness — supply + knowledge health skim.", "title": "Projects Readiness Get", "when_to_use": "Before onboarding flows — without full projects.get payload.", "write_mode": null}, {"action": "projects.cancel_deletion", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.cancel_deletion", "mutation_risk": "low", "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "source": "overlay", "title": "Projects Cancel Deletion", "when_to_use": "Abort grace-period deletion."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Abort grace-period deletion.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.schedule_deletion", "projects.deletion_status", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "safe_action": "projects_cancel_deletion", "summary": "Cancel a scheduled project deletion (PSDP cancel twin).", "title": "Projects Cancel Deletion", "when_to_use": "Abort grace-period deletion.", "write_mode": null}, {"action": "projects.deletion_status", "capability_descriptor": {"complexity": "simple", "domain": "projects", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.deletion_status", "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "source": "overlay", "title": "Projects Deletion Status", "when_to_use": "Poll scheduled deletion without SPA."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Poll scheduled deletion without SPA.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"status": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.cancel_deletion", "projects.get_deletion_inventory"], "required_cap": "mcp_read", "safe_action": "projects_deletion_status", "summary": "Read PSDP deletion status for a project.", "title": "Projects Deletion Status", "when_to_use": "Poll scheduled deletion without SPA.", "write_mode": null}, {"action": "projects.archive", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.safe_deletion.gen1"], "id": "projects.archive", "mutation_risk": "high", "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "source": "overlay", "title": "Projects Archive", "when_to_use": "Retire without hard delete."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Retire without hard delete.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_deletion_inventory", "projects.delete_project"], "required_cap": "project_admin", "safe_action": "projects_archive", "summary": "Archive a project (ledger-safe archive twin of POST /archive).", "title": "Projects Archive", "when_to_use": "Retire without hard delete.", "write_mode": null}, {"action": "projects.catalog_summaries", "capability_descriptor": {"complexity": "simple", "domain": "projects", "genetic_tags": ["core.projects.catalog_summaries.gen1"], "id": "projects.catalog_summaries", "related_tools": ["projects.get_projects", "projects.readiness.get"], "source": "overlay", "title": "Projects Catalog Summaries", "when_to_use": "Hub tiles / agent catalog KPIs — no N+1 get."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Hub tiles / agent catalog KPIs — no N+1 get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"summaries": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_projects", "projects.readiness.get"], "required_cap": "mcp_read", "safe_action": "projects_catalog_summaries", "summary": "Batch light KPI rows for project catalog tiles (ids max 40).", "title": "Projects Catalog Summaries", "when_to_use": "Hub tiles / agent catalog KPIs — no N+1 get.", "write_mode": null}, {"action": "projects.import_by_key", "capability_descriptor": {"complexity": "advanced", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.import_by_key", "mutation_risk": "high", "related_tools": ["projects.get_projects"], "source": "overlay", "title": "Projects Import By Key", "when_to_use": "Operator import; prefer SPA for humans."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Operator import; prefer SPA for humans.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"imported": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_projects"], "required_cap": "project_admin", "safe_action": "projects_import_by_key", "summary": "Import accessible projects using a user API key (operator-sensitive).", "title": "Projects Import By Key", "when_to_use": "Operator import; prefer SPA for humans.", "write_mode": null}, {"action": "projects.membership.repair", "capability_descriptor": {"complexity": "intermediate", "domain": "projects", "genetic_tags": ["core.projects.member_ops.gen1"], "id": "projects.membership.repair", "mutation_risk": "low", "related_tools": ["projects.get_users", "projects.add_user"], "source": "overlay", "title": "Projects Membership Repair", "when_to_use": "List lag after invite."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "List lag after invite.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.get_users", "projects.add_user"], "required_cap": "project_admin", "safe_action": "projects_membership_repair", "summary": "Repair project membership / accessible_ids lag for the caller.", "title": "Projects Membership Repair", "when_to_use": "List lag after invite.", "write_mode": null}, {"action": "projects.presets.list", "capability_descriptor": {"complexity": "simple", "domain": "projects", "genetic_tags": ["core.projects.hub.gen1"], "id": "projects.presets.list", "related_tools": ["projects.create_project"], "source": "overlay", "title": "Projects Presets List", "when_to_use": "Before create_project template gallery."}, "domain_title": "Projects MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.projects.hub.gen1"], "instruction_hint": "Before create_project template gallery.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "bootstrap", "organ_id": "mcp.projects", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"presets": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.projects.hub.gen1", "related_prompts": ["agentstack_session_setup", "agentstack_closed_loop_autonomy", "agentstack_project_setup", "agentstack_project_member_ops", "agentstack_safe_project_cycle", "agentstack_read_bootstrap"], "related_tools": ["projects.create_project"], "required_cap": "mcp_read", "safe_action": "projects_presets_list", "summary": "List project create presets / templates.", "title": "Projects Presets List", "when_to_use": "Before create_project template gallery.", "write_mode": null}], "rag": [{"action": "rag.health", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.health", "source": "overlay", "title": "Rag Health", "when_to_use": "RAG persistence mode and collection stats for the current project scope."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "RAG persistence mode and collection stats for the current project scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collections_count": {"description": "Ready collections visible to principal", "type": "any"}, "collections_creating": {"description": "Collections in creating state", "type": "any"}, "collections_deleting": {"description": "Collections in deleting state", "type": "any"}, "ingest_queue": {"description": "Terminal job counts by status", "type": "any"}, "persistence_mode": {"description": "cell_sqlite | dual_read | backup", "type": "any"}, "quota_limit": {"description": "Tier collection cap", "type": "any"}, "quota_used": {"description": "Authoritative quota numerator", "type": "any"}, "total_chunks": {"description": "Sum of chunk_count across collections", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_health", "summary": "RAG persistence mode and collection stats for the current project scope.", "title": "Rag Health", "when_to_use": "RAG persistence mode and collection stats for the current project scope.", "write_mode": null}, {"action": "rag.ingest_job_status", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_status", "source": "overlay", "title": "Rag Ingest Job Status", "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest)."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Poll async batch ingest job status (work_queue rag_ingest).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collection_id": {"description": "Target collection when available", "type": "any"}, "done": {"description": "True when job finished or failed", "type": "any"}, "status": {"description": "pending | reserved | done | failed | deduped", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_ingest_job_status", "summary": "Poll async batch ingest job status (work_queue rag_ingest).", "title": "Rag Ingest Job Status", "when_to_use": "Poll async batch ingest job status (work_queue rag_ingest).", "write_mode": null}, {"action": "rag.ingest_job_cancel", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_job_cancel", "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "source": "live", "title": "Rag Ingest Job Cancel", "when_to_use": "Abort a long-running ingest before it completes."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Abort a long-running ingest before it completes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "Mutation receipt — cancel accepted but worker may still finish", "type": "any"}, "cancel_requested": {"description": "True when cancel is queued for an in-flight worker", "type": "any"}, "changed": {"description": "False when cancel was idempotent on terminal job", "type": "any"}, "committed": {"description": "True when terminal status is visible", "type": "any"}, "done": {"description": "True when job reached a terminal state", "type": "any"}, "job_id": {"description": "Work queue job id", "type": "any"}, "status": {"description": "pending | reserved | done | failed | partial | cancelled | deduped", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.ingest_job_status", "rag.document_add_batch"], "required_cap": "rag.read", "safe_action": "rag_ingest_job_cancel", "summary": "Cancel a queued or in-flight rag_ingest job (idempotent).", "title": "Rag Ingest Job Cancel", "when_to_use": "Abort a long-running ingest before it completes.", "write_mode": null}, {"action": "rag.collection_create", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_create", "mutation_risk": "low", "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "source": "overlay", "title": "Rag Collection Create", "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"description": "Product documentation and FAQ", "embedding_provider": "openai", "home_project_id": 123, "idempotency_key": "example_string", "name": "product-docs"}, "genetic_tags": ["core.mcp.rag.gen1"], "inputSchema": {"examples": [{"description": "Create a support knowledge base", "params": {"description": "Customer support articles", "name": "support-kb"}}], "properties": {"description": {"default": "", "description": "Optional description of what this collection contains", "example": "Product documentation and FAQ", "type": "string"}, "embedding_provider": {"default": "openai", "description": "Embedding provider for vector generation", "enum": ["openai", "gemini"], "type": "string"}, "home_project_id": {"description": "Optional project scope override (home project). Must be accessible to the authenticated user.", "type": "integer"}, "idempotency_key": {"description": "Optional idempotency key for safe retries (mutation guard)", "type": "string"}, "name": {"description": "Collection name (e.g. 'product-docs', 'support-kb')", "example": "product-docs", "type": "string"}}, "required": ["name"], "type": "object"}, "instruction_hint": "Before adding documents. Create one collection per topic before rag.document_add.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "True when mutation is queued but not yet committed", "type": "any"}, "changed": {"description": "False when idempotent replay (delete already in progress)", "type": "any"}, "collection": {"description": "Masked collection object when ready", "type": "any"}, "collection_id": {"description": "UUID of the collection", "type": "any"}, "committed": {"description": "True when resource reached settled read model", "type": "any"}, "error_code": {"description": "Machine-readable error when success=false", "type": "any"}, "name": {"description": "Collection name", "type": "any"}, "project_id": {"description": "Owner project ID", "type": "any"}, "retry_after_ms": {"description": "Suggested poll delay in milliseconds", "type": "any"}, "retryable": {"description": "Whether client should poll verification_action", "type": "any"}, "state": {"description": "Lifecycle: creating | ready | deleting | deleted | failed", "type": "any"}, "success": {"description": "Alias of committed (v13 mutation receipt)", "type": "any"}, "verification_action": {"description": "MCP action to confirm state (rag.collection_get)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.document_add", "rag.search", "rag.collection_list"], "required_cap": "rag.write", "rollback": ["rag.collection_delete"], "safe_action": "rag_collection_create", "summary": "Create a new RAG knowledge base collection for the current project.", "title": "Rag Collection Create", "tool_chains": ["project_bootstrap", "rag_knowledge_base", "rag_knowledge_base"], "verification": ["rag.collection_get"], "verify": [{"action": "rag.collection_get", "predicate": "named resource is visible"}], "when_to_use": "Before adding documents. Create one collection per topic before rag.document_add.", "write_mode": null}, {"action": "rag.collection_get", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_get", "related_tools": ["rag.collection_list", "rag.collection_create"], "source": "live", "title": "Rag Collection Get", "when_to_use": "Verify collection exists after rag.collection_create before ingest."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Verify collection exists after rag.collection_create before ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collection": {"description": "Masked collection object when readable", "type": "any"}, "collection_id": {"description": "UUID", "type": "any"}, "error_code": {"description": "not_found | not_ready | permission_denied", "type": "any"}, "retryable": {"description": "True while creating or deleting", "type": "any"}, "state": {"description": "Lifecycle: creating | ready | deleting", "type": "any"}, "success": {"description": "True when collection is readable", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.collection_create"], "required_cap": "rag.read", "safe_action": "rag_collection_get", "summary": "Get one RAG collection by id (verify-after-write read model).", "title": "Rag Collection Get", "when_to_use": "Verify collection exists after rag.collection_create before ingest.", "write_mode": null}, {"action": "rag.collection_list", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_list", "related_tools": ["rag.collection_create", "rag.search"], "source": "overlay", "title": "Rag Collection List", "when_to_use": "Discover collections before search or ingest."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Discover collections before search or ingest.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collections": {"description": "Array of collection objects", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_create", "rag.search"], "required_cap": "rag.read", "safe_action": "rag_collection_list", "summary": "List all RAG collections for the current project.", "title": "Rag Collection List", "tool_chains": ["rag_knowledge_base"], "when_to_use": "Discover collections before search or ingest.", "write_mode": null}, {"action": "rag.collection_delete", "anti_pattern": "Do not delete collections with important data unless explicitly requested", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.collection_delete", "mutation_risk": "low", "source": "overlay", "title": "Rag Collection Delete", "when_to_use": "Drop collection and all docs — irreversible."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "example_params": {"collection_id": "example_string", "home_project_id": 123}, "genetic_tags": ["core.mcp.rag.gen1"], "inputSchema": {"properties": {"collection_id": {"description": "UUID of the collection to delete", "format": "uuid", "type": "string"}, "home_project_id": {"description": "Optional project scope override (home project). Must be accessible to the authenticated user.", "type": "integer"}}, "required": ["collection_id"], "type": "object"}, "instruction_hint": "Drop collection and all docs — irreversible.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"accepted": {"description": "True when mutation is queued but not yet committed", "type": "any"}, "changed": {"description": "False when idempotent replay (delete already in progress)", "type": "any"}, "collection_id": {"description": "UUID of the collection", "type": "any"}, "committed": {"description": "True when resource reached settled read model", "type": "any"}, "deleted": {"description": "True when collection is gone or delete accepted", "type": "any"}, "error_code": {"description": "Machine-readable error when success=false", "type": "any"}, "retry_after_ms": {"description": "Suggested poll delay in milliseconds", "type": "any"}, "retryable": {"description": "Whether client should poll verification_action", "type": "any"}, "state": {"description": "Lifecycle: creating | ready | deleting | deleted | failed", "type": "any"}, "success": {"description": "Alias of committed (v13 mutation receipt)", "type": "any"}, "verification_action": {"description": "MCP action to confirm state (rag.collection_get)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "rollback": [], "safe_action": "rag_collection_delete", "summary": "Delete a RAG collection and all its documents. This is irreversible.", "title": "Rag Collection Delete", "verification": ["rag.collection_list", "knowledge.health"], "verify": [{"action": "rag.collection_list", "predicate": "named resource is visible"}, {"action": "knowledge.health", "predicate": "named resource is visible"}], "when_to_use": "Drop collection and all docs — irreversible.", "write_mode": null}, {"action": "rag.document_add", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add", "mutation_risk": "low", "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "source": "overlay", "title": "Rag Document Add", "when_to_use": "Index text into a collection — prefer over raw storage for semantic search."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Index text into a collection — prefer over raw storage for semantic search.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks_added": {"description": "Number of new chunks indexed", "type": "any"}, "chunks_skipped": {"description": "Unchanged chunks skipped", "type": "any"}, "source_doc_id": {"description": "Source document identifier used", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.search", "rag.collection_list", "rag.document_delete"], "required_cap": "rag.write", "safe_action": "rag_document_add", "summary": "Add a text document to a RAG collection.", "title": "Rag Document Add", "tool_chains": ["rag_knowledge_base"], "when_to_use": "Index text into a collection — prefer over raw storage for semantic search.", "write_mode": null}, {"action": "rag.document_add_batch", "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_add_batch", "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "source": "overlay", "title": "Rag Document Add Batch", "when_to_use": "Bulk mentor KB ingest after collection_create."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Bulk mentor KB ingest after collection_create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"errors": {"description": "Per-index failure details when ingest partially fails", "type": "any"}, "ingested": {"description": "Count of successfully indexed documents", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_get", "rag.ingest_job_status", "rag.search", "knowledge.kb.ingest"], "required_cap": "rag.read", "safe_action": "rag_document_add_batch", "summary": "Add multiple documents to a RAG collection in one call.", "title": "Rag Document Add Batch", "when_to_use": "Bulk mentor KB ingest after collection_create.", "write_mode": null}, {"action": "rag.document_list", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_list", "source": "overlay", "title": "Rag Document List", "when_to_use": "List document chunks stored in a collection."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "List document chunks stored in a collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks": {"description": "Array of chunk objects with text and metadata", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_document_list", "summary": "List document chunks stored in a collection.", "title": "Rag Document List", "when_to_use": "List document chunks stored in a collection.", "write_mode": null}, {"action": "rag.document_delete", "aliases": ["knowledge.document.delete"], "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.document_delete", "mutation_risk": "low", "source": "overlay", "title": "Rag Document Delete", "when_to_use": "Remove one document from a collection."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Remove one document from a collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks_deleted": {"description": "Number of chunks removed", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.write", "safe_action": "rag_document_delete", "summary": "Remove a document (all its chunks) from a collection by source_doc_id.", "title": "Rag Document Delete", "when_to_use": "Remove one document from a collection.", "write_mode": null}, {"action": "rag.ingest_from_storage", "capability_descriptor": {"complexity": "intermediate", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.ingest_from_storage", "source": "overlay", "title": "Rag Ingest From Storage", "when_to_use": "Ingest text extracted from a Storage file into a RAG collection."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Ingest text extracted from a Storage file into a RAG collection.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks_added": {"description": "Number of chunks indexed", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_ingest_from_storage", "summary": "Ingest text extracted from a Storage file into a RAG collection.", "title": "Rag Ingest From Storage", "when_to_use": "Ingest text extracted from a Storage file into a RAG collection.", "write_mode": null}, {"action": "rag.export", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.export", "source": "overlay", "title": "Rag Export", "when_to_use": "Export accessible collection chunks (access-tier filtered) as JSON documents."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Export accessible collection chunks (access-tier filtered) as JSON documents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"documents": {"description": "Array of {doc_id, text, metadata}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_export", "summary": "Export accessible collection chunks (access-tier filtered) as JSON documents.", "title": "Rag Export", "when_to_use": "Export accessible collection chunks (access-tier filtered) as JSON documents.", "write_mode": null}, {"action": "rag.warm", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.warm", "source": "overlay", "title": "Rag Warm", "when_to_use": "Pre-load collection vectors into process L1 before search traffic."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Pre-load collection vectors into process L1 before search traffic.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"chunks_loaded": {"description": "Chunks added to in-memory store", "type": "any"}, "store_size": {"description": "Total chunks in L1", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_warm", "summary": "Pre-load collection vectors into process L1 before search traffic.", "title": "Rag Warm", "when_to_use": "Pre-load collection vectors into process L1 before search traffic.", "write_mode": null}, {"action": "rag.search", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.search", "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "source": "handler", "title": "Rag Search", "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "inputSchema": {"examples": [{"description": "Search project knowledge_kb by stable id", "params": {"collection_id": "knowledge_kb", "hybrid": true, "query": "how do I get a refund?", "top_k": 3}}], "properties": {"collection_id": {"description": "Target collection: stable id (knowledge_kb, content_registry, project_design, project_code, project_architecture) or engine collection key. Alias: collection. When options.goal already stamped a lane, omit collection_id and the server fills the lane's first collection. Prefer knowledge.playground for mentor fidelity.", "example": "knowledge_kb", "type": "string"}, "filters": {"description": "Metadata filters: {key: value}. Only return chunks matching all filters.", "example": {"type": "support"}, "type": "object"}, "home_project_id": {"description": "Optional project scope override (home project). Must be accessible to the authenticated user.", "type": "integer"}, "hybrid": {"default": true, "description": "Use hybrid search (BM25 + dense). Recommended for best recall.", "type": "boolean"}, "mmr": {"default": false, "description": "Use MMR to select diverse results. Recommended when top_k > 3.", "type": "boolean"}, "query": {"description": "Natural language query. Alias: q.", "example": "how do I reset my password?", "type": "string"}, "top_k": {"default": 5, "description": "Number of results to return (1–20)", "type": "integer"}}, "required": ["collection_id", "query"], "type": "object"}, "instruction_hint": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"collection_id": {"description": "Collection that was searched", "type": "any"}, "query": {"description": "The original query", "type": "any"}, "results": {"description": "Array of {doc_id, text, score, metadata, source_doc_id, chunk_index}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.collection_list", "rag.document_add", "rag.memory_search"], "required_cap": "rag.read", "safe_action": "rag_search", "summary": "Semantic search over a RAG collection.", "title": "Rag Search", "tool_chains": ["rag_knowledge_base"], "when_to_use": "Hybrid semantic + BM25 search — ground agent answers in project docs.", "write_mode": null}, {"action": "rag.memory_add", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_add", "mutation_risk": "low", "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "source": "overlay", "title": "Rag Memory Add", "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant)."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Store conversation turn in scoped agent memory (TurboQuant).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"session_id": {"description": "Session ID", "type": "any"}, "turn_index": {"description": "Index of the stored turn", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_search", "rag.memory_get", "rag.search"], "required_cap": "rag.write", "safe_action": "rag_memory_add", "summary": "Store a conversation turn in AI memory.", "title": "Rag Memory Add", "tool_chains": ["rag_knowledge_base"], "when_to_use": "Store conversation turn in scoped agent memory (TurboQuant).", "write_mode": null}, {"action": "rag.memory_get", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_get", "related_tools": ["rag.memory_add", "rag.memory_search"], "source": "overlay", "title": "Rag Memory Get", "when_to_use": "Recent memory turns for the active session."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Recent memory turns for the active session.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"turns": {"description": "Array of {role, content, index}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "related_tools": ["rag.memory_add", "rag.memory_search"], "required_cap": "rag.read", "safe_action": "rag_memory_get", "summary": "Get the most recent conversation turns from memory (chronological order).", "title": "Rag Memory Get", "when_to_use": "Recent memory turns for the active session.", "write_mode": null}, {"action": "rag.memory_search", "capability_descriptor": {"complexity": "simple", "domain": "rag", "genetic_tags": ["core.mcp.rag.gen1"], "id": "rag.memory_search", "source": "overlay", "title": "Rag Memory Search", "when_to_use": "Semantic recall over past turns — combine with rag.search for KB."}, "domain_title": "Rag MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rag.gen1"], "instruction_hint": "Semantic recall over past turns — combine with rag.search for KB.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rag", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"results": {"description": "Array of {role, content, score, index}", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rag.gen1", "related_prompts": ["agentstack_context_lanes", "agentstack_rag_memory_orchestrator"], "required_cap": "rag.read", "safe_action": "rag_memory_search", "summary": "Semantically search past conversation turns.", "title": "Rag Memory Search", "when_to_use": "Semantic recall over past turns — combine with rag.search for KB.", "write_mode": null}], "rbac": [{"action": "rbac.get_roles", "aliases": ["rbac.list_permissions"], "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.get_roles", "source": "overlay", "title": "Rbac Get Roles", "when_to_use": "List project roles before assign_role or revoke_role."}, "domain_title": "Rbac MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "List project roles before assign_role or revoke_role.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"custom_roles": {"description": "int", "type": "any"}, "roles": {"description": "array of role objects", "type": "any"}, "system_roles": {"description": "int", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rbac.gen1", "required_cap": "mcp_read", "safe_action": "rbac_get_roles", "summary": "Get list of roles for a project (system + custom). Returns id, name, permissions_bitmap, permissions, is_system.", "title": "Rbac Get Roles", "tool_chains": ["rbac_manage_members"], "when_to_use": "List project roles before assign_role or revoke_role.", "write_mode": null}, {"action": "rbac.assign_role", "aliases": ["auth.assign_role"], "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.assign_role", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "source": "overlay", "title": "Rbac Assign Role", "when_to_use": "Grant role to member — cannot assign owner via this tool."}, "domain_title": "Rbac MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "access_control", "write_mode": false}, "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Grant role to member — cannot assign owner via this tool.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"assignment": {"description": "object", "type": "any"}, "message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rbac.gen1", "related_tools": ["rbac.get_roles", "rbac.revoke_role", "projects.get_users"], "required_cap": "mcp_read", "safe_action": "rbac_assign_role", "summary": "Assign a role to a user in a project. Requires manage_users or owner. Cannot assign owner via this tool.", "title": "Rbac Assign Role", "tool_chains": ["crud_with_logic", "content_access_control", "multi_tenant_onboarding"], "when_to_use": "Grant role to member — cannot assign owner via this tool.", "write_mode": null}, {"action": "rbac.revoke_role", "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.revoke_role", "mutation_risk": "high", "source": "overlay", "title": "Rbac Revoke Role", "when_to_use": "Revoke role; user falls back to viewer."}, "domain_title": "Rbac MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Revoke role; user falls back to viewer.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rbac.gen1", "required_cap": "project_admin", "safe_action": "rbac_revoke_role", "summary": "Revoke a role from a user in a project. User will get default viewer role. Requires manage_users or owner. Cannot revoke owner.", "title": "Rbac Revoke Role", "when_to_use": "Revoke role; user falls back to viewer.", "write_mode": null}, {"action": "rbac.check_permission", "capability_descriptor": {"complexity": "intermediate", "domain": "rbac", "genetic_tags": ["core.mcp.rbac.gen1"], "id": "rbac.check_permission", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "source": "overlay", "title": "Rbac Check Permission", "when_to_use": "Gate UI or server branch — prefer over scattering role checks."}, "domain_title": "Rbac MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.rbac.gen1"], "instruction_hint": "Gate UI or server branch — prefer over scattering role checks.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.rbac", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"granted": {"description": "bool", "type": "any"}, "permission": {"description": "string", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "user_id": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.rbac.gen1", "related_tools": ["rbac.get_roles", "rbac.assign_role", "data_access.set_policy"], "required_cap": "mcp_read", "safe_action": "rbac_check_permission", "summary": "Check if a user has a permission in a project. If user_id is omitted, checks current user.", "title": "Rbac Check Permission", "when_to_use": "Gate UI or server branch — prefer over scattering role checks.", "write_mode": null}], "safety": [{"action": "safety.evaluate", "capability_descriptor": {"complexity": "intermediate", "domain": "knowledge", "genetic_tags": ["core.mcp.safety.gen1"], "id": "safety.evaluate", "source": "overlay", "title": "Safety Evaluate", "when_to_use": "MCP tool safety.evaluate"}, "domain_title": "Safety MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "evaluate", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.safety.gen1"], "instruction_hint": "MCP tool safety.evaluate", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.safety", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"data": {"description": "object", "type": "any"}, "error": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.safety.gen1", "related_prompts": ["agentstack_knowledge_safety_tune"], "required_cap": "bots_run", "safe_action": "safety_evaluate", "summary": "MCP tool safety.evaluate", "title": "Safety Evaluate", "when_to_use": "MCP tool safety.evaluate", "write_mode": null}], "scheduler": [{"action": "scheduler.create_task", "aliases": ["scheduler.schedule_task"], "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.create_task", "mutation_risk": "low", "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "source": "overlay", "title": "Scheduler Create Task", "when_to_use": "Cron/delayed job — not Celery/BullMQ for basic cases."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "example_params": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "execute_at": "2026-09-28T10:00:00Z", "name": "Daily Backup", "payload": {}, "timezone": "UTC"}, "genetic_tags": ["core.mcp.scheduler.gen1"], "inputSchema": {"examples": [{"description": "Create a task that runs daily at midnight", "name": "Create daily task", "request": {"command": "backup_database", "cron": "0 0 * * *", "enabled": true, "name": "Daily Backup"}, "response": {"data": {"command": "backup_database", "created_at": "2025-01-20T10:00:00Z", "cron": "0 0 * * *", "enabled": true, "name": "Daily Backup", "project_id": 123, "task_id": "550e8400-e29b-41d4-a716-446655440000", "user_id": 1}, "success": true}}, {"description": "Create a task that runs every Monday at 9 AM", "name": "Create weekly task", "request": {"command": "generate_weekly_report", "cron": "0 9 * * 1", "enabled": true, "name": "Weekly Report"}, "response": {"data": {"command": "generate_weekly_report", "created_at": "2025-01-20T10:00:00Z", "cron": "0 9 * * 1", "enabled": true, "name": "Weekly Report", "project_id": 123, "task_id": "550e8400-e29b-41d4-a716-446655440001", "user_id": 1}, "success": true}}], "properties": {"command": {"description": "Registered scheduler runner. Unknown names are saved with runnable=false. Not an arbitrary custom function.", "example": "backup_database", "type": "string"}, "cron": {"description": "Cron expression defining schedule. Format: 'minute hour day month weekday'. Examples: '0 0 * * *' (daily at midnight), '0 9 * * 1' (every Monday at 9 AM), '0 * * * *' (every hour), '*/15 * * * *' (every 15 minutes)", "example": "0 0 * * *", "type": "string"}, "enabled": {"default": true, "description": "Whether task is enabled and will execute. Set to false to temporarily disable without deleting", "example": true, "type": "boolean"}, "execute_at": {"description": "ISO-8601 timestamp for a single run. Omit it for a recurring cron task.", "example": "2026-09-28T10:00:00Z", "format": "date-time", "type": "string"}, "name": {"description": "Task name for identification. Should be descriptive (e.g., 'Daily Backup', 'Weekly Report', 'Hourly Sync')", "example": "Daily Backup", "type": "string"}, "payload": {"additionalProperties": true, "description": "JSON handed to the runner. Alias task_data is accepted when payload is omitted.", "type": "object"}, "timezone": {"default": "UTC", "description": "IANA timezone used to compute the next run. Default UTC. Does not replace cron.", "example": "UTC", "type": "string"}}, "required": ["name"], "type": "object"}, "instruction_hint": "Cron/delayed job — not Celery/BullMQ for basic cases.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"command": {"description": "string - Command to execute", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp when task was created", "type": "any"}, "cron": {"description": "string - Cron expression for the task", "type": "any"}, "enabled": {"description": "bool - Whether task is enabled", "type": "any"}, "name": {"description": "string - Task name", "type": "any"}, "project_id": {"description": "int - Project ID associated with task", "type": "any"}, "task_id": {"description": "string - Unique task identifier (UUID format). Use this ID to manage, execute, or delete the task", "type": "any"}, "user_id": {"description": "int - User ID who created the task", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.list_tasks", "scheduler.get_task", "scheduler.cancel_task"], "required_cap": "scheduler", "rollback": ["scheduler.cancel_task", "scheduler.delete_task"], "safe_action": "scheduler_create_task", "summary": "Create a new scheduled task for automated execution.", "title": "Create Scheduled Task", "tool_chains": ["scheduled_rewards", "payment_to_subscription", "project_bootstrap"], "verification": ["scheduler.list_tasks", "scheduler.get_task"], "verify": [{"action": "scheduler.list_tasks", "predicate": "named resource is visible"}, {"action": "scheduler.get_task", "predicate": "named resource is visible"}], "when_to_use": "Cron/delayed job — not Celery/BullMQ for basic cases.", "write_mode": null}, {"action": "scheduler.get_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_task", "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "source": "overlay", "title": "Scheduler Get Task", "when_to_use": "Inspect one task schedule and payload."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Inspect one task schedule and payload.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"command": {"description": "string - Command to execute", "type": "any"}, "created_at": {"description": "string - ISO 8601 timestamp when task was created", "type": "any"}, "cron": {"description": "string - Cron expression", "type": "any"}, "enabled": {"description": "bool - Whether task is enabled", "type": "any"}, "last_run_at": {"description": "string (optional) - ISO 8601 timestamp of last execution", "type": "any"}, "name": {"description": "string - Task name", "type": "any"}, "next_run_at": {"description": "string (optional) - ISO 8601 timestamp of next scheduled execution", "type": "any"}, "project_id": {"description": "int - Project ID associated with task", "type": "any"}, "status": {"description": "string - Task status: 'active', 'disabled', 'error', 'running'", "type": "any"}, "task_id": {"description": "string - Task identifier", "type": "any"}, "user_id": {"description": "int - User ID who created the task", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.list_tasks", "scheduler.create_task", "scheduler.execute_task", "scheduler.update_task"], "required_cap": "scheduler", "safe_action": "scheduler_get_task", "summary": "Get detailed information about a scheduled task by ID.", "title": "Scheduler Get Task", "when_to_use": "Inspect one task schedule and payload.", "write_mode": null}, {"action": "scheduler.update_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.update_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "source": "overlay", "title": "Scheduler Update Task", "when_to_use": "Change cron or payload on existing task."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Change cron or payload on existing task.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.cancel_task"], "required_cap": "scheduler", "safe_action": "scheduler_update_task", "summary": "Update an existing scheduler task (requires write permission).", "title": "Scheduler Update Task", "when_to_use": "Change cron or payload on existing task.", "write_mode": null}, {"action": "scheduler.list_tasks", "aliases": ["scheduler.list", "scheduler.status"], "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.list_tasks", "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "source": "overlay", "title": "Scheduler List Tasks", "when_to_use": "Audit scheduled tasks before cancel or update."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Audit scheduled tasks before cancel or update.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int - Total number of tasks found", "type": "any"}, "project_id": {"description": "int - Project ID for which tasks were retrieved", "type": "any"}, "tasks": {"description": "array - Array of task objects. Each task contains: task_id, name, cron, command, enabled, status, created_at, last_run_at, next_run_at", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_task", "scheduler.cancel_task", "scheduler.update_task"], "required_cap": "scheduler", "safe_action": "scheduler_list_tasks", "summary": "List all scheduled tasks for a project.", "title": "Scheduler List Tasks", "when_to_use": "Audit scheduled tasks before cancel or update.", "write_mode": null}, {"action": "scheduler.execute_task", "aliases": ["scheduler.run_now"], "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.execute_task", "mutation_risk": "low", "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "source": "handler", "title": "Scheduler Execute Task", "when_to_use": "Manual fire of scheduled task (ops/debug)."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": true, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "inputSchema": {"examples": [{"description": "Trigger immediate execution of a scheduled task", "name": "Execute task immediately", "request": {"task_id": "550e8400-e29b-41d4-a716-446655440000"}, "response": {"data": {"completed_at": "2025-01-20T10:00:05Z", "executed": true, "execution_id": "550e8400-e29b-41d4-a716-446655440002", "result": {"output": "Task executed successfully", "records_processed": 100}, "started_at": "2025-01-20T10:00:00Z", "status": "completed"}, "success": true}}], "properties": {"task_id": {"description": "Unique task identifier (UUID format). Obtained from scheduler.create_task response or scheduler.list_tasks", "example": "550e8400-e29b-41d4-a716-446655440000", "format": "uuid", "type": "string"}}, "required": ["task_id"], "type": "object"}, "instruction_hint": "Manual fire of scheduled task (ops/debug).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"completed_at": {"description": "string (optional) - ISO 8601 timestamp when execution completed (if finished)", "type": "any"}, "error": {"description": "string (optional) - Error message if execution failed", "type": "any"}, "executed": {"description": "bool - Whether task execution was initiated successfully", "type": "any"}, "execution_id": {"description": "string - Unique identifier for this execution instance", "type": "any"}, "result": {"description": "object - Execution result. Contains task output, status, and any errors", "type": "any"}, "started_at": {"description": "string - ISO 8601 timestamp when execution started", "type": "any"}, "status": {"description": "string - Execution status: 'running', 'completed', 'failed', 'cancelled'", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_task", "scheduler.create_task", "scheduler.list_tasks", "scheduler.get_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "safe_action": "scheduler_execute_task", "summary": "Execute a scheduled task immediately, bypassing the cron schedule.", "title": "Scheduler Execute Task", "when_to_use": "Manual fire of scheduled task (ops/debug).", "write_mode": null}, {"action": "scheduler.get_pool_tasks", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_tasks", "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "source": "overlay", "title": "Scheduler Get Pool Tasks", "when_to_use": "Scheduler pool queue — ops visibility."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Scheduler pool queue — ops visibility.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"pool_stats": {"description": "object - Pool statistics: pool_size, ready_count, upcoming_count, future_count, last_refill_time, refill_interval, window_minutes, max_pool_size", "type": "any"}, "tasks": {"description": "array - Array of task objects in the pool. Each task contains: task_id, execute_at, task_type, project_id, name, description, priority", "type": "any"}, "total": {"description": "int - Total number of tasks in pool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_pool_task_details", "scheduler.delete_pool_task", "scheduler.clear_pool_tasks", "scheduler.refresh_pool"], "required_cap": "scheduler", "safe_action": "scheduler_get_pool_tasks", "summary": "Get all tasks from the execution pool (in-memory task queue).", "title": "Scheduler Get Pool Tasks", "when_to_use": "Scheduler pool queue — ops visibility.", "write_mode": null}, {"action": "scheduler.get_pool_task_details", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_pool_task_details", "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "source": "overlay", "title": "Scheduler Get Pool Task Details", "when_to_use": "Deep inspect one pooled task."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Deep inspect one pooled task.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"task": {"description": "object - Complete task object with all details: task_id, execute_at, task_type, project_id, priority, scheduler_data, task_data", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_pool_tasks", "scheduler.delete_pool_task"], "required_cap": "scheduler", "safe_action": "scheduler_get_pool_task_details", "summary": "Get detailed information about a specific task from the execution pool.", "title": "Scheduler Get Pool Task Details", "when_to_use": "Deep inspect one pooled task.", "write_mode": null}, {"action": "scheduler.delete_pool_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_pool_task", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "source": "overlay", "title": "Scheduler Delete Pool Task", "when_to_use": "Remove task from scheduler pool."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Remove task from scheduler pool.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string - Confirmation message", "type": "any"}, "success": {"description": "bool - Whether task was removed successfully", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.cancel_task"], "required_cap": "scheduler", "safe_action": "scheduler_delete_pool_task", "summary": "Remove a specific task from the execution pool (does not delete from database).", "title": "Scheduler Delete Pool Task", "when_to_use": "Remove task from scheduler pool.", "write_mode": null}, {"action": "scheduler.clear_pool_tasks", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.clear_pool_tasks", "mutation_risk": "low", "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "source": "overlay", "title": "Scheduler Clear Pool Tasks", "when_to_use": "Bulk clear pool — ops only."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Bulk clear pool — ops only.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cleared_count": {"description": "int - Number of tasks cleared from pool", "type": "any"}, "message": {"description": "string - Confirmation message", "type": "any"}, "success": {"description": "bool - Whether pool was cleared successfully", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.refresh_pool", "scheduler.delete_pool_task"], "required_cap": "scheduler", "safe_action": "scheduler_clear_pool_tasks", "summary": "Clear all tasks from the execution pool (does not delete from database).", "title": "Scheduler Clear Pool Tasks", "when_to_use": "Bulk clear pool — ops only.", "write_mode": null}, {"action": "scheduler.refresh_pool", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.refresh_pool", "mutation_risk": "low", "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "source": "overlay", "title": "Scheduler Refresh Pool", "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill"}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool,…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string - Confirmation message", "type": "any"}, "success": {"description": "bool - Whether refresh was initiated successfully", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.get_pool_tasks", "scheduler.clear_pool_tasks", "scheduler.create_task"], "required_cap": "scheduler", "safe_action": "scheduler_refresh_pool", "summary": "Force a refresh of the scheduler pool from the database.", "title": "Scheduler Refresh Pool", "when_to_use": "Use this tool after creating new scheduled tasks, when you need to immediately see tasks in pool, or to force pool refresh without waiting for automatic refill", "write_mode": null}, {"action": "scheduler.get_all_db_tasks", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.get_all_db_tasks", "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "source": "overlay", "title": "Scheduler Get All Db Tasks", "when_to_use": "DB-backed scheduler rows for migration audit."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "DB-backed scheduler rows for migration audit.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"limit": {"description": "int - Limit used for pagination", "type": "any"}, "offset": {"description": "int - Offset used for pagination", "type": "any"}, "tasks": {"description": "array - Array of all tasks from database", "type": "any"}, "total": {"description": "int - Total number of tasks found", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.list_tasks", "scheduler.get_pool_tasks"], "required_cap": "scheduler", "safe_action": "scheduler_get_all_db_tasks", "summary": "Get all scheduler and standalone tasks from the database (heavy operation).", "title": "Scheduler Get All Db Tasks", "when_to_use": "DB-backed scheduler rows for migration audit.", "write_mode": null}, {"action": "scheduler.cancel_task", "aliases": ["scheduler.delete"], "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.cancel_task", "mutation_risk": "low", "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "source": "overlay", "title": "Scheduler Cancel Task", "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means stopped. Do not follow cancel with scheduler.create_task."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": true, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means stopp…", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"disabled_in_db": {"description": "bool - Whether task was disabled in database", "type": "any"}, "message": {"description": "string - Confirmation message", "type": "any"}, "removed_from_pool": {"description": "bool - Whether task was removed from pool", "type": "any"}, "success": {"description": "bool - Whether task was cancelled successfully", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.delete_pool_task", "scheduler.list_tasks"], "required_cap": "scheduler", "safe_action": "scheduler_cancel_task", "summary": "Cancel/remove a scheduler task (removes from pool and disables in database).", "title": "Cancel Scheduled Task", "when_to_use": "Stop future runs. Then scheduler.get_task. committed=true and next_run_eligible=false means stopped. Do not follow cancel with scheduler.create_task.", "write_mode": null}, {"action": "scheduler.delete_task", "capability_descriptor": {"complexity": "intermediate", "domain": "scheduler", "genetic_tags": ["core.mcp.scheduler.gen1"], "id": "scheduler.delete_task", "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "source": "live", "title": "Scheduler Delete Task", "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations."}, "deprecated": "true", "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": true, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "preferred_action": "scheduler.cancel_task", "reason": "Use scheduler.cancel_task — delete_task is a legacy alias.", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["scheduler.cancel_task", "scheduler.list_tasks"], "required_cap": "project_admin", "safe_action": "scheduler_delete_task", "summary": "Soft-disable alias for scheduler.cancel_task (sets enabled=false; row remains). Prefer scheduler.cancel_task for new agents.", "title": "Scheduler Delete Task", "when_to_use": "Same as scheduler.cancel_task — prefer cancel_task in new integrations.", "write_mode": null}], "seo": [{"action": "seo.meta.get", "capability_descriptor": {"complexity": "simple", "domain": "seo", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.meta.get", "source": "overlay", "title": "Seo Meta Get", "when_to_use": "Public marketing meta for path (title, OG, JSON-LD)."}, "domain_title": "Seo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["docs.seo.surface.gen1"], "instruction_hint": "Public marketing meta for path (title, OG, JSON-LD).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"description": {"description": "string", "type": "any"}, "structured_data": {"description": "object", "type": "any"}, "title": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "docs.seo.surface.gen1", "required_cap": "mcp_read", "safe_action": "seo_meta_get", "summary": "Fetch dynamic meta tags for a public marketing path (title, description, OG, JSON-LD).", "title": "Seo Meta Get", "when_to_use": "Public marketing meta for path (title, OG, JSON-LD).", "write_mode": null}, {"action": "seo.health.check", "capability_descriptor": {"complexity": "simple", "domain": "seo", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.health.check", "source": "overlay", "title": "Seo Health Check", "when_to_use": "SEO registry + indexable path readiness."}, "domain_title": "Seo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["docs.seo.surface.gen1"], "instruction_hint": "SEO registry + indexable path readiness.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"indexable_path_count": {"description": "integer", "type": "any"}, "registry_version": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "docs.seo.surface.gen1", "required_cap": "mcp_read", "safe_action": "seo_health_check", "summary": "SEO registry version, indexable path count, and hosting funnel readiness.", "title": "Seo Health Check", "when_to_use": "SEO registry + indexable path readiness.", "write_mode": null}, {"action": "seo.cache.clear", "capability_descriptor": {"complexity": "simple", "domain": "seo", "genetic_tags": ["docs.seo.surface.gen1"], "id": "seo.cache.clear", "source": "overlay", "title": "Seo Cache Clear", "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping."}, "domain_title": "Seo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["docs.seo.surface.gen1"], "instruction_hint": "Invalidate SEO neural cache; optional IndexNow ping.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.seo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"indexnow": {"description": "object", "type": "any"}, "meta_invalidated": {"description": "integer", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "docs.seo.surface.gen1", "required_cap": "mcp_read", "safe_action": "seo_cache_clear", "summary": "Invalidate neural SEO meta + robots/sitemap caches; optionally ping IndexNow.", "title": "Seo Cache Clear", "when_to_use": "Invalidate SEO neural cache; optional IndexNow ping.", "write_mode": null}], "services": [{"action": "services.diagnostic_sow_draft", "capability_descriptor": {"complexity": "intermediate", "domain": "services", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.diagnostic_sow_draft", "source": "overlay", "title": "Services Diagnostic Sow Draft", "when_to_use": "Staff kickoff: draft diagnostic SoW for a services SKU before CRM persist."}, "domain_title": "Studio Services MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.studio_services.gen1"], "instruction_hint": "Staff kickoff: draft diagnostic SoW for a services SKU before CRM persist.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.studio_services", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"activity_id": {"description": "string", "type": "any"}, "context": {"description": "object", "type": "any"}, "markdown": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.studio_services.gen1", "required_cap": "mcp_read", "safe_action": "services_diagnostic_sow_draft", "summary": "Render a studio diagnostic (kickoff) SoW markdown from the services catalog fixture. Staff-only on ecosystem project 1.", "title": "Services Diagnostic Sow Draft", "when_to_use": "Staff kickoff: draft diagnostic SoW for a services SKU before CRM persist.", "write_mode": null}, {"action": "services.kickoff_slot_status", "capability_descriptor": {"complexity": "intermediate", "domain": "services", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.kickoff_slot_status", "source": "overlay", "title": "Services Kickoff Slot Status", "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery."}, "domain_title": "Studio Services MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.studio_services.gen1"], "instruction_hint": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.studio_services", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"preflight": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.studio_services.gen1", "required_cap": "mcp_read", "safe_action": "services_kickoff_slot_status", "summary": "Read kickoff slot status for CRM contact (optional payer user buff merge).", "title": "Services Kickoff Slot Status", "when_to_use": "Preflight kickoff slot/buff state before scheduling or applying delivery.", "write_mode": null}, {"action": "services.apply_delivery_slot", "capability_descriptor": {"complexity": "intermediate", "domain": "services", "genetic_tags": ["core.mcp.services.gen1"], "id": "services.apply_delivery_slot", "mutation_risk": "low", "source": "overlay", "title": "Services Apply Delivery Slot", "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project."}, "domain_title": "Studio Services MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.studio_services.gen1"], "instruction_hint": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.studio_services", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"slot": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.studio_services.gen1", "required_cap": "mcp_read", "safe_action": "services_apply_delivery_slot", "summary": "Grant phase-1 studio delivery slot on tenant head project (data.ecosystem.buffs[] protected). After signed main SoW.", "title": "Services Apply Delivery Slot", "when_to_use": "After signed SoW — reserve phase-1 delivery slot on tenant head project.", "write_mode": null}], "showcase": [{"action": "showcase.catalog.get", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.get", "source": "live", "title": "Showcase Catalog Get", "when_to_use": "Read /showcase gallery catalog, health overlay, and settings on pid=1."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Read /showcase gallery catalog, health overlay, and settings on pid=1.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"catalog": {"description": "object", "type": "any"}, "catalog_revision": {"description": "string", "type": "any"}, "settings": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_catalog_get", "summary": "Merged public showcase catalog (ecosystem DNA + fixture seed).", "title": "Showcase Catalog Get", "when_to_use": "Read /showcase gallery catalog, health overlay, and settings on pid=1.", "write_mode": null}, {"action": "showcase.catalog.list_entries", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.list_entries", "source": "live", "title": "Showcase Catalog List Entries", "when_to_use": "Inventory / filter before upsert on project_id=1; prefer over full catalog.get."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Inventory / filter before upsert on project_id=1; prefer over full catalog.get.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entries": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_catalog_list_entries", "summary": "Lightweight list of showcase catalog cards (merged). required_scope: ecosystem project_id=1. Other project ids return invalid_parameters.", "title": "Showcase Catalog List Entries", "when_to_use": "Inventory / filter before upsert on project_id=1; prefer over full catalog.get.", "write_mode": null}, {"action": "showcase.catalog.patch_entry", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.patch_entry", "source": "live", "title": "Showcase Catalog Patch Entry", "when_to_use": "Change tagline/title/status without full entry object."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Change tagline/title/status without full entry object.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entry_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "project_admin", "safe_action": "showcase_catalog_patch_entry", "summary": "Partial update of one catalog card on ecosystem DNA.", "title": "Showcase Catalog Patch Entry", "when_to_use": "Change tagline/title/status without full entry object.", "write_mode": null}, {"action": "showcase.catalog.diff_vs_fixture", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.diff_vs_fixture", "source": "live", "title": "Showcase Catalog Diff Vs Fixture", "when_to_use": "CI/ops before promoting catalog DNA changes."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "CI/ops before promoting catalog DNA changes.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"extra_in_dna": {"description": "array", "type": "any"}, "missing_in_dna": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_catalog_diff_vs_fixture", "summary": "Drift report: DNA catalog entry ids vs git fixture.", "title": "Showcase Catalog Diff Vs Fixture", "when_to_use": "CI/ops before promoting catalog DNA changes.", "write_mode": null}, {"action": "showcase.catalog.export_fixture", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.export_fixture", "source": "live", "title": "Showcase Catalog Export Fixture", "when_to_use": "After editing catalog in DNA — sync to showcase_catalog_v1.json."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "After editing catalog in DNA — sync to showcase_catalog_v1.json.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entries": {"description": "array", "type": "any"}, "version": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_catalog_export_fixture", "summary": "Export merged catalog as fixture-shaped JSON for git sync.", "title": "Showcase Catalog Export Fixture", "when_to_use": "After editing catalog in DNA — sync to showcase_catalog_v1.json.", "write_mode": null}, {"action": "showcase.catalog.upsert_entry", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.upsert_entry", "source": "live", "title": "Showcase Catalog Upsert Entry", "when_to_use": "Add or update a /showcase card; does not mutate tenant 8DNA."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Add or update a /showcase card; does not mutate tenant 8DNA.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entry_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "project_admin", "safe_action": "showcase_catalog_upsert_entry", "summary": "Upsert one showcase catalog card on ecosystem DNA (pid=1).", "title": "Showcase Catalog Upsert Entry", "when_to_use": "Add or update a /showcase card; does not mutate tenant 8DNA.", "write_mode": null}, {"action": "showcase.settings.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.settings.patch", "source": "live", "title": "Showcase Settings Patch", "when_to_use": "Change featured card, cache TTL, hire SKU map."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Change featured card, cache TTL, hire SKU map.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"settings": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "project_admin", "safe_action": "showcase_settings_patch", "summary": "Patch showcase gallery settings on ecosystem DNA.", "title": "Showcase Settings Patch", "when_to_use": "Change featured card, cache TTL, hire SKU map.", "write_mode": null}, {"action": "showcase.catalog.reorder", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.catalog.reorder", "source": "live", "title": "Showcase Catalog Reorder", "when_to_use": "Reorder /s/ showcase gallery card order after upsert or featured change."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Reorder /s/ showcase gallery card order after upsert or featured change.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entry_order": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_catalog_reorder", "summary": "Reorder showcase cards (entry_order on ecosystem DNA).", "title": "Showcase Catalog Reorder", "when_to_use": "Reorder /s/ showcase gallery card order after upsert or featured change.", "write_mode": null}, {"action": "showcase.health.probe", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.health.probe", "source": "live", "title": "Showcase Health Probe", "when_to_use": "Refresh Live badges after tenant publish or deploy."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Refresh Live badges after tenant publish or deploy.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"health": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_health_probe", "summary": "Probe canonical /s/ URLs and stamp ecosystem health.", "title": "Showcase Health Probe", "when_to_use": "Refresh Live badges after tenant publish or deploy.", "write_mode": null}, {"action": "showcase.tenant.register", "capability_descriptor": {"complexity": "intermediate", "domain": "showcase", "genetic_tags": ["core.mcp.showcase.gen1"], "id": "showcase.tenant.register", "source": "live", "title": "Showcase Tenant Register", "when_to_use": "Link live /s/{pid}/{bucket}/ to /showcase without showcase bootstrap."}, "domain_title": "Showcase MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.showcase.gen1"], "instruction_hint": "Link live /s/{pid}/{bucket}/ to /showcase without showcase bootstrap.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.showcase", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entry_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.showcase.gen1", "related_prompts": ["agentstack_showcase_ops"], "required_cap": "mcp_read", "safe_action": "showcase_tenant_register", "summary": "Register an independent tenant on the public showcase (gallery card only).", "title": "Showcase Tenant Register", "when_to_use": "Link live /s/{pid}/{bucket}/ to /showcase without showcase bootstrap.", "write_mode": null}], "social": [{"action": "social.chat.index_get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_get", "source": "overlay", "title": "Social Chat Index Get", "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entries": {"description": "array of chat index entries: channel_id, pinned, order, unread_count", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_index_get", "summary": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "title": "Social Chat Index Get", "when_to_use": "Get the current user's messenger sidebar index — list of channels with pinned/order metadata.", "write_mode": null}, {"action": "social.chat.index_put", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.index_put", "source": "overlay", "title": "Social Chat Index Put", "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "kind": "mcp_domain", "mutation_kind": "collection", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_index_put", "summary": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "title": "Social Chat Index Put", "when_to_use": "Replace the messenger sidebar index (subset-as-delete with If-Match on REST).", "write_mode": null, "write_mode_note": "Exception: subset-as-delete with If-Match. A short list can drop missing keys. Do not apply bots-style merge defaults here."}, {"action": "social.chat.history", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.history", "source": "overlay", "title": "Social Chat History", "when_to_use": "Messenger channel history — use social.support.history for support tickets."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Messenger channel history — use social.support.history for support tickets.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"messages": {"description": "array of message objects: id, seq, body, sender_user_id, created_at, meta", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_history", "summary": "Read chat history from a messenger channel (AI-accessible).", "title": "Social Chat History", "when_to_use": "Messenger channel history — use social.support.history for support tickets.", "write_mode": null}, {"action": "social.chat.post", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.post", "source": "overlay", "title": "Social Chat Post", "when_to_use": "In-app messenger message — not project support (psup) thread."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "In-app messenger message — not project support (psup) thread.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "Created message with id and seq", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_post", "summary": "Send a chat message to a messenger channel as the AI agent (authenticated user).", "title": "Social Chat Post", "when_to_use": "In-app messenger message — not project support (psup) thread.", "write_mode": null}, {"action": "social.chat.pin", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.pin", "source": "overlay", "title": "Social Chat Pin", "when_to_use": "Pin a message in a channel."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Pin a message in a channel.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_pin", "summary": "Pin a message in a channel.", "title": "Social Chat Pin", "when_to_use": "Pin a message in a channel.", "write_mode": null}, {"action": "social.chat.unpin", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.unpin", "source": "overlay", "title": "Social Chat Unpin", "when_to_use": "Unpin a message in a channel."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Unpin a message in a channel.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_unpin", "summary": "Unpin a message in a channel.", "title": "Social Chat Unpin", "when_to_use": "Unpin a message in a channel.", "write_mode": null}, {"action": "social.chat.message_edit", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_edit", "source": "overlay", "title": "Social Chat Message Edit", "when_to_use": "Edit own chat message (author only)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Edit own chat message (author only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "Updated message", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_message_edit", "summary": "Edit own chat message (author only).", "title": "Social Chat Message Edit", "when_to_use": "Edit own chat message (author only).", "write_mode": null}, {"action": "social.chat.message_delete", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.message_delete", "mutation_risk": "high", "source": "overlay", "title": "Social Chat Message Delete", "when_to_use": "Delete a chat message (author or channel owner per server rules)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Delete a chat message (author or channel owner per server rules).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_message_delete", "summary": "Delete a chat message (author or channel owner per server rules).", "title": "Social Chat Message Delete", "when_to_use": "Delete a chat message (author or channel owner per server rules).", "write_mode": null}, {"action": "social.chat.reaction", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.reaction", "source": "overlay", "title": "Social Chat Reaction", "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Apply one server-authoritative reaction on a message (immutable cell per user).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"hlc": {"description": "optional wire-HLC", "type": "any"}, "status": {"description": "applied | noop_same | reject_occupied", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_reaction", "summary": "Apply one server-authoritative reaction on a message (immutable cell per user).", "title": "Social Chat Reaction", "when_to_use": "Apply one server-authoritative reaction on a message (immutable cell per user).", "write_mode": null}, {"action": "social.chat.read_set", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_set", "source": "overlay", "title": "Social Chat Read Set", "when_to_use": "Update last-read pointer (read receipt) for a channel."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Update last-read pointer (read receipt) for a channel.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"read": {"description": "Read state", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_read_set", "summary": "Update last-read pointer (read receipt) for a channel.", "title": "Social Chat Read Set", "when_to_use": "Update last-read pointer (read receipt) for a channel.", "write_mode": null}, {"action": "social.chat.read_get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.read_get", "source": "overlay", "title": "Social Chat Read Get", "when_to_use": "Get last-read state for a channel for the current user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Get last-read state for a channel for the current user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"read": {"description": "Read state", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_read_get", "summary": "Get last-read state for a channel for the current user.", "title": "Social Chat Read Get", "when_to_use": "Get last-read state for a channel for the current user.", "write_mode": null}, {"action": "social.chat.presence_online", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.presence_online", "source": "overlay", "title": "Social Chat Presence Online", "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"user_ids": {"description": "array of int — user IDs with active real-time connections", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_presence_online", "summary": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "title": "Social Chat Presence Online", "when_to_use": "List user IDs currently online (active SSE stream-relay connection) in the home project.", "write_mode": null}, {"action": "social.friends.list", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.list", "source": "overlay", "title": "Social Friends List", "when_to_use": "List friends for the current user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "List friends for the current user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"friends": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_list", "summary": "List friends for the current user.", "title": "Social Friends List", "when_to_use": "List friends for the current user.", "write_mode": null}, {"action": "social.friends.user_ids", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.user_ids", "source": "overlay", "title": "Social Friends User Ids", "when_to_use": "Ordered friend user id list."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Ordered friend user id list.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"friend_user_ids": {"description": "array of int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_user_ids", "summary": "Ordered friend user id list.", "title": "Social Friends User Ids", "when_to_use": "Ordered friend user id list.", "write_mode": null}, {"action": "social.friends.cards", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards", "source": "overlay", "title": "Social Friends Cards", "when_to_use": "Public card fields for each friend."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Public card fields for each friend.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cards": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_cards", "summary": "Public card fields for each friend.", "title": "Social Friends Cards", "when_to_use": "Public card fields for each friend.", "write_mode": null}, {"action": "social.friends.cards_batch", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cards_batch", "source": "overlay", "title": "Social Friends Cards Batch", "when_to_use": "Friend cards for specific user ids (must be friends)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Friend cards for specific user ids (must be friends).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cards": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_cards_batch", "summary": "Friend cards for specific user ids (must be friends).", "title": "Social Friends Cards Batch", "when_to_use": "Friend cards for specific user ids (must be friends).", "write_mode": null}, {"action": "social.followers.list", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.followers.list", "source": "overlay", "title": "Social Followers List", "when_to_use": "Users who follow the current user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Users who follow the current user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"followers": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_followers_list", "summary": "Users who follow the current user.", "title": "Social Followers List", "when_to_use": "Users who follow the current user.", "write_mode": null}, {"action": "social.privacy.get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.get", "source": "overlay", "title": "Social Privacy Get", "when_to_use": "Get friend/DM privacy settings."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Get friend/DM privacy settings.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"settings": {"description": "privacy object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_privacy_get", "summary": "Get friend/DM privacy settings.", "title": "Social Privacy Get", "when_to_use": "Get friend/DM privacy settings.", "write_mode": null}, {"action": "social.privacy.put", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.privacy.put", "source": "overlay", "title": "Social Privacy Put", "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Update privacy settings (incoming_friend_requests, dm_policy).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_privacy_put", "summary": "Update privacy settings (incoming_friend_requests, dm_policy).", "title": "Social Privacy Put", "when_to_use": "Update privacy settings (incoming_friend_requests, dm_policy).", "write_mode": null}, {"action": "social.friends.requests_in", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_in", "source": "overlay", "title": "Social Friends Requests In", "when_to_use": "Incoming friend requests."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Incoming friend requests.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"requests": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_requests_in", "summary": "Incoming friend requests.", "title": "Social Friends Requests In", "when_to_use": "Incoming friend requests.", "write_mode": null}, {"action": "social.friends.requests_out", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.requests_out", "source": "overlay", "title": "Social Friends Requests Out", "when_to_use": "Outgoing friend requests."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Outgoing friend requests.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"requests": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_requests_out", "summary": "Outgoing friend requests.", "title": "Social Friends Requests Out", "when_to_use": "Outgoing friend requests.", "write_mode": null}, {"action": "social.friends.request_respond", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request_respond", "source": "overlay", "title": "Social Friends Request Respond", "when_to_use": "Accept/reject/subscriber/block on an incoming friend request."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Accept/reject/subscriber/block on an incoming friend request.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_request_respond", "summary": "Accept/reject/subscriber/block on an incoming friend request.", "title": "Social Friends Request Respond", "when_to_use": "Accept/reject/subscriber/block on an incoming friend request.", "write_mode": null}, {"action": "social.friends.request", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.request", "source": "overlay", "title": "Social Friends Request", "when_to_use": "Send a friend request (optional source context for public_channel)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Send a friend request (optional source context for public_channel).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "e.g. pending or auto_accepted", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_request", "summary": "Send a friend request (optional source context for public_channel).", "title": "Social Friends Request", "when_to_use": "Send a friend request (optional source context for public_channel).", "write_mode": null}, {"action": "social.friends.accept", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.accept", "source": "overlay", "title": "Social Friends Accept", "when_to_use": "Accept friend request from user_id."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Accept friend request from user_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_accept", "summary": "Accept friend request from user_id.", "title": "Social Friends Accept", "when_to_use": "Accept friend request from user_id.", "write_mode": null}, {"action": "social.friends.remove", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.remove", "mutation_risk": "high", "source": "overlay", "title": "Social Friends Remove", "when_to_use": "Remove an existing friend."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Remove an existing friend.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_remove", "summary": "Remove an existing friend.", "title": "Social Friends Remove", "when_to_use": "Remove an existing friend.", "write_mode": null}, {"action": "social.friends.reject", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.reject", "source": "overlay", "title": "Social Friends Reject", "when_to_use": "Reject a pending friend request."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Reject a pending friend request.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_reject", "summary": "Reject a pending friend request.", "title": "Social Friends Reject", "when_to_use": "Reject a pending friend request.", "write_mode": null}, {"action": "social.friends.cancel", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.cancel", "source": "overlay", "title": "Social Friends Cancel", "when_to_use": "Cancel outgoing friend request."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Cancel outgoing friend request.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_cancel", "summary": "Cancel outgoing friend request.", "title": "Social Friends Cancel", "when_to_use": "Cancel outgoing friend request.", "write_mode": null}, {"action": "social.friends.block", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.friends.block", "source": "overlay", "title": "Social Friends Block", "when_to_use": "Block a user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Block a user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_friends_block", "summary": "Block a user.", "title": "Social Friends Block", "when_to_use": "Block a user.", "write_mode": null}, {"action": "social.users.public_cards", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.public_cards", "source": "overlay", "title": "Social Users Public Cards", "when_to_use": "Public display cards for user ids (no friendship check)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Public display cards for user ids (no friendship check).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cards": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_users_public_cards", "summary": "Public display cards for user ids (no friendship check).", "title": "Social Users Public Cards", "when_to_use": "Public display cards for user ids (no friendship check).", "write_mode": null}, {"action": "social.users.lookup", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.users.lookup", "source": "overlay", "title": "Social Users Lookup", "when_to_use": "Find users by id, email, or @username (no email in response)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Find users by id, email, or @username (no email in response).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"matches": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_users_lookup", "summary": "Find users by id, email, or @username (no email in response).", "title": "Social Users Lookup", "when_to_use": "Find users by id, email, or @username (no email in response).", "write_mode": null}, {"action": "social.party_invite.mint", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.mint", "mutation_risk": "low", "source": "overlay", "title": "Social Party Invite Mint", "when_to_use": "Mint a short-lived party invite token for a relay room."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Mint a short-lived party invite token for a relay room.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"token": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_party_invite_mint", "summary": "Mint a short-lived party invite token for a relay room.", "title": "Social Party Invite Mint", "when_to_use": "Mint a short-lived party invite token for a relay room.", "write_mode": null}, {"action": "social.party_invite.verify", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.party_invite.verify", "source": "overlay", "title": "Social Party Invite Verify", "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Verify party invite token (no auth required on REST; MCP still needs project context).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"payload": {"description": "decoded invite payload", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_party_invite_verify", "summary": "Verify party invite token (no auth required on REST; MCP still needs project context).", "title": "Social Party Invite Verify", "when_to_use": "Verify party invite token (no auth required on REST; MCP still needs project context).", "write_mode": null}, {"action": "social.channel_invites.link_token", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.link_token", "source": "overlay", "title": "Social Channel Invites Link Token", "when_to_use": "Create shareable link token for a channel (owner)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Create shareable link token for a channel (owner).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"token": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_link_token", "summary": "Create shareable link token for a channel (owner).", "title": "Social Channel Invites Link Token", "when_to_use": "Create shareable link token for a channel (owner).", "write_mode": null}, {"action": "social.channel_invites.direct", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.direct", "source": "overlay", "title": "Social Channel Invites Direct", "when_to_use": "Create direct channel invite to a user (owner)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Create direct channel invite to a user (owner).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"invite_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_direct", "summary": "Create direct channel invite to a user (owner).", "title": "Social Channel Invites Direct", "tool_chains": ["multi_tenant_onboarding"], "when_to_use": "Create direct channel invite to a user (owner).", "write_mode": null}, {"action": "social.channel_invites.inbox", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.inbox", "source": "overlay", "title": "Social Channel Invites Inbox", "when_to_use": "List pending channel invites for the current user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "List pending channel invites for the current user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"invites": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_inbox", "summary": "List pending channel invites for the current user.", "title": "Social Channel Invites Inbox", "when_to_use": "List pending channel invites for the current user.", "write_mode": null}, {"action": "social.channel_invites.accept", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.accept", "source": "overlay", "title": "Social Channel Invites Accept", "when_to_use": "Accept a channel invite from inbox."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Accept a channel invite from inbox.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel_id": {"description": "string", "type": "any"}, "home_project_id": {"description": "int", "type": "any"}, "title": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_accept", "summary": "Accept a channel invite from inbox.", "title": "Social Channel Invites Accept", "when_to_use": "Accept a channel invite from inbox.", "write_mode": null}, {"action": "social.channel_invites.decline", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.decline", "source": "overlay", "title": "Social Channel Invites Decline", "when_to_use": "Decline a channel invite."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Decline a channel invite.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_decline", "summary": "Decline a channel invite.", "title": "Social Channel Invites Decline", "when_to_use": "Decline a channel invite.", "write_mode": null}, {"action": "social.channel_invites.redeem", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channel_invites.redeem", "source": "overlay", "title": "Social Channel Invites Redeem", "when_to_use": "Redeem channel invite token."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Redeem channel invite token.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel_id": {"description": "string", "type": "any"}, "home_project_id": {"description": "int", "type": "any"}, "title": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channel_invites_redeem", "summary": "Redeem channel invite token.", "title": "Social Channel Invites Redeem", "when_to_use": "Redeem channel invite token.", "write_mode": null}, {"action": "social.federation.add", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.add", "source": "overlay", "title": "Social Federation Add", "when_to_use": "Add federated open-channel pointer on consumer project."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Add federated open-channel pointer on consumer project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_federation_add", "summary": "Add federated open-channel pointer on consumer project.", "title": "Social Federation Add", "when_to_use": "Add federated open-channel pointer on consumer project.", "write_mode": null}, {"action": "social.federation.get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.federation.get", "source": "overlay", "title": "Social Federation Get", "when_to_use": "List federation pointers for a consumer project."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "List federation pointers for a consumer project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"open_channels": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_federation_get", "summary": "List federation pointers for a consumer project.", "title": "Social Federation Get", "when_to_use": "List federation pointers for a consumer project.", "write_mode": null}, {"action": "social.channels.register", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.register", "source": "overlay", "title": "Social Channels Register", "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Create a new messenger channel (group chat, DM, or broadcast).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel_id": {"description": "string — use this for social.chat.post", "type": "any"}, "title": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channels_register", "summary": "Create a new messenger channel (group chat, DM, or broadcast).", "title": "Social Channels Register", "when_to_use": "Create a new messenger channel (group chat, DM, or broadcast).", "write_mode": null}, {"action": "social.channels.update", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.update", "mutation_risk": "low", "source": "overlay", "title": "Social Channels Update", "when_to_use": "Update channel metadata (owner)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Update channel metadata (owner).", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channels_update", "summary": "Update channel metadata (owner).", "title": "Social Channels Update", "when_to_use": "Update channel metadata (owner).", "write_mode": null}, {"action": "social.channels.delete", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.delete", "mutation_risk": "high", "source": "overlay", "title": "Social Channels Delete", "when_to_use": "Delete a channel (owner) and unpublish from public index."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Delete a channel (owner) and unpublish from public index.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "safe_action": "social_channels_delete", "summary": "Delete a channel (owner) and unpublish from public index.", "title": "Social Channels Delete", "when_to_use": "Delete a channel (owner) and unpublish from public index.", "write_mode": null}, {"action": "social.channels.list", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.list", "source": "overlay", "title": "Social Channels List", "when_to_use": "List all channels in the home project."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "List all channels in the home project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channels": {"description": "array of channel objects: channel_id, title, visibility, room_kind, description", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channels_list", "summary": "List all channels in the home project.", "title": "Social Channels List", "when_to_use": "List all channels in the home project.", "write_mode": null}, {"action": "social.channels.get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.channels.get", "source": "overlay", "title": "Social Channels Get", "when_to_use": "Get one channel if the current user may access it."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Get one channel if the current user may access it.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channel": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_channels_get", "summary": "Get one channel if the current user may access it.", "title": "Social Channels Get", "when_to_use": "Get one channel if the current user may access it.", "write_mode": null}, {"action": "social.entities.expand", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.entities.expand", "source": "overlay", "title": "Social Entities Expand", "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entities": {"description": "map id -> metadata", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_entities_expand", "summary": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "title": "Social Entities Expand", "when_to_use": "Batch-resolve channel/surrogate ids to metadata (max 100 ids).", "write_mode": null}, {"action": "social.pas.public_me_get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_get", "source": "overlay", "title": "Social Pas Public Me Get", "when_to_use": "Read Principal Access public slice for current user on a home project."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Read Principal Access public slice for current user on a home project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"slice": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_pas_public_me_get", "summary": "Read Principal Access public slice for current user on a home project.", "title": "Social Pas Public Me Get", "when_to_use": "Read Principal Access public slice for current user on a home project.", "write_mode": null}, {"action": "social.pas.public_me_put", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.pas.public_me_put", "source": "overlay", "title": "Social Pas Public Me Put", "when_to_use": "Replace channels/chats/groups lists in PAS public slice."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Replace channels/chats/groups lists in PAS public slice.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_pas_public_me_put", "summary": "Replace channels/chats/groups lists in PAS public slice.", "title": "Social Pas Public Me Put", "when_to_use": "Replace channels/chats/groups lists in PAS public slice.", "write_mode": null}, {"action": "social.public.quota_get", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.quota_get", "source": "overlay", "title": "Social Public Quota Get", "when_to_use": "Social public index quota for current user."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Social public index quota for current user.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"quota": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_quota_get", "summary": "Social public index quota for current user.", "title": "Social Public Quota Get", "when_to_use": "Social public index quota for current user.", "write_mode": null}, {"action": "social.public.me", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.me", "source": "overlay", "title": "Social Public Me", "when_to_use": "Public maps from user row (ecosystem.social.public)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Public maps from user row (ecosystem.social.public).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"public_maps": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_me", "summary": "Public maps from user row (ecosystem.social.public).", "title": "Social Public Me", "when_to_use": "Public maps from user row (ecosystem.social.public).", "write_mode": null}, {"action": "social.public.publish", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.publish", "source": "overlay", "title": "Social Public Publish", "when_to_use": "Publish a channel/chats/groups entry to public index."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Publish a channel/chats/groups entry to public index.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_publish", "summary": "Publish a channel/chats/groups entry to public index.", "title": "Social Public Publish", "when_to_use": "Publish a channel/chats/groups entry to public index.", "write_mode": null}, {"action": "social.public.unpublish", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.unpublish", "source": "overlay", "title": "Social Public Unpublish", "when_to_use": "Remove a public index entry."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "production_publish", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Remove a public index entry.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"success": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_unpublish", "summary": "Remove a public index entry.", "title": "Social Public Unpublish", "when_to_use": "Remove a public index entry.", "write_mode": null}, {"action": "social.public.index", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.index", "source": "overlay", "title": "Social Public Index", "when_to_use": "Read a page of the public discovery index."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Read a page of the public discovery index.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cursor": {"description": "string|null", "type": "any"}, "entries": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_index", "summary": "Read a page of the public discovery index.", "title": "Social Public Index", "when_to_use": "Read a page of the public discovery index.", "write_mode": null}, {"action": "social.public.reconcile", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.public.reconcile", "source": "overlay", "title": "Social Public Reconcile", "when_to_use": "Reconcile public maps (privileged role only)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Reconcile public maps (privileged role only).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"result": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_public_reconcile", "summary": "Reconcile public maps (privileged role only).", "title": "Social Public Reconcile", "when_to_use": "Reconcile public maps (privileged role only).", "write_mode": null}, {"action": "social.merge_feed", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.merge_feed", "mutation_risk": "low", "source": "overlay", "title": "Social Merge Feed", "when_to_use": "Merge read of multiple channel pointers (reader must access each)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Merge read of multiple channel pointers (reader must access each).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"merged": {"description": "feed payload", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_merge_feed", "summary": "Merge read of multiple channel pointers (reader must access each).", "title": "Social Merge Feed", "when_to_use": "Merge read of multiple channel pointers (reader must access each).", "write_mode": null}, {"action": "social.admin.chat_sweep", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_sweep", "source": "overlay", "title": "Social Admin Chat Sweep", "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"dna_updated": {"description": "int", "type": "any"}, "inspected": {"description": "int", "type": "any"}, "updated": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_chat_sweep", "summary": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "title": "Social Admin Chat Sweep", "when_to_use": "Run one chat history prune batch. Requires ecosystem owner/admin on project 1.", "write_mode": null}, {"action": "social.admin.user_summary", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.user_summary", "source": "overlay", "title": "Social Admin User Summary", "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"summary": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_user_summary", "summary": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "title": "Social Admin User Summary", "when_to_use": "Operator: aggregate friend/request/block counts and messenger prefs summary for a user_id.", "write_mode": null}, {"action": "social.admin.chat_index_page", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.chat_index_page", "source": "overlay", "title": "Social Admin Chat Index Page", "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: paginated messenger chat index for a user (cursor/limit).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entries": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_chat_index_page", "summary": "Operator: paginated messenger chat index for a user (cursor/limit).", "title": "Social Admin Chat Index Page", "when_to_use": "Operator: paginated messenger chat index for a user (cursor/limit).", "write_mode": null}, {"action": "social.admin.channel_search", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.channel_search", "source": "overlay", "title": "Social Admin Channel Search", "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: search channel metadata on a home_project_id by substring (id/title).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channels": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_channel_search", "summary": "Operator: search channel metadata on a home_project_id by substring (id/title).", "title": "Social Admin Channel Search", "when_to_use": "Operator: search channel metadata on a home_project_id by substring (id/title).", "write_mode": null}, {"action": "social.admin.directory_search", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.directory_search", "source": "overlay", "title": "Social Admin Directory Search", "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"channels": {"description": "array", "type": "any"}, "users": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_directory_search", "summary": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "title": "Social Admin Directory Search", "when_to_use": "Operator: unified typeahead — users (8DNA) + channels for a home_project_id.", "write_mode": null}, {"action": "social.admin.messenger_policy_get", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_get", "source": "overlay", "title": "Social Admin Messenger Policy Get", "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"defaults": {"description": "dict", "type": "any"}, "effective": {"description": "dict", "type": "any"}, "stored": {"description": "dict|null", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_messenger_policy_get", "summary": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "title": "Social Admin Messenger Policy Get", "when_to_use": "Operator: read messenger retention defaults, stored overrides, and merged effective policy.", "write_mode": null}, {"action": "social.admin.messenger_policy_set", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_policy_set", "source": "overlay", "title": "Social Admin Messenger Policy Set", "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"effective": {"description": "dict", "type": "any"}, "saved": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_messenger_policy_set", "summary": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "title": "Social Admin Messenger Policy Set", "when_to_use": "Operator: replace messenger_operator_policy on ecosystem project (tiers, temp TTL, sweep ceiling).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_get", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_get", "source": "overlay", "title": "Social Admin Messenger Client Cache Get", "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"defaults": {"description": "dict", "type": "any"}, "effective": {"description": "dict", "type": "any"}, "stored": {"description": "dict|null", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_messenger_client_cache_get", "summary": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "title": "Social Admin Messenger Client Cache Get", "when_to_use": "Operator: read messenger client cache limits (defaults, stored overrides, merged effective).", "write_mode": null}, {"action": "social.admin.messenger_client_cache_set", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.messenger_client_cache_set", "source": "overlay", "title": "Social Admin Messenger Client Cache Set", "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"effective": {"description": "dict", "type": "any"}, "saved": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_messenger_client_cache_set", "summary": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "title": "Social Admin Messenger Client Cache Set", "when_to_use": "Operator: replace data.ecosystem.messenger_client_cache on ecosystem project (media/IDB/OPFS caps).", "write_mode": null}, {"action": "social.admin.public_index_status", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.public_index_status", "source": "overlay", "title": "Social Admin Public Index Status", "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: public index page or reconcile maps (set reconcile=true).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"page": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_public_index_status", "summary": "Operator: public index page or reconcile maps (set reconcile=true).", "title": "Social Admin Public Index Status", "when_to_use": "Operator: public index page or reconcile maps (set reconcile=true).", "write_mode": null}, {"action": "social.admin.dm_thread_meta", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.dm_thread_meta", "source": "overlay", "title": "Social Admin Dm Thread Meta", "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: DM thread metadata (counts, participants) for support; audited.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"meta": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_dm_thread_meta", "summary": "Operator: DM thread metadata (counts, participants) for support; audited.", "title": "Social Admin Dm Thread Meta", "when_to_use": "Operator: DM thread metadata (counts, participants) for support; audited.", "write_mode": null}, {"action": "social.admin.graph_edges", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.graph_edges", "source": "overlay", "title": "Social Admin Graph Edges", "when_to_use": "Operator: list friend and blocked edges for a user (capped)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: list friend and blocked edges for a user (capped).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"edges": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_graph_edges", "summary": "Operator: list friend and blocked edges for a user (capped).", "title": "Social Admin Graph Edges", "when_to_use": "Operator: list friend and blocked edges for a user (capped).", "write_mode": null}, {"action": "social.admin.relay_hints", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.relay_hints", "source": "overlay", "title": "Social Admin Relay Hints", "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: static hints for stream relay room naming and diagnostics paths.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"hints": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_relay_hints", "summary": "Operator: static hints for stream relay room naming and diagnostics paths.", "title": "Social Admin Relay Hints", "when_to_use": "Operator: static hints for stream relay room naming and diagnostics paths.", "write_mode": null}, {"action": "social.admin.force_delete_message", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_delete_message", "mutation_risk": "high", "source": "overlay", "title": "Social Admin Force Delete Message", "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_admin", "safe_action": "social_admin_force_delete_message", "summary": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "title": "Social Admin Force Delete Message", "when_to_use": "Operator: delete a chat message by id from DNA ring (ecosystem owner). Use dry_run first.", "write_mode": null}, {"action": "social.admin.reset_messenger_prefs", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.reset_messenger_prefs", "source": "overlay", "title": "Social Admin Reset Messenger Prefs", "when_to_use": "Operator: clear messenger_prefs for a user (reason required)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: clear messenger_prefs for a user (reason required).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"prefs": {"description": "dict", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_reset_messenger_prefs", "summary": "Operator: clear messenger_prefs for a user (reason required).", "title": "Social Admin Reset Messenger Prefs", "when_to_use": "Operator: clear messenger_prefs for a user (reason required).", "write_mode": null}, {"action": "social.admin.revoke_federation", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.revoke_federation", "mutation_risk": "high", "source": "overlay", "title": "Social Admin Revoke Federation", "when_to_use": "Operator: remove a federation pointer from consumer to source channel."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: remove a federation pointer from consumer to source channel.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"revoked": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_revoke_federation", "summary": "Operator: remove a federation pointer from consumer to source channel.", "title": "Social Admin Revoke Federation", "when_to_use": "Operator: remove a federation pointer from consumer to source channel.", "write_mode": null}, {"action": "social.admin.force_close_channel", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.admin.force_close_channel", "source": "overlay", "title": "Social Admin Force Close Channel", "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_admin_force_close_channel", "summary": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "title": "Social Admin Force Close Channel", "when_to_use": "Operator: delete channel metadata from project data_channels (ecosystem owner).", "write_mode": null}, {"action": "social.chat.delta", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.delta", "source": "overlay", "title": "Social Chat Delta", "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,"}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Unified incremental delta for a messenger channel — one call returns new messages,", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"has_more": {"description": "True when the tail was truncated by limit", "type": "any"}, "messages_appended": {"description": "Array of new messages since since_seq", "type": "any"}, "messages_patched": {"description": "Array of edit patches", "type": "any"}, "next_cursor": {"description": "Seq to pass as since_seq on next call when has_more=true", "type": "any"}, "reactions": {"description": "Reactions delta", "type": "any"}, "read_receipts": {"description": "Caller's read-receipt tuple", "type": "any"}, "server_hlc": {"description": "Latest server HLC in base36", "type": "any"}, "server_seq": {"description": "Latest server seq for this channel", "type": "any"}, "y_updates": {"description": "CRDT updates (base64) — opaque payload for Yjs clients", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_delta", "summary": "Unified incremental delta for a messenger channel — one call returns new messages,", "title": "Social Chat Delta", "when_to_use": "Unified incremental delta for a messenger channel — one call returns new messages,", "write_mode": null}, {"action": "social.chat.crdt_update", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_update", "mutation_risk": "low", "source": "overlay", "title": "Social Chat Crdt Update", "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes)."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied": {"description": "bool", "type": "any"}, "bytes": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_crdt_update", "summary": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "title": "Social Chat Crdt Update", "when_to_use": "Apply a Y.js CRDT update to a channel's shared document (bodies / pins / deletes).", "write_mode": null}, {"action": "social.chat.crdt_state", "capability_descriptor": {"complexity": "advanced", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.chat.crdt_state", "source": "overlay", "title": "Social Chat Crdt State", "when_to_use": "Read the current CRDT snapshot + raw updates for a channel."}, "domain_title": "Social MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Read the current CRDT snapshot + raw updates for a channel.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.social", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"server_hlc": {"description": "latest HLC (base36)", "type": "any"}, "snapshot_base64": {"description": "base64 — full compacted state (optional)", "type": "any"}, "updates_base64": {"description": "array of base64-encoded updates since last snapshot", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_chat_crdt_state", "summary": "Read the current CRDT snapshot + raw updates for a channel.", "title": "Social Chat Crdt State", "when_to_use": "Read the current CRDT snapshot + raw updates for a channel.", "write_mode": null}, {"action": "social.support.history", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.history", "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "source": "overlay", "title": "Social Support History", "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Read caller's psup thread (user plane) — pair with social.support.send.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"messages": {"description": "array", "type": "any"}, "server_seq": {"description": "int", "type": "any"}, "tickets": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.request_human", "social.chat.history"], "required_cap": "project_support", "safe_action": "social_support_history", "summary": "Read project support thread for the authenticated user (channel psup_p{pid}_u{uid}).", "title": "Social Support History", "when_to_use": "Read caller's psup thread (user plane) — pair with social.support.send.", "write_mode": null}, {"action": "social.support.send", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.send", "related_tools": ["social.support.history", "social.support.request_human"], "source": "overlay", "title": "Social Support Send", "when_to_use": "Post in psup thread: user message or staff reply when permitted."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Post in psup thread: user message or staff reply when permitted.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.request_human"], "required_cap": "project_support", "safe_action": "social_support_send", "summary": "Send a message in the user's support thread for a project (user) or staff reply when permitted.", "title": "Social Support Send", "when_to_use": "Post in psup thread: user message or staff reply when permitted.", "write_mode": null}, {"action": "social.support.inbox", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.inbox", "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "source": "handler", "title": "Social Support Inbox", "when_to_use": "Staff desk: list open support tickets for a project."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "inputSchema": {"properties": {"limit": {"description": "Max rows", "type": "integer"}, "project_id": {"description": "Home project id", "type": "integer"}}, "required": ["project_id"], "type": "object"}, "instruction_hint": "Staff desk: list open support tickets for a project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.history", "social.support.transition", "social.support.assign"], "required_cap": "project_support", "safe_action": "social_support_inbox", "summary": "Staff inbox preview list for a project (requires support access).", "title": "Social Support Inbox", "when_to_use": "Staff desk: list open support tickets for a project.", "write_mode": null}, {"action": "social.support.eligibility", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.eligibility", "related_tools": ["social.support.search_projects", "social.support.history"], "source": "overlay", "title": "Social Support Eligibility", "when_to_use": "Batch: which home projects expose support lounge vs private psup."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Batch: which home projects expose support lounge vs private psup.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"projects": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.search_projects", "social.support.history"], "required_cap": "project_support", "safe_action": "social_support_eligibility", "summary": "Batch read: for home project ids the user can access, returns whether end-user private support and/or public Messenger support lounge are enabled (channel id psup_pub_p{pid} when public).", "title": "Social Support Eligibility", "when_to_use": "Batch: which home projects expose support lounge vs private psup.", "write_mode": null}, {"action": "social.support.search_projects", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.search_projects", "source": "overlay", "title": "Social Support Search Projects", "when_to_use": "Find projects the user can contact for support by title query."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Find projects the user can contact for support by title query.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"projects": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "social_read", "safe_action": "social_support_search_projects", "summary": "Search projects the user may contact via support (titles ranked vs query). Returns support entry flags per row.", "title": "Social Support Search Projects", "when_to_use": "Find projects the user can contact for support by title query.", "write_mode": null}, {"action": "social.support.transition", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.transition", "source": "overlay", "title": "Social Support Transition", "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved)."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Staff: move ticket lifecycle status (open/pending/resolved).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ticket": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "safe_action": "social_support_transition", "summary": "Staff: transition a support ticket lifecycle status (requires support desk access).", "title": "Social Support Transition", "when_to_use": "Staff: move ticket lifecycle status (open/pending/resolved).", "write_mode": null}, {"action": "social.support.assign", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.assign", "source": "overlay", "title": "Social Support Assign", "when_to_use": "Staff: assign ticket to staff user id or unassign (null)."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Staff: assign ticket to staff user id or unassign (null).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ticket": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "required_cap": "project_support", "safe_action": "social_support_assign", "summary": "Staff: assign a support ticket to a staff user id (or unassign with null).", "title": "Social Support Assign", "when_to_use": "Staff: assign ticket to staff user id or unassign (null).", "write_mode": null}, {"action": "social.support.request_human", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.mcp.social.gen1"], "id": "social.support.request_human", "related_tools": ["social.support.send", "social.support.history"], "source": "overlay", "title": "Social Support Request Human", "when_to_use": "End user: escalate AI/handoff to human staff on current ticket."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "End user: escalate AI/handoff to human staff on current ticket.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ticket": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.send", "social.support.history"], "required_cap": "project_support", "safe_action": "social_support_request_human", "summary": "End user: request a human handoff for the current ticket (pending when allowed).", "title": "Social Support Request Human", "when_to_use": "End user: escalate AI/handoff to human staff on current ticket.", "write_mode": null}, {"action": "social.support.config.patch", "capability_descriptor": {"complexity": "intermediate", "domain": "social", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.config.patch", "mutation_risk": "low", "related_tools": ["social.support.ai_binding_health", "agents.get"], "source": "overlay", "title": "Social Support Config Patch", "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"config": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.ai_binding_health", "agents.get"], "required_cap": "project_admin", "safe_action": "social_support_config_patch", "summary": "Merge project support config (ai_agent_uuid, ai_mode, entry gates). Owner or admin.", "title": "Social Support Config Patch", "when_to_use": "Bind one project agent as support AI. Do not also set chat triggers on that agent.", "write_mode": null}, {"action": "social.support.ai_binding_health", "capability_descriptor": {"complexity": "simple", "domain": "social", "genetic_tags": ["core.social.support.gen1"], "id": "social.support.ai_binding_health", "related_tools": ["social.support.config.patch", "agents.get"], "source": "overlay", "title": "Social Support Ai Binding Health", "when_to_use": "After social.support.config.patch, confirm the bound agent and mode."}, "domain_title": "Support MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.social.messenger.gen1"], "instruction_hint": "After social.support.config.patch, confirm the bound agent and mode.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.support", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"health": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.social.messenger.gen1", "related_prompts": ["agentstack_project_member_ops", "agentstack_social_messenger", "agentstack_support_staff"], "related_tools": ["social.support.config.patch", "agents.get"], "required_cap": "mcp_read", "safe_action": "social_support_ai_binding_health", "summary": "Read support AI binding health (agent, mode, warnings).", "title": "Social Support Ai Binding Health", "when_to_use": "After social.support.config.patch, confirm the bound agent and mode.", "write_mode": null}], "storage": [{"action": "storage.get_quota", "anti_pattern": "Do not use this for /s/ site files — that is hosting.project.status.", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_quota", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "source": "overlay", "title": "Storage Get Quota", "when_to_use": "Check quota before storage.upload."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Check quota before storage.upload.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "quota": {"description": "object", "type": "any"}, "scope": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.get_project_usage_summary", "projects.get_project"], "required_cap": "storage.read", "safe_action": "storage_get_quota", "summary": "Returns storage quota for the current user or project slice: used/limit bytes, tier_basis (project_owner vs fallback), owner_user_id. Pass project_id or rely on API key / session project. scope=user (", "title": "Storage Get Quota", "when_to_use": "Check quota before storage.upload.", "write_mode": null}, {"action": "storage.get_project_usage_summary", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_project_usage_summary", "related_tools": ["storage.get_quota"], "source": "overlay", "title": "Storage Get Project Usage Summary", "when_to_use": "Dashboards and agents that need project-wide storage consumption."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Dashboards and agents that need project-wide storage consumption.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "project_pool_limit_bytes": {"description": "int", "type": "any"}, "usage": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.get_quota"], "required_cap": "storage.read", "safe_action": "storage_get_project_usage_summary", "summary": "Owner/admin: total permanent/temp bytes across all members and project slice, plus project_pool_limit_bytes from the project billing tier.", "title": "Storage Get Project Usage Summary", "when_to_use": "Dashboards and agents that need project-wide storage consumption.", "write_mode": null}, {"action": "storage.get_hub_summary", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.get_hub_summary", "related_tools": ["storage.get_project_usage_summary"], "source": "overlay", "title": "Storage Get Hub Summary", "when_to_use": "Storage hub overview dashboards and agents."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Storage hub overview dashboards and agents.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "quota": {"description": "object", "type": "any"}, "schema_version": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.get_project_usage_summary"], "required_cap": "storage.read", "safe_action": "storage_get_hub_summary", "summary": "Hub v4 aggregate: permanent/temp totals, hosting bytes, pool cap, sites count.", "title": "Storage Get Hub Summary", "when_to_use": "Storage hub overview dashboards and agents.", "write_mode": null}, {"action": "storage.upload", "aliases": ["storage.put_file", "storage.upload_file"], "anti_pattern": "This action does not upload bytes. POST /api/storage/upload with the multipart contract.", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.upload", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "source": "overlay", "title": "Storage Upload", "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Before attaching binaries — agents upload via REST, not MCP body.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"upload": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.get_quota", "storage.list_files", "storage.delete_file"], "required_cap": "storage.read", "safe_action": "storage_upload", "summary": "Binary upload uses REST POST /api/storage/upload (multipart/form-data). This MCP action returns the contract + quota gate — call storage.get_quota first.", "title": "Storage Upload", "when_to_use": "Before attaching binaries — agents upload via REST, not MCP body.", "write_mode": null}, {"action": "storage.list_files", "aliases": ["storage.files.list", "storage.folders.list", "storage.list"], "anti_pattern": "folder=_ is the root. Omit folder only when you need every folder.", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_files", "related_tools": ["storage.get_quota", "storage.delete_file"], "source": "overlay", "title": "Storage List Files", "when_to_use": "List attachments in project storage scope."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments in project storage scope.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files": {"description": "list", "type": "any"}, "ok": {"description": "bool", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "scope": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.get_quota", "storage.delete_file"], "required_cap": "storage.read", "safe_action": "storage_list_files", "summary": "Lists files in an ecosystem storage folder for the current user or project slice. Pass folder key (use '_' for root) or omit to list all folders (heavy). Set include_folders=1 to return folder_index f", "title": "Storage List Files", "when_to_use": "List attachments in project storage scope.", "write_mode": null}, {"action": "storage.delete_file", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.delete_file", "mutation_risk": "high", "related_tools": ["storage.list_files", "storage.get_quota"], "source": "overlay", "title": "Storage Delete File", "when_to_use": "Remove blob — irreversible."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Remove blob — irreversible.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "project_id": {"description": "int", "type": "any"}, "scope": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.list_files", "storage.get_quota"], "required_cap": "storage.write", "safe_action": "storage_delete_file", "summary": "Deletes a file from ecosystem storage (JSON registry + blob). Requires write access for user scope; owner/admin for project scope.", "title": "Storage Delete File", "when_to_use": "Remove blob — irreversible.", "write_mode": null}, {"action": "storage.scan", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.scan", "related_tools": ["storage.reconcile", "storage.list_files"], "source": "overlay", "title": "Storage Scan", "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "summary": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "safe_action": "storage_scan", "summary": "Project RBAC: compare on-disk files with 8DNA storage registry for the resolved row. scope=user (default) scans caller member row; scope=project scans project slice (user_id=0). Prefer over storage.ad", "title": "Storage Scan", "when_to_use": "Diagnose empty storage UI or disk↔DNA drift before reconcile.", "write_mode": null}, {"action": "storage.reconcile", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.reconcile", "related_tools": ["storage.scan"], "source": "overlay", "title": "Storage Reconcile", "when_to_use": "After storage.scan shows orphans or ghosts."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "conditional_effect": {"dry_run": {"false": "destructive", "true": "evaluate"}}, "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "example_params": {"delete_disk_orphans": true, "dry_run": true, "index_disk_orphans": true, "project_id": 123, "purge_dna_ghosts": true, "recalculate_quota": true, "scope": "example_string"}, "genetic_tags": ["core.mcp.storage.gen1"], "inputSchema": {"properties": {"delete_disk_orphans": {"description": "", "type": "boolean"}, "dry_run": {"description": "Default true", "type": "boolean"}, "index_disk_orphans": {"description": "", "type": "boolean"}, "project_id": {"description": "", "type": "integer"}, "purge_dna_ghosts": {"description": "", "type": "boolean"}, "recalculate_quota": {"description": "", "type": "boolean"}, "scope": {"description": "'user' or 'project' (default user)", "type": "string"}}, "required": [], "type": "object"}, "instruction_hint": "After storage.scan shows orphans or ghosts.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"description": "object", "type": "any"}, "ok": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.scan"], "required_cap": "storage.read", "rollback": [], "safe_action": "storage_reconcile", "summary": "Project RBAC: fix disk↔8DNA drift for the resolved row (dry_run default true). scope=user requires write; scope=project requires owner/admin. Prefer over storage.admin_reconcile for tenants.", "title": "Storage Reconcile", "verification": ["storage.scan"], "verify": [{"action": "storage.scan", "predicate": "named resource is visible"}], "when_to_use": "After storage.scan shows orphans or ghosts.", "write_mode": null}, {"action": "storage.admin_scan", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_scan", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "source": "overlay", "title": "Storage Admin Scan", "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.scan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"ok": {"description": "bool", "type": "any"}, "summary": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.scan", "storage.reconcile", "storage.list_files"], "required_cap": "storage.read", "safe_action": "storage_admin_scan", "summary": "Ecosystem admin (platform hub): compare on-disk files with 8DNA storage registry for (project_id, dna_user_id). Tenants: use storage.scan.", "title": "Storage Admin Scan", "when_to_use": "Cross-tenant operator hub only; tenants use storage.scan.", "write_mode": null}, {"action": "storage.admin_reconcile", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_reconcile", "related_tools": ["storage.reconcile", "storage.scan"], "source": "overlay", "title": "Storage Admin Reconcile", "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Cross-tenant operator hub only; tenants use storage.reconcile.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actions": {"description": "object", "type": "any"}, "ok": {"description": "bool", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.reconcile", "storage.scan"], "required_cap": "storage.read", "safe_action": "storage_admin_reconcile", "summary": "Ecosystem admin (platform hub): fix disk↔8DNA drift for any row. Tenants: use storage.reconcile with scope.", "title": "Storage Admin Reconcile", "when_to_use": "Cross-tenant operator hub only; tenants use storage.reconcile.", "write_mode": null}, {"action": "storage.admin_list_rows", "capability_descriptor": {"complexity": "intermediate", "domain": "admin", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.admin_list_rows", "related_tools": ["storage.admin_scan", "storage.list_files"], "source": "overlay", "title": "Storage Admin List Rows", "when_to_use": "Pick a storage row before admin scan/reconcile or file ops."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Pick a storage row before admin scan/reconcile or file ops.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"items": {"description": "array", "type": "any"}, "ok": {"description": "bool", "type": "any"}, "total": {"description": "int", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "related_tools": ["storage.admin_scan", "storage.list_files"], "required_cap": "storage.read", "safe_action": "storage_admin_list_rows", "summary": "Ecosystem admin: list 8DNA rows with data.ecosystem.storage (project_id, dna_user_id, file counts, bytes).", "title": "Storage Admin List Rows", "when_to_use": "Pick a storage row before admin scan/reconcile or file ops.", "write_mode": null}, {"action": "storage.bind_entity", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.bind_entity", "source": "overlay", "title": "Storage Bind Entity", "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "Link an uploaded file to a CRM deal, contact, or other entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"file": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "required_cap": "storage.read", "safe_action": "storage_bind_entity", "summary": "Attach entity_ref to a storage file card.", "title": "Storage Bind Entity", "when_to_use": "Link an uploaded file to a CRM deal, contact, or other entity.", "write_mode": null}, {"action": "storage.list_by_entity", "capability_descriptor": {"complexity": "intermediate", "domain": "storage", "genetic_tags": ["core.mcp.storage.gen1"], "id": "storage.list_by_entity", "source": "overlay", "title": "Storage List By Entity", "when_to_use": "List attachments for a deal or contact after storage.bind_entity."}, "domain_title": "Storage MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.storage.gen1"], "instruction_hint": "List attachments for a deal or contact after storage.bind_entity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.storage", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"files": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.storage.gen1", "required_cap": "storage.read", "safe_action": "storage_list_by_entity", "summary": "List files bound to an entity_ref.", "title": "Storage List By Entity", "when_to_use": "List attachments for a deal or contact after storage.bind_entity.", "write_mode": null}], "system": [{"action": "system.ping", "aliases": ["discovery.health"], "capability_descriptor": {"complexity": "simple", "domain": "system", "genetic_tags": ["core.mcp.system.gen1"], "id": "system.ping", "source": "overlay", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity."}, "domain_title": "System MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.system.gen1"], "instruction_hint": "Use to verify MCP server connectivity.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.system", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"pong": {"description": "Always true — server is reachable", "type": "any"}, "status": {"description": "Always 'ok'", "type": "any"}, "timestamp": {"description": "ISO 8601 UTC timestamp of the response", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.system.gen1", "safe_action": "system_ping", "summary": "Health check tool — always succeeds, no authentication required.", "title": "System Ping", "when_to_use": "Use to verify MCP server connectivity.", "write_mode": null}], "time": [{"action": "time.log", "capability_descriptor": {"complexity": "intermediate", "domain": "time", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.log", "source": "overlay", "title": "Time Log", "when_to_use": "Record billable or internal minutes on a deal or project."}, "domain_title": "Time MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Record billable or internal minutes on a deal or project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entry": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.time.gen1", "safe_action": "time_log", "summary": "Log a time entry (minutes) optionally linked to crm_deal.", "title": "Time Log", "when_to_use": "Record billable or internal minutes on a deal or project.", "write_mode": null}, {"action": "time.list", "capability_descriptor": {"complexity": "intermediate", "domain": "time", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.list", "source": "overlay", "title": "Time List", "when_to_use": "Audit recent time logs before time.report."}, "domain_title": "Time MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Audit recent time logs before time.report.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"entries": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.time.gen1", "safe_action": "time_list", "summary": "List recent time entries.", "title": "Time List", "when_to_use": "Audit recent time logs before time.report.", "write_mode": null}, {"action": "time.report", "capability_descriptor": {"complexity": "intermediate", "domain": "time", "genetic_tags": ["core.mcp.time.gen1"], "id": "time.report", "source": "overlay", "title": "Time Report", "when_to_use": "Summarize billable minutes for invoicing or goals.progress."}, "domain_title": "Time MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.time.gen1"], "instruction_hint": "Summarize billable minutes for invoicing or goals.progress.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.time", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"billable_minutes": {"description": "integer", "type": "any"}, "entries": {"description": "array", "type": "any"}, "total_minutes": {"description": "integer", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.time.gen1", "safe_action": "time_report", "summary": "Aggregate time report for project.", "title": "Time Report", "when_to_use": "Summarize billable minutes for invoicing or goals.progress.", "write_mode": null}], "user": [{"action": "user.apikeys.create", "aliases": ["apikeys.create_user"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.create", "mutation_risk": "low", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "source": "overlay", "title": "User Apikeys Create", "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor."}, "domain_title": "User Apikeys MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.user_apikeys", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"actor_kind": {"description": "string", "type": "any"}, "api_key": {"description": "string — shown once", "type": "any"}, "key_id": {"description": "string", "type": "any"}, "resource_scope": {"description": "object", "type": "any"}, "service_caps": {"description": "array — explicit L1 allowlist (user keys default to user_full)", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_tools": ["user.apikeys.list", "user.apikeys.revoke", "apikeys.create"], "required_cap": "project_admin", "safe_action": "user_apikeys_create", "summary": "Create a personal AgentStack PAT on the signed-in user (ecosystem identity).", "title": "User Apikeys Create", "when_to_use": "Mint a user or agent PAT for REST/MCP. Prefer agent + agent_runner for Cursor.", "write_mode": null}, {"action": "user.apikeys.list", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.list", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "source": "overlay", "title": "User Apikeys List", "when_to_use": "Audit personal and agent PATs."}, "domain_title": "User Apikeys MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Audit personal and agent PATs.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.user_apikeys", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"count": {"description": "int", "type": "any"}, "keys": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "mcp_read", "safe_action": "user_apikeys_list", "summary": "List personal PATs (metadata only). Optional project_id filters agent keys scoped to that project.", "title": "User Apikeys List", "when_to_use": "Audit personal and agent PATs.", "write_mode": null}, {"action": "user.apikeys.revoke", "aliases": ["user.apikeys.delete"], "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.revoke", "mutation_risk": "high", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "source": "overlay", "title": "User Apikeys Revoke", "when_to_use": "Revoke a leaked or unused PAT."}, "domain_title": "User Apikeys MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Revoke a leaked or unused PAT.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.user_apikeys", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"deleted": {"description": "bool", "type": "any"}, "key_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_tools": ["user.apikeys.create", "user.apikeys.list"], "required_cap": "project_admin", "safe_action": "user_apikeys_revoke", "summary": "Revoke (soft-delete) a personal PAT by key_id.", "title": "User Apikeys Revoke", "when_to_use": "Revoke a leaked or unused PAT.", "write_mode": null}, {"action": "user.apikeys.rotate", "capability_descriptor": {"complexity": "intermediate", "domain": "auth", "genetic_tags": ["core.auth.hub.gen1"], "id": "user.apikeys.rotate", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "source": "overlay", "title": "User Apikeys Rotate", "when_to_use": "Rotate a PAT without changing scope/caps."}, "domain_title": "User Apikeys MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "destructive", "read_only_hint": false, "risk_class": "destructive", "write_mode": false}, "genetic_tags": ["core.auth.hub.gen1"], "instruction_hint": "Rotate a PAT without changing scope/caps.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.user_apikeys", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"api_key": {"description": "string", "type": "any"}, "key_id": {"description": "string", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.auth.hub.gen1", "related_tools": ["user.apikeys.create", "user.apikeys.revoke"], "required_cap": "project_admin", "safe_action": "user_apikeys_rotate", "summary": "Rotate a personal PAT; returns a new secret once.", "title": "User Apikeys Rotate", "when_to_use": "Rotate a PAT without changing scope/caps.", "write_mode": null}], "vertical_demo": [{"action": "vertical_demo.seed_plan", "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_plan", "source": "overlay", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply."}, "domain_title": "Vertical Demo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"plan": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "safe_action": "vertical_demo_seed_plan", "summary": "Dry-run demo seed for vertical workspace.", "title": "Vertical Demo Seed Plan", "when_to_use": "Preview demo CRM/expense seed before vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.seed_apply", "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_apply", "mutation_risk": "low", "source": "overlay", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan."}, "domain_title": "Vertical Demo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Populate showcase demo data after vertical_demo.seed_plan.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"applied": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "safe_action": "vertical_demo_seed_apply", "summary": "Apply demo CRM deals, contacts, expenses, goals.", "title": "Vertical Demo Seed Apply", "when_to_use": "Populate showcase demo data after vertical_demo.seed_plan.", "write_mode": null}, {"action": "vertical_demo.seed_clear", "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.seed_clear", "source": "overlay", "title": "Vertical Demo Seed Clear", "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply."}, "domain_title": "Vertical Demo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"cleared": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "safe_action": "vertical_demo_seed_clear", "summary": "Remove demo-tagged entities.", "title": "Vertical Demo Seed Clear", "when_to_use": "Reset demo seed data before re-applying vertical_demo.seed_apply.", "write_mode": null}, {"action": "vertical_demo.repair_due_dates", "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_demo", "genetic_tags": ["core.mcp.vertical_demo.gen1"], "id": "vertical_demo.repair_due_dates", "source": "overlay", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty."}, "domain_title": "Vertical Demo MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.vertical_demo.gen1"], "instruction_hint": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_demo", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"repaired": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.vertical_demo.gen1", "required_cap": "mcp_read", "safe_action": "vertical_demo_repair_due_dates", "summary": "Set stage-based due_at on CRM deals missing a deadline (idempotent).", "title": "Vertical Demo Repair Due Dates", "when_to_use": "Heal hosted vertical dashboard when projects exist but due-soon is empty.", "write_mode": null}], "vertical_workspace": [{"action": "vertical_workspace.bootstrap", "capability_descriptor": {"complexity": "intermediate", "domain": "vertical_workspace", "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "id": "vertical_workspace.bootstrap", "source": "overlay", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create."}, "domain_title": "Vertical Workspace MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.vertical_workspace.gen1"], "instruction_hint": "One-shot freelancer ops setup right after project create.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.vertical_workspace", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"logic": {"description": "object", "type": "any"}, "persona": {"description": "object", "type": "any"}, "pipeline": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.vertical_workspace.gen1", "related_prompts": ["agentstack_hosted_vertical"], "required_cap": "project_admin", "safe_action": "vertical_workspace_bootstrap", "summary": "Bootstrap vertical workspace after register: CRM pipeline preset, persona leaf, freelancer logic templates (idempotent).", "title": "Vertical Workspace Bootstrap", "when_to_use": "One-shot freelancer ops setup right after project create.", "write_mode": null}], "wallets": [{"action": "wallets.list", "aliases": ["wallets.get"], "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.list", "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "source": "handler", "title": "Wallets List", "when_to_use": "Enumerate wallets before deposit, transfer, or balance check."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "inputSchema": {"properties": {"project_id": {"description": "Project ID (uses context if not provided)", "type": "integer"}, "user_id": {"description": "User ID (required for project_id=1)", "type": "integer"}}, "required": [], "type": "object"}, "instruction_hint": "Enumerate wallets before deposit, transfer, or balance check.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}, "total": {"description": "int", "type": "any"}, "wallets": {"description": "array", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["wallets.create", "payments.get_balance", "wallets.deposit", "wallets.transfer"], "required_cap": "payments", "safe_action": "wallets_list", "summary": "List wallets for a project (and optionally user).", "title": "Wallets List", "when_to_use": "Enumerate wallets before deposit, transfer, or balance check.", "write_mode": null}, {"action": "wallets.create", "aliases": ["wallets.create_wallet", "wallets.ensure", "wallets.update_wallet"], "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.create", "mutation_risk": "low", "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "source": "overlay", "title": "Wallets Create", "when_to_use": "Provision project or user wallet before deposit/transfer."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "low_write", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Provision project or user wallet before deposit/transfer.", "kind": "mcp_domain", "mutation_kind": "entity", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}, "wallet": {"description": "object", "type": "any"}, "wallet_id": {"description": "string - same as wallet.id", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["wallets.list", "wallets.deposit", "payments.get_balance"], "required_cap": "payments", "safe_action": "wallets_create", "summary": "Create a wallet for a project or user.", "title": "Wallets Create", "tool_chains": ["project_bootstrap", "economy_setup", "economy_setup"], "when_to_use": "Provision project or user wallet before deposit/transfer.", "write_mode": null}, {"action": "wallets.deposit", "aliases": ["wallets.top_up"], "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.deposit", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "source": "overlay", "title": "Wallets Deposit", "when_to_use": "Credit wallet balance (admin or test funding)."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Credit wallet balance (admin or test funding).", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"currency": {"description": "string", "type": "any"}, "message": {"description": "string", "type": "any"}, "new_balance": {"description": "number", "type": "any"}, "success": {"description": "bool", "type": "any"}, "transaction": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["wallets.list", "payments.get_balance", "wallets.transfer"], "required_cap": "payments", "safe_action": "wallets_deposit", "summary": "Deposit funds to a wallet.", "title": "Wallets Deposit", "tool_chains": ["project_bootstrap", "economy_setup"], "when_to_use": "Credit wallet balance (admin or test funding).", "write_mode": null}, {"action": "wallets.transfer", "aliases": ["assets.transfer"], "capability_descriptor": {"complexity": "intermediate", "domain": "wallets", "genetic_tags": ["core.mcp.wallets.gen1"], "id": "wallets.transfer", "mutation_risk": "low", "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "source": "overlay", "title": "Wallets Transfer", "when_to_use": "Move funds between wallets in the same project."}, "domain_title": "Remaining MCP domain", "effect": {"audit_side_effect": false, "batch_safe": false, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": true, "generation": false, "generation_plane": false, "kind": "mutate", "read_only_hint": false, "risk_class": "financial", "write_mode": false}, "genetic_tags": ["core.mcp.scheduler.gen1"], "instruction_hint": "Move funds between wallets in the same project.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.remaining", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"from_transaction": {"description": "object", "type": "any"}, "message": {"description": "string", "type": "any"}, "success": {"description": "bool", "type": "any"}, "to_transaction": {"description": "object", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.scheduler.gen1", "related_prompts": ["agentstack_tenant_subscription_monetization"], "related_tools": ["wallets.list", "payments.get_balance", "payments.create"], "required_cap": "payments", "safe_action": "wallets_transfer", "summary": "Transfer funds between wallets (same project).", "title": "Wallets Transfer", "when_to_use": "Move funds between wallets in the same project.", "write_mode": null}], "web_push": [{"action": "web_push.get_health", "capability_descriptor": {"complexity": "simple", "domain": "notifications", "genetic_tags": ["core.mcp.notifications.gen1"], "id": "web_push.get_health", "source": "overlay", "title": "Web Push Get Health", "when_to_use": "Per-user Web Push VAPID + delivery readiness."}, "domain_title": "Notifications MCP domain", "effect": {"audit_side_effect": false, "batch_safe": true, "budget": "cheap", "effect_depends_on_params": false, "execution_class": "cheap", "external_side_effect": false, "generation": false, "generation_plane": false, "kind": "read", "read_only_hint": true, "risk_class": "read", "write_mode": false}, "genetic_tags": ["core.mcp.notifications.gen1"], "instruction_hint": "Per-user Web Push VAPID + delivery readiness.", "kind": "mcp_domain", "mutation_kind": "none", "onboarding_tier": "domain_playbook", "organ_id": "mcp.notifications", "outputSchema": {"properties": {"data": {"description": "Response data object", "properties": {"health": {"description": "object", "type": "any"}, "success": {"description": "boolean", "type": "any"}}, "type": "object"}, "error": {"description": "Error message if operation failed", "nullable": true, "type": "string"}, "error_code": {"description": "Error code for programmatic error handling", "nullable": true, "type": "string"}, "execution_time_ms": {"description": "Execution time in milliseconds", "nullable": true, "type": "number"}, "success": {"description": "Whether the operation was successful", "type": "boolean"}, "trace_id": {"description": "Trace ID for debugging", "nullable": true, "type": "string"}}, "type": "object"}, "owner_gene": "core.mcp.notifications.gen1", "related_prompts": ["agentstack_channel_setup"], "required_cap": "mcp_read", "safe_action": "web_push_get_health", "summary": "Per-user Web Push health (same payload as GET /api/push/health): VAPID, canDeliver, subscription/outbox counts, process-local worker stats.", "title": "Web Push Get Health", "when_to_use": "Per-user Web Push VAPID + delivery readiness.", "write_mode": null}]}, "entrypoint": "agentstack.execute", "execute_budget": {"agents_run_wait_is_heavy": true, "async": {"enable": "options.async=true", "lease_ms": 1200000, "poll_action": "discovery.job_status", "poll_rest": "GET /mcp/jobs/{job_id}"}, "cpu_heavy_actions": ["agents.plan_apply_proposal", "agents.plan_propose", "agents.plan_recovery_scan", "context.get"], "heavy_actions": ["bots.simulate", "knowledge.playground"], "heavy_prefixes": ["ai_builder.generate", "media.generate"], "max_steps": 50, "max_sync_heavy_actions": 1, "rule": "One expensive action per sync agentstack.execute (LLM-heavy or CPU-heavy). Cheap actions may share the 60s batch. Do not pack six bots.simulate into one execute.", "single_heavy_lane": "ai_stream", "single_heavy_lane_ms": 180000, "single_heavy_timeout_ms": 180000, "sync_lane": "mcp_batch", "sync_lane_ms": 60000, "timeout_ms": 60000}, "mcp_executable_total": 756, "rest_catalog_total": 39, "schemas_mode": "hot", "total_actions": 795, "version": "2.0", "write_modes": {"doc": "agentstack-core/mcp/WRITE_MODES.md", "errors": {"commands_empty_blocked": "Refusing to wipe bot_spec.commands to [].", "content_shrink_blocked": "New KB body is much shorter than the indexed doc; pass allow_shrink.", "prompt_shrink_blocked": "New plan_instructions / system_preamble is much shorter than the stored field. GET knowledge.prompt.get and send the full string, or write_mode=append, or allow_shrink=true.", "use_path_updates": "Partial agent_spec with write_mode=merge requires path_updates.", "write_mode_invalid": "Unknown write_mode token.", "write_mode_unsupported": "This payload cannot use that mode (e.g. merge on markdown body)."}, "modes": {"append": "Document body: concatenate after the existing joined text.", "delete": "Explicit remove of named keys/items (incoming = delete set). A short replace list is never treated as delete.", "merge": "PATCH / protein merge_keyed: overlay by key (trigger, uid). Never drops siblings missing from the payload.", "patch": "Alias of merge (REST PATCH / path_updates / OperationType.DELTA).", "prepend": "Document body: concatenate before the existing joined text.", "replace": "PUT snapshot: incoming list/body is the full new value. Studio command Publish uses this. Empty collection is blocked.", "upsert": "Merge plus insert missing keys. Same as merge for bot commands.", "write": "Alias of replace (full document body)."}, "mutation_kinds": {"body": "Document text: write_mode replace|append|prepend.", "collection": "Keyed list: write_mode merge|upsert|replace|delete.", "entity": "CRUD verb in the action name (.create/.update/.delete). No write_mode.", "none": "Read-only or no collection/body/path payload.", "path": "One PathAtom / DNA leaf: projects.patch_data or path_updates."}, "param": "write_mode", "prompt": "agentstack_write_modes", "protein": {"diff_op_kinds": ["set", "delete", "merge_keyed", "upsert_entity"], "operation_type": ["get", "create", "update", "delete", "delta"]}, "required_when": "Writing a collection (bot commands, keyed lists), a document body (knowledge.content.patch text), or a prompt field (knowledge.prompt.patch plan_instructions / system_preamble). Metadata-only patches may omit it. Path writes use projects.patch_data (REST PATCH /projects/{id}/data).", "rest": {"DELETE": "delete (dedicated route or write_mode=delete)", "If-Match": "lost-update guard (CRM stage, social chat index)", "PATCH": "merge / path_updates / protein DELTA / PATCH /projects/{id}/data", "PUT": "replace snapshot"}, "rule": "Always pass write_mode for collection/body writes. Omitting it infers a safe default (merge a partial command list; replace a KB body or prompt field with a shrink guard). Never send one command, one markdown section, or a 7-line plan_instructions stub as a full replace. Nested project.data leaves: projects.patch_data, not projects.update_project.", "tools": {"agents.update": "section and path_updates default to merge (objects merge, lists replace). write_mode=replace sets the section or leaf wholesale. A full agent_spec without section/path_updates is a replace. write_mode=merge with only a partial agent_spec is rejected.", "bots.commands.upsert": "Always merge-by-trigger; never replaces the menu.", "bots.reset_message_quota": "path", "bots.update": "Pass write_mode with commands. Prefer bots.commands.upsert for one command.", "checklist.set": "checklist.set replaces the full items list — write_mode defaults to replace.", "hosting.bucket.file.get": "Read UTF-8 text + content_sha256 (≤2MB) when you need the bytes. search_replace does not require this first. Use bucket_name or bucket_id (same resolver as hosting.files.put).", "hosting.bucket.file.patch": "search_replace does not need a prior GET. write_mode: replace|append|prepend|unified_diff|search_replace — not storage.upload. Omit bucket_id on the primary site. Identical bytes skip the write and gzip. A real change refreshes the .gz sibling. Do not delete it. Pass expected_sha256 when you have it. A mismatch writes nothing.", "hosting.deploy_files": "Batch publish many paths (≤50/call). Not for single CSS line — use file.patch. After publish poll hosting.site.edge_health.", "hosting.files.put": "Full-file PUT for one path. A small text edit is hosting.bucket.file.patch, not a GET and not dry_run. Not storage.upload — this writes the live site bucket tree.", "knowledge.config.patch": "body", "knowledge.content.patch": "text is a full body unless write_mode=append|prepend. GET the document first; shrinking a long body needs allow_shrink=true. SDK Studio sets allow_shrink for operator save — AI must GET first.", "knowledge.policy_templates.apply": "body", "knowledge.prompt.patch": "omit-unset keeps unsent keys only. A sent plan_instructions / system_preamble replaces that entire string. GET first; write_mode=append for a new bullet; stub replace → prompt_shrink_blocked.", "logic.update": "triggers/space/schedulers are keyed lists: pass write_mode. Prefer path_updates for one node.", "preflight.check": "path", "projects.patch_data": "Leaf path SET (REST PATCH /projects/{id}/data). write_mode=replace sets the path; merge overlays an object; delete removes it.", "projects.patch_my_data": "collection", "projects.put_notify_policy": "path", "social.chat.index_put": "Exception: subset-as-delete with If-Match. A short list can drop missing keys. Do not apply bots-style merge defaults here."}}}