# Barvinca MCP error reference [← MCP connection guide](/help/mcp.md) Tool errors preserve a human-readable next step and include `_meta["barvinca/error"]` with the stable code, exact required scopes, retryability, and this anchored help URL. Never send tokens, authorization URLs, or request bodies to support. ## Installer exits ## Installer exit 2 Correct invalid or conflicting flags and provide an explicit client. ## Installer exit 3 Inspect the same-name collision. The installer intentionally made no replacement. ## Installer exit 4 Install the selected native client or required prerequisite, then retry. ## Installer exit 5 Complete OAuth login or repair transport, then rerun --check. ## Installer exit 6 Repair permissions or malformed configuration; the installer refused an unsafe read or write. ## Tool errors ## `unauthorized` Sign in to Barvinca again, then reconnect the native client with fresh OAuth consent. ## `insufficient_scope` Reconnect and explicitly approve the required scopes shown in the structured error metadata. ## `session_expired` Sign in to Barvinca again, then reconnect the native client with fresh OAuth consent. ## `mcp_grant_inactive` Sign in to Barvinca again, then reconnect the native client with fresh OAuth consent. ## `account_forbidden` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `project_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `invalid_cursor` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_project_id` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_resource_id` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_domain` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_format` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `export_unavailable` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `autodesk_authorization_required` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `autodesk_access_forbidden` Confirm Autodesk authorization, project/domain availability, and the Barvinca Custom Integration before retrying. ## `autodesk_rate_limited` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `autodesk_unavailable` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `autodesk_request_failed` Confirm Autodesk authorization, project/domain availability, and the Barvinca Custom Integration before retrying. ## `autodesk_response_invalid` Confirm Autodesk authorization, project/domain availability, and the Barvinca Custom Integration before retrying. ## `autodesk_response_too_large` Confirm Autodesk authorization, project/domain availability, and the Barvinca Custom Integration before retrying. ## `acc_issues_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `acc_rfis_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `acc_assets_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `acc_submittals_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `acc_forms_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `acc_form_templates_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `issue_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `rfi_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `asset_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `submittal_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `invalid_email` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_company_name` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_role_name` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_action` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_operation_id` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_source_operation_id` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `operation_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `source_operation_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `source_operation_is_preflight` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `source_operation_not_terminal` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `unsupported_source_action` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `no_retryable_items` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `no_rollback_items` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `derived_preflight_too_large` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `invalid_status` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_limit` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_items` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_item` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `duplicate_item` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_idempotency_key` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `idempotency_conflict` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `role_required` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_role` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_role_ids` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_products` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_platform` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `custom_integration_required` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `platform_credentials_missing` Confirm Autodesk authorization, project/domain availability, and the Barvinca Custom Integration before retrying. ## `integration_check_failed` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `tool_not_entitled` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. ## `authentication_required` Sign in to Barvinca again, then reconnect the native client with fresh OAuth consent. ## `preflight_failed` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `invalid_preflight_id` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `invalid_approval_digest` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `preflight_not_found` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `preflight_not_ready` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `approval_digest_mismatch` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `approval_expired` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `no_actionable_items` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `durable_executor_unavailable` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `audit_persistence_failed` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `creds_reservation_failed` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `workflow_dispatch_failed` Do not bypass the preflight boundary. Inspect the operation, then follow the exact next step returned by Barvinca. ## `execution_recovery_required` Correct the bounded input described in the tool result, then retry. Never invent IDs; use values returned by a list or preflight tool. ## `operation_not_cancellable` Refresh the relevant list or operation record and choose a currently eligible item or operation. ## `workflow_termination_failed` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `cancellation_persistence_failed` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `creds_reconciliation_failed` This error is retryable. Wait briefly, then retry the same safe request without changing identifiers or approval data. ## `internal_error` Retry once. If the error persists, record only this code and the time window when contacting Barvinca support. --- Canonical HTML: https://barvinca.com/help/mcp/errors