Set up the LLM Client and MCP Server JSON-RPC Interface (Preview)

JSON-RPC is a lightweight remote procedure call (RPC) protocol that uses JSON to encode messages. It is how information is exchanged between the LLM client and the Oracle Analytics Cloud MCP Server.

Protocol Version

{ "jsonrpc": "2.0" }

Initialize Connection

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "AI Agent",
      "version": "1.0.0"
    }
  }
}

Expected Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "prompts": { "listChanged": true },
      "resources": { "subscribe": false, "listChanged": true },
      "tools": { "listChanged": true }
    },
    "serverInfo": {
      "name": "Oracle Analytics MCP Server",
      "title": "Oracle Analytics MCP Server",
      "version": "1.0.0"
    }
  }
}

List Available Tools

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call Tool

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "oracle_analytics-discover_data",
    "arguments": { "fetchType": "all" }
  }
}