This section describes the possible error responses returned when an agent invokes MCP tools, including general authentication errors and tool-specific failures.
| Error Code | Description |
|---|
| UNAUTHORIZED | The API key is invalid or missing. |
| API_KEY_MISSING | The Authorization header is not provided in the request. |
| API_KEY_INVALID | The API key format is incorrect or does not exist. |
| API_KEY_UNAVAILABLE | The API key has been disabled. |
| Error Code | Description |
|---|
| INVALID_AMOUNT | The amount exceeds the allowed limit or is negative. |
| UNSUPPORTED_CURRENCY | The currency parameter is not supported. |
| UNSUPPORTED_CHAIN | The chain parameter is not supported. |
| CARD_ISSUANCE_PENDING | A previous card issuance request is still pending, or the issuance lock could not be acquired. |
| PARAM_INVALID | Parameter validation failed during the card issuance workflow. |
| OPENAPI_ERROR | Failed to query the Interlace wallet or create a deposit address. |
| Error Code | Description |
|---|
| CARD_NOT_FOUND | No card with status ACTIVE exists for the current account. |
| CARD_QUERY_FAILED | Failed to retrieve card details or balance from the Interlace system. |
| Error Code | Description |
|---|
| CARD_NOT_FOUND | No card with status ACTIVE exists for the current account. |
| INVALID_LIMIT | The limit parameter is outside the allowed range (1–100). |
| TRANSACTION_QUERY_FAILED | Failed to retrieve the transaction list from the Interlace system. |
| Error Code | Description |
|---|
| CARD_NOT_FOUND | No deletable card exists for the current account. |
| CARD_DELETE_FAILED | Failed to acquire the deletion lock or call the Interlace card deletion API. |
| Error Code | Description |
|---|
| PARAM_INVALID | The address is empty or the transferId is missing. |
| NO_REFUNDABLE_TRANSACTION | No ONHOLD transactions are available for refund. |
