Opscotch

Generate a minimal Opscotch workflow file skeleton. Use this when starting a new workflow.json file.

opscotch_generate_json_workflow_file

Generate a minimal Opscotch workflow processor skeleton.

opscotch_generate_json_workflow_processor

Generate a minimal Opscotch workflow step skeleton.

opscotch_generate_json_workflow_step

Generate a minimal Opscotch workflow trigger skeleton.

opscotch_generate_json_workflow_trigger

Generate a minimal Opscotch workflow object skeleton for a workflow file.

opscotch_generate_json_workflow_workflow

Generate a usable Docker command for starting the Opscotch Local Development MCP server. Requires an available host port and the absolute host path to the workspace root. OPSCOTCH_LEGAL_ACCEPTED may be omitted only when it is already set in the shell environment where the returned command will be run; otherwise pass legalAccepted so the generated command includes it.

opscotch_generate_local_development_server_docker_command

Return a named context object from the API reference index including functions. Pass the context name and function name into get-context-function to get function and variant details. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_get_context

Return a named function from a named API reference context. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_get_context_function

Return all functions for a named API reference context with signatures, return types, and examples. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_get_context_function_signatures

Fetch the source text for a selected community example returned by `lookup_examples`, `get_related_examples`, or `list_example_files`. Pass the example `id` when available; pass `path` only for direct navigation.

opscotch_get_example

Retrieve Opscotch guidance for designing and building workflows. Users may also refer to this guidance as a "skill" or "prompt". If no role is supplied, return `system` guidance. Use this first before generating or modifying workflows. For make, design, or plan requests, MUST call `role=system` first to bootstrap behavior, then MUST call `role=architect` before drafting, then MUST call `role=engineer` before implementation. Supports roles: architect, engineer, system. Do not assume knowledge. Do not invent undocumented request/response APIs, ambient variables, processor return-value conventions, or transport syntax. Always retrieve information using this tool when needed.

opscotch_get_guidance

Retrieve common Opscotch workflow patterns. Use this when designing workflows to reuse proven structures. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_get_patterns

Return indexed examples related to a selected example id, such as paired workflow, bootstrap, JavaScript resources, and tests. Use this before fetching source when you want to choose the most relevant companion file.

opscotch_get_related_examples

Retrieve JSON schema definitions for Opscotch workflows, bootstrap configurations, test runner tests, and test runner configurations. Use this when validating or constructing Opscotch JSON. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_get_schema

Return the API reference context index. This is the first step in JavaScript context and function discovery. Pass the context name into get-context. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_list_context

List files beside a selected community example or inside a community-root-relative directory. Use this after `lookup_examples` to navigate sibling workflow, bootstrap, resource, test, and README files.

opscotch_list_example_files

Search Opscotch API functions, schemas, and workflow patterns by query text when you do not yet know which exact pattern, schema, context, or function applies. Optionally filter by lookupType (`function`, `schema`, `pattern`) and scope to a single context for function matches. Valid contextName values: `AgentControlContext`, `AuthenticationJavascriptContext`, `ByteContext`, `CryptoContext`, `DiagnosticsContext`, `FilesContext`, `JavascriptContext`, `JavascriptStateContext`, `LicensingContext`, `PersistentQueueContext`. Use this as the discovery step before calling more specific tools. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_lookup

Return community examples for an exact Opscotch domain term. Use this after identifying a real schema property such as `deploymentAccess` or JavaScript API function such as `sendToStep`; this is not a general natural-language search tool.

opscotch_lookup_examples

This tool resolves what the 'context' object will be in a javascript processor. Supported processors: authenticationProcessor, splitGenerator, urlGenerator, payloadGenerator, itemResultProcessor, resultsProcessor, httpConnectFailedProcessor. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_resolve_operational_context

Return first-contact guidance for clients unfamiliar with this Opscotch MCP server. Use this before other tools when you need orientation on what this server is for and which Opscotch tools to call next.

opscotch_start_here

Validate bootstrap error handling settings against the standalone Opscotch bootstrap error handling schema. Use after drafting error-handling configuration, then fix and re-run until valid before embedding it in bootstrap. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_errorhandling

Validate a full bootstrap file against the root Opscotch bootstrap schema. Use after assembling the full bootstrap document, then fix and re-run until valid before returning it. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_file

Validate a bootstrap host record against the standalone Opscotch bootstrap host schema. Use after drafting an allowed host entry, then fix and re-run until valid before embedding it in bootstrap. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_host

Validate a bootstrap key against the standalone Opscotch bootstrap key schema. Use after drafting a key record, then fix and re-run until valid before embedding it in bootstrap. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_key

Validate bootstrap packaging settings against the standalone Opscotch bootstrap packaging schema. Use after drafting package trust settings, then fix and re-run until valid before returning the bootstrap. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_packaging

Validate a single bootstrap record against the standalone Opscotch bootstrap record schema. Use while drafting deployment records, then fix and re-run until valid before assembling the full bootstrap file. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_record

Validate bootstrap workflow settings against the standalone Opscotch bootstrap workflow schema. Use after drafting bootstrap workflow settings, then fix and re-run until valid before embedding them in a bootstrap record. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_bootstrap_workflow

Validate a processor object against the standalone Opscotch processor schema. Use while building processors incrementally, then fix and re-run until valid before embedding them in a step. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_processor

Validate a step object against the standalone Opscotch step schema. Use after composing a step from trigger and processor parts, then fix and re-run until valid before returning it. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_step

Validate an Opscotch test runner configuration against the test runner schema. Use after drafting or editing runner configuration, then fix and re-run until valid before returning it.

opscotch_validate_testrunner

Validate an Opscotch test runner test configuration against the test schema. Use after drafting or editing a test configuration, then fix and re-run until valid before returning it.

opscotch_validate_test

Validate a trigger object against the standalone Opscotch trigger schema. Use after choosing a trigger shape, then fix and re-run until valid before embedding it in a step or workflow. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_trigger

Validate a single workflow object against the standalone Opscotch workflow schema. Use after drafting or editing a workflow object, then fix and re-run until valid before returning it. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_workflow

Validate a full workflow file against the root Opscotch workflow schema. Use after assembling the full workflow document, then fix and re-run until valid before returning it. Do not assume knowledge. Always retrieve information using this tool when needed.

opscotch_validate_workflow_file