JSON-RPC Shape (Preview)

All tools are called through the MCP tools/call method.

Note:

Most users of MCP-enabled clients, such as Claude Desktop or Codex, don't need to construct JSON-RPC requests manually. These clients translate natural language prompts into the appropriate MCP tool calls automatically. This topic is for developers who are building custom AI applications or MCP clients and need to understand the underlying JSON-RPC request and response format.

An example of the general request shape is:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "oracle_analytics-describe_data",
    "arguments": {
      "datamodelName": "Sales History Subject Area",
      "tablesOnly": true
    }
  }
}

In MCP JSON-RPC, the name value must be the raw MCP tool name, including the hyphen.