Barvinca MCP error reference
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
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.
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_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.
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.