Wire tools and state

For questions about input collection, defaults, captures, references, or state behavior that this skill does not answer, follow the docs MCP workflow before answering or implementing. For every new Voiceflow troubleshooting issue, consult it even when this skill suggests a fix. Include package/skill/stage context in why as described there. Reuse guidance for the same issue; consult it whenever unsure.

Read the operation contract. Inspect the resource declarations and the specific attachment using them. Tool definitions, attachments, and project variables are different resources. Read attachment request shapes when creating a binding or diagnosing an invalid target/capture payload.

For function inputs, key inputVariables by the declared input UUID, with the same functionInputVariableID inside. For API tool inputs use apiToolInputVariableID. Do not key by a friendly name merely because an existing attachment does.

A defaultValue can bind a project variable or secret by name. Check unresolvedReferences after writes. Secret values belong in the secure Voiceflow UI/connection flow, never chat or source code. Leave collection disabled for secret-bound inputs according to the live schema.

Agent collection and defaults are distinct. Disable collection only when a reliable default/setter exists on every incoming path; otherwise an empty value may silently reach the integration. A default alone does not prove a value is available.

Capture outputs explicitly into the intended project variable IDs. Output text visible to the model is not persistent state. Each attachment has independent bindings; changing one does not configure every playbook using the same tool.

Order dependent tool calls. Do not assume two calls in one parallel batch see each other's captured writes. Re-read after UI edits if captures appear lost.

Prefer the smallest relevant inspection over sweeping the whole project. Verify UUIDs, WHAT + WHEN descriptions, references, captures, and route coverage before running anything.

Source: References.

---
name: voiceflow-wiring
description: Connect Voiceflow function/API tool inputs, secrets, captured outputs, and project variables; diagnose empty values or incorrect tool bindings.
license: MIT
---