apex-mcp chart tools are built on Oracle JET (JavaScript Extension Toolkit), Oracle’s open-source UI component library. All chart regions use the native APEXDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/TechFernandesLTDA/apex-mcp/llms.txt
Use this file to discover all available pages before exploring further.
NATIVE_JET_CHART engine — no external libraries, no CDN dependencies. Charts inherit your Universal Theme 42 color palette, font settings, and accessibility features, and are rendered server-side as APEX Import Script declarations, making them safe for all APEX 24.2 deployment environments.
Every chart tool creates an APEX_REGION plug (the container), a JET_CHART config record, one or more JET_CHART_SERIES records, and (for non-pie types) JET_CHART_AXIS records for the X and Y axes.
SQL Aliasing Requirements
All chart SQL queries must use specific column aliases for apex-mcp to correctly wire up the JET chart series configuration. Using the wrong alias name is the most common source of empty or broken charts.
You can override default alias names with the
| Chart type | Required aliases |
|---|---|
| Bar, bar_horizontal, line, area, funnel | LABEL (X-axis / category), VALUE (Y-axis / magnitude) |
| Gauge / dial | VALUE (single numeric value) |
| Stacked, combo | LABEL, VALUE per series (each series has its own SQL) |
| Scatter plot | X (horizontal — mapped to label_column), Y (vertical — mapped to value_column); use apex_add_scatter_plot for named X/Y/LABEL columns |
| Range chart | LABEL, LOW (minimum), HIGH (maximum) |
| Bubble chart | X, Y, Z (bubble size), optional LABEL |
| Pareto chart | LABEL, VALUE (bars, ordered DESC — cumulative % line is auto-computed) |
label_column, value_column, etc. parameters where available.Core JET Charts
apex_add_jet_chart
Add an Oracle JET chart region to a page. Supports bar, line, area, pie, donut, and combo types. This is the primary chart tool; all advanced chart tools delegate to it internally.
Target page ID. Must already exist in the session.
Region title shown in the APEX page.
Chart style. Accepted values:
bar— vertical bar chartbar_horizontal— horizontal bar chartline— line chart (good for trends over time)area— filled area chart (good for cumulative data)pie— pie chart (distribution, no axes)donut— donut chart (distribution with center hole)combo— bar + line on the same chart (add line series viaextra_series)scatter— scatter plot (uselabel_columnfor X,value_columnfor Y)
SQL returning at least two columns. Default aliases:
LABEL (X-axis) and VALUE (Y-axis).Column name used for X-axis categories / pie slices.
Column name used for Y-axis values / slice sizes.
Display name for the data series (shown in legend and tooltip). Defaults to
region_name.Chart height in pixels.
Optional Y-axis label.
Optional X-axis label.
Where to show the legend:
end (right), top, bottom, start (left), auto.vertical or horizontal. For bar charts only; bar_horizontal sets this automatically.Region display order on the page.
Additional data series for multi-series charts. Each object:
Optional list of hex color strings for chart series, e.g.
["#00995D","#1e88e5"]. Accepted for API compatibility — color palette application depends on APEX 24.2 theme settings.apex_add_gauge
Add a JET dial gauge chart. Ideal for KPI scores, completion rates, SLA metrics, and health indicators. Renders as a circular dial with colored threshold zones.
Target page ID.
Region title.
SQL returning a single numeric value.
Column name with the gauge value.
Minimum scale value.
Maximum scale value.
List of threshold zone dicts. Each object:
{"value": 33, "color": "#e53935"}.
If omitted, defaults to three zones: red (0–33%), orange (33–66%), green (66–100%).Gauge height in pixels.
Region display order on the page.
Optional single hex color for the gauge needle/fill (e.g.,
"#00995D"). Accepted for API compatibility.apex_add_funnel
Add a JET funnel chart. Perfect for visualizing pipeline stages, approval flows, or conversion steps. Each SQL row represents one funnel stage.
Target page ID.
Region title.
SQL ordered from largest to smallest stage.
Column for stage labels.
Column for stage values.
Display name for the data series shown in the legend. Defaults to
region_name.Chart height in pixels.
Region display order on the page.
Optional list of hex colors per stage. Accepted for API compatibility.
apex_add_sparkline
Add metric cards with inline sparkline trend bars. Each card shows a title, current value, and a mini 7-bar trend chart rendered entirely in PL/SQL.
Target page ID.
Region name.
List of metric definitions. Each object:
trend_sql must return a VALUE column (up to 7 rows).Number of columns in the card grid (2–4).
apex_add_metric_cards
Add modern KPI metric cards with animated count-up numbers, icons, and optional drill-down links. Rendered as a NATIVE_PLSQL region — no external libraries required.
Target page ID.
Region name (hidden by default).
List of metric definitions. Each object:Named colors:
blue, green, orange, red, purple, teal, indigo, amber. Auto-assigned if omitted.Grid columns (2, 3, 4, or 6).
Visual style:
gradient (colored gradient background), white (white card with accent border), dark (dark card with neon accent).apex_add_calendar
Add a CSS Calendar region (NATIVE_CSS_CALENDAR) to a page. Supports month, week, day, and list views.
Target page ID.
Region title.
SQL returning event data. Must include the
date_column and title_column at minimum.Column name for the event start date/datetime.
Column name for the event title.
Optional column for event end date/datetime (enables multi-day events).
Default view:
month, week, day, or list.Advanced Chart Types
The following 10 tools fromchart_tools.py extend the core JET chart engine with specialized configurations.
apex_add_stacked_chart
Add a stacked bar or area chart with multiple SQL-driven series. Each series stacks on top of the previous — ideal for showing composition across categories.
Each series has its own SQL query and must return
LABEL and VALUE columns (or use custom label_column/value_column per series). All series must share the same X-axis category labels for the stacking to align correctly.Target page ID.
Region display name.
List of 1–10 series objects. Each:
bar or area.Chart height in pixels.
Y-axis label.
X-axis label.
Region display order on the page.
Enable zoom on chart axes.
Enable scroll on the chart.
Animation style:
auto, none, fade, or zoom.List of hex colors for series (e.g.,
["#00995D","#1e88e5"]).apex_add_combo_chart
Add a combo chart with bars on the primary (left) Y-axis and a line on the secondary (right) Y-axis. Bar and line series can have different scales — ideal for volume vs. rate/percentage analysis.
bar_sql must return LABEL and VALUE (or use bar_label_col/bar_value_col).
line_sql must return LABEL and VALUE (or use line_label_col/line_value_col).
Both queries must produce the same X-axis category labels for alignment.Target page ID.
Region display name.
SQL for the bar series (left Y-axis).
SQL for the line series (right Y-axis).
Legend label for bars.
Legend label for the line.
X-axis column name in
bar_sql.Left Y-axis column name in
bar_sql.X-axis column name in
line_sql.Right Y-axis column name in
line_sql.Left Y-axis label.
Right Y-axis label.
Chart height in pixels.
Region display order on the page.
Enable zoom on chart axes.
Enable scroll on the chart.
Animation style:
auto, none, fade, or zoom.apex_add_pareto_chart
Add a Pareto / 80-20 chart: descending bars (primary Y-axis) plus an auto-computed cumulative percentage line (secondary Y-axis). SQL should be ordered by value DESC.
SQL must return
LABEL and VALUE columns, ordered by VALUE DESC. The cumulative percentage line is computed automatically via a window function unless you provide cumulative_sql.Target page ID.
Region display name.
SQL returning
LABEL and VALUE, ordered DESC.Column for categories.
Column for numeric values.
Legend label for bars.
Legend label for the cumulative line.
Chart height in pixels.
Region display order on the page.
Enable zoom on chart axes.
Enable scroll on the chart.
Animation style:
auto, none, fade, or zoom.Custom SQL for the cumulative % line. Must return the same label column and a
VALUE column. When omitted, the cumulative % is auto-computed via a window function.apex_add_scatter_plot
Add a scatter plot to visualize correlation between two numeric variables. Each point shows X vs Y position with a label in the tooltip.
SQL must return
X (horizontal) and Y (vertical) numeric columns, plus an optional LABEL column for tooltip display. Override defaults with x_column, y_column, label_column parameters.Target page ID.
Region display name.
SQL returning
X, Y, and optionally LABEL.Column for X-axis numeric values.
Column for Y-axis numeric values.
Column for data-point tooltip labels.
Legend label for the data series.
X-axis label.
Y-axis label.
Region display order on the page.
apex_add_range_chart
Add a range (high-low) chart that shows min/max bands over categories. Useful for score variance, confidence intervals, or min/max per period.
SQL must return
LABEL, LOW (minimum), and HIGH (maximum) columns. Override defaults with label_column, low_column, high_column.Target page ID.
Region display name.
SQL returning label, low, and high columns.
Column for X-axis labels.
Column for minimum values.
Column for maximum values.
Legend label for the data series.
Y-axis label.
Region display order on the page.
apex_add_area_chart
Add a multi-series area chart. Pass stacked=True (default) for composition views, or stacked=False for overlapping areas.
Each series dict must have
name and sql keys. SQL must return LABEL and VALUE columns.Target page ID.
Region display name.
List of series objects, each with
name and sql. Each series SQL must return LABEL and VALUE columns.Stack series (composition view) or overlay.
Chart height in pixels.
Y-axis label.
X-axis label.
Region display order on the page.
apex_add_animated_counter
Add a count-up animated number display. The value is fetched from SQL at render time, then JavaScript counts up from 0 to the target on page load.
Target page ID.
Internal region name.
SQL returning a single numeric value.
Description shown below the animated number.
Accent color for the number (named or hex).
Font Awesome class displayed above the number.
Text appended to the number (e.g.,
%, pts).Text prepended to the number (e.g.,
$, R$ ).Count-up animation duration in milliseconds.
Region display order on the page.
CSS
font-size for the icon.CSS
font-size for the animated counter value.apex_add_gradient_donut
Add a donut chart with an optional dynamic value displayed in the center hole via a CSS overlay region.
SQL must return
LABEL and VALUE columns (or use label_column/value_column overrides).Target page ID.
Region display name.
SQL returning slice labels and values.
Column for slice labels.
Column for slice values.
Legend label for the data series.
SQL returning a VARCHAR2 value shown in the donut center.
Static fallback text for the donut center.
end, start, top, bottom, or none.Chart height in pixels.
Region display order on the page.
apex_add_mini_charts_row
Add a row of 1–6 compact mini charts side by side. Each mini chart is a standard JET chart rendered at reduced height, ideal for dashboard comparison rows.
Target page ID.
List of 1–6 chart definition objects. Each:
Base display order (each chart gets
sequence + i).apex_add_bubble_chart
Add a bubble chart with X position, Y position, and Z bubble-size dimensions. Useful for comparing three metrics across categories simultaneously.
SQL must return
X (horizontal), Y (vertical), Z (bubble size), and optional LABEL columns. Override defaults with x_column, y_column, z_column, label_column.Target page ID.
Region display name.
SQL returning
X, Y, Z, and optional LABEL columns.Column for X-axis position.
Column for Y-axis position.
Column for bubble size (larger value = bigger bubble).
Column for tooltip/legend labels.
Legend label for the data series.
X-axis label.
Y-axis label.
Chart height in pixels.
Region display order on the page.
Enable zoom on chart axes.
Enable scroll on the chart.
Animation style:
auto, none, fade, or zoom.