Understand Error Handling for MCP Server Development (Preview)

This topic contains the error response structure and common error codes that you need to understand when developing for the Oracle Analytics Cloud MCP server.

Error Response Structure

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Query execution failed",
    "data": {
      "errorCode": "OBIPS-E3004",
      "details": "Invalid column reference"
    }
  }
}

Common Error Codes

Code	Name	Cause
-32700	Parse error	Invalid JSON.
-32600	Invalid request	Missing required fields.
-32601	Method not found	Unknown tool name.
-32602	Invalid params	Parameter validation failed.
-32000	Server error	Oracle Analytics Cloud query execution failure.

Oracle Analytics Cloud Specific Error Codes

Code	Name	Cause
nQSError: 27037	Unresolved level	Use two-part naming in AGO/TODATE.
nQSError: 10058	Invalid column	Verify column exists via describe_data.
nQSError: 43113	Syntax	Check query syntax.