MCP Sap Gui

Get the currently focused cell position in an ALV grid or table control.

Check if a popup/modal dialog is open (wnd[1], wnd[2], etc.). Returns the popup's title, text content, and available buttons so you know how to respond. Also classifies the popup and suggests a safe next action. Returns {popup_exists: false} if no popup. The popup's text is in `texts`: labels and display-only fields (a message popup's lines). A popup whose body is a classic list (an F4 hit list, a note, a message's long text) has `list` (`cells`, `rows`, `hint`) instead: its lines are never in `texts` or `interactive_elements`; read them with sap_read_list. Radio buttons and checkboxes in in…

Discover all elements on the current SAP screen. Useful for finding field IDs when working with a new screen. Use type_filter and changeable_only to reduce response size on complex screens (e.g. type_filter="GuiTextField,GuiCTextField" to find only input fields). max_depth controls how deep to recurse into containers (default 2). Use max_depth=1 for a quick overview, max_depth=3+ for deeply nested layouts (splitter containers, tab strips with sub-containers). Pass container_id='wnd[0]/mbar' to discover the menu bar structure. Radio buttons and checkboxes report selected (true/false); a dr…

Get current SAP screen info: transaction, program, screen number, window title, and status bar message (success/error/warning text). Reads from ``session.ActiveWindow`` so the response always reflects what the user sees. The ``active_window`` field tells you which window is in focus (e.g. ``wnd[0]`` for the main screen, ``wnd[1]`` for a popup). The ``title`` comes from the active window. Every action tool (press_button, send_key, select_menu, etc.) returns this same screen info, so you always know when a popup appears. Use sap_get_popup_window for full popup content (texts, buttons). Pres…

Get information about the current SAP session (system, client, user, transaction, screen). Also the SAP GUI release (sap_gui_version) and scripting_read_only: when true, the SAP server allows read-only scripting and write tools refuse.

Get row metadata (selectable, selected) from a GuiTableControl. If rows is omitted, queries all visible rows. Does NOT work on ALV grids.

List all buttons on the system toolbar (tbar[0]) and app toolbar (tbar[1]). Returns button IDs, text, tooltip, and enabled state. This is for standard SAP toolbars, NOT ALV (use sap_get_alv_toolbar for ALV).

Return a generic, read-first guide for a supported SAP transaction. Available transactions: - **/SCWM/MON**: EWM Warehouse Monitor with tree navigation and ALV results. - **SM30**: table/view maintenance and view clusters (SM34) - also what most IMG activities open: reading the table, the docked dialog-structure tree, new entries, saving and the customizing request prompt. Aliases accepted: `SCWM/MON`, `warehouse monitor`, `ewm warehouse monitor`, `SM34`, `table maintenance`, `view maintenance`, `view cluster`.

Get direct children of a tree node. Much faster than read_tree for step-by-step navigation of deep trees (e.g., SPRO). Omit node_key or pass empty string for root-level nodes. Set expand=true to expand the node first (requires write permission).

Return step-by-step guidance for a common SAP workflow. Available workflows: - **search_help**: F4 search help on a field. `target` = field ID. - **table_export**: Paginated table export. `target` = table element ID. - **spro_navigate**: SPRO customizing navigation. `target` = activity name.

Read and optionally act on the current popup/modal dialog. Use when active_window shows wnd[1] or higher. Combines popup inspection and response in a single call. Actions: - read: return popup content without acting (default) - confirm: press OK/Yes/Continue/Enter on the popup - cancel: press Cancel (or F12) on the popup; never No, which on a save prompt drops the changes - press: press a specific button by its text or tooltip - auto: take only a clearly safe action; otherwise return the popup read-only A press that may save (a Save button, or Yes/OK on a popup about saving, e.g. "Save th…

List all open SAP connections and sessions. Covers SAP Logon plus SAP Business Client / embedded SAP GUI sessions (`host`: saplogon | sapguiserver). A connection with no sessions and `scripting_disabled: true` means the server parameter sapgui/user_scripting is off, so no session can be read. Each session has its system, client, user, transaction, `session_number` (the "(2)" in "DEV(2)") and window `title`.

Modify the value of a cell in an ALV grid or table control. Only works on editable cells. Use sap_get_cell_info to check if a cell is changeable before attempting to modify it.

Press a toolbar button on an ALV grid (e.g., sort, filter, export). Use sap_get_alv_toolbar to find button IDs. A menu button (Menu / ButtonAndMenu) opens its menu and the response lists menu_items (text and function_code); pick one with sap_select_alv_context_menu_item.

Press (click) a pushbutton or toolbar button on the current SAP screen. Returns screen info after the press so you can detect navigation or popups. Use sap_get_toolbar_buttons to discover toolbar button IDs. Use sap_get_screen_elements to find on-screen button IDs. When screen info has message_has_long_text, pressing 'wnd[0]/sbar' opens that long text (Diagnosis / Procedure), usually as a list popup: read it with sap_read_list(window_id='wnd[1]'). A popup button is checked like sap_handle_popup's press: a press that may save, or any answer but Cancel to a popup question the tool cannot read,…

Click a column header in an ALV grid (triggers sort). Does NOT work on GuiTableControl.

Render a preview card of the current SAP screen for the user: screenshot, session/transaction info, status bar, and the values the agent is about to write (pending_fields). Call before significant writes (batch fills, F11 save) or whenever the user asks to see what's about to happen. Read-only: nothing is written or saved.

Read the value of a field on the current SAP screen. Returns value, type, changeable status, and labels (left/right). For a dropdown, value is the selected entry's text and key its key. For a radio button or checkbox, value is its label and selected says whether it is selected. Use sap_get_screen_elements to discover field IDs on unknown screens.

Read a classic ABAP list (WRITE output of a report) as lines of text. Use it when a report shows a plain list rather than an ALV grid (program SAPMSSY0, screen 120), and for F4 hit lists in a popup (window_id= 'wnd[1]'). Such a list has no table object: every word is its own label, so sap_get_screen_elements leaves the cells out and reports it under 'lists'. This returns the page as the lines the user sees, with no screenshot needed. - colors: rows whose text has a semantic list colour, e.g. 'negative' (red, errors), 'positive' (green), 'total', 'heading' - scroll: present when the list is…

Read content from a GuiShell subtype (e.g., HTMLViewer). An HTML viewer's page text and URL are readable only with the Internet Explorer browser control; with the Edge control (SAP GUI 7.70+ default, e.g. the F1 Performance Assistant) the response says so in `note`. Use sap_get_screen_elements first to find shell element IDs.

Read rows from a table on the current screen — ALV grid (report/list output) or TableControl (SM30 maintenance view, customizing screens). Auto-detects the table type. The response includes a 'table_type' field ('GuiGridView' for ALV or 'GuiTableControl') so you know which type-specific tools to use next (e.g., sap_get_alv_toolbar for ALV, sap_scroll_table_control for TableControl). Use columns_only=true for schema discovery (returns column metadata only, no data). For a TableControl it also gives each column's cell_type and a cell_id template ({row} = zero-based visible row) for sap_set_bat…

Read the content of a multiline text editor (GuiTextedit) — long texts, notes, comments, document text. Returns full text and line count. Use max_lines to cap output for large text editors (0 = all lines).

Read data from a tree control (TableTreeControl, ColumnTreeControl, etc.). Returns node hierarchy with texts and column values. For large trees (e.g., SPRO with 1000+ nodes), use sap_get_tree_node_children for step-by-step navigation instead. Use sap_search_tree_nodes to find specific nodes by text. total_nodes is the number of nodes read; truncated=true means the tree has more loaded nodes (available_nodes) than max_nodes allowed.

Take a screenshot of the current SAP window. Use as a fallback when structured tools (sap_get_screen_elements, sap_read_field, sap_read_table) return empty or confusing results, e.g., on Web Dynpro screens where the element tree is non-standard. To put a screenshot into a document, pass save_path (must end in .png, directory must exist, existing files are never overwritten). The file keeps SAP GUI's full resolution; the inline image is capped at 1920px. The response then also reports the absolute path and pixel size. Set inline=False to skip the image when only the file is needed.

Scroll a GuiTableControl to a specific row position. Does NOT work on ALV grids (they handle scrolling internally). For reading data at a specific offset, prefer sap_read_table with start_row parameter — it handles scrolling automatically. position in the response is the row SAP actually put at the top, which can differ from the one asked for (then requested_position and a note say so). Cell IDs ([col,row]) count visible rows from that row.

Search for tree nodes by text. Returns matches with full ancestor paths. Useful for finding nodes in deep trees where the same label appears in multiple branches. Case-insensitive substring match. Optionally pass column to search in a specific column instead of node text. **Important limitation**: Only searches nodes that are already loaded (expanded) in the tree. Collapsed subtrees are not searched. If you don't find what you expect, expand parent nodes first using sap_get_tree_node_children with expand=true, then search again. total_matches counts the matches returned. stopped_early=true …

Select all rows in an ALV grid. Does NOT work on GuiTableControl.

Select or deselect all columns in a GuiTableControl. Does NOT work on ALV grids.

Select an item from an opened ALV context menu. First use sap_press_alv_toolbar_button on a Menu button to open it, then use this to select an item. Alternatively, pass toolbar_button_id to open the menu and select in one atomic call (recommended). `menu_item_id` can be a technical function code (for example `@M00006`), visible menu text (for example `Confirm WT in Foreground`), or a position descriptor. You can pass human-readable menu text directly. The menu_items of sap_press_alv_toolbar_button list what a menu offers. `select_by` controls how selection is performed: - `auto` (default): …

Select or deselect a checkbox on the current SAP screen. Set selected=false to uncheck. Use sap_get_screen_elements with type_filter='GuiCheckBox' to find checkbox IDs.

Select an entry in a combobox/dropdown by its key or display value text. Accepts either the technical key or the visible display text. Use sap_get_combobox_entries first to see all valid options. F4 opens nothing on a dropdown; sap_set_field selects entries the same way.

Select a menu item from the menu bar or a submenu. Example: 'wnd[0]/mbar/menu[1]/menu[0]'. Use sap_get_screen_elements on 'wnd[0]/mbar' to discover menu structure. Returns screen info after selection so you can detect navigation.

Select multiple rows at once in an ALV grid or table control. Pass a list of row indices (e.g., [0, 2, 5]).

Select a radio button on the current SAP screen. Use sap_get_screen_elements with type_filter='GuiRadioButton' to find radio button IDs on the current screen.

Select a tab in a tab strip control. Returns screen info after selection (tab content changes). Tab IDs typically look like 'wnd[0]/usr/tabsTABSTRIP/tabpTAB01'.

Select a row in a table/grid. Works on both ALV grids and table controls. Row index is zero-based. For ALV: uses absolute row index. For TableControl: scrolls to make the row visible first if needed.

Select a node in a tree control. Highlights the node without opening it. For SPRO-style trees, use sap_click_tree_link on the execute icon column instead.

Press a keyboard key / function key in the SAP window (sendVKey). Common keys: Enter (confirm), F1 (Help), F3 (Back), F4 (search help / value help), F5 (Refresh), F8 (Execute), F11 (Save), F12 (Cancel/Escape). Also supports Shift+F1..F9 and Ctrl+F, Ctrl+G, Ctrl+P. A key that is not active on the screen is not sent: the response has an error and available_keys, the keys this screen accepts. F11 / Save requires user confirmation via elicitation before proceeding; the response then has confirmed_by_user: true. A declined save returns status 'cancelled' with an error.

Fill in multiple input fields at once (dict of field_id to value). Use this to fill a form or selection screen in one call — more efficient than repeated sap_set_field calls. Table-control cells work too: take the cell_id template of each column from sap_read_table(columns_only=true) and replace {row}. A dropdown (cmb) takes an entry's key or text, as in sap_set_field. The result gives counts; `results` lists only the fields that did NOT succeed (all of them with verbose=true). Check failed == 0: a field that was not set does not stop the others. With --strict-errors such a batch is returned…

Choose which SAP operations need the user's explicit approval first. Replaces this session's set of confirmation points. When a point is active, every matching tool call pauses and asks the user to approve it (MCP elicitation) before anything reaches SAP; declining returns an error and nothing is executed. Points: - transactions: sap_execute_transaction - batch_fields: sap_set_batch_fields - field_writes: sap_set_field, sap_modify_cell, sap_set_textedit, sap_select_checkbox, sap_select_radio_button, sap_select_combobox_entry - all_writes: every write-tagged tool. Strict and noisy — many wr…

Set the current (focused) cell in an ALV grid or table control. Useful before pressing toolbar buttons that act on the current cell.

Set (type/enter) a value into an input field on the current SAP screen. Works on GuiTextField and GuiCTextField input fields, and on dropdowns (GuiComboBox, ID prefix cmb): there value picks the entry by its key or its text, and the response reports the key and text selected. For filling in multiple fields of a form at once, use sap_set_batch_fields instead. After setting a field, you may need to press Enter to trigger validation. A value longer than the field (MaxLength) or a field that is not changeable is refused before writing: status 'rejected' and an error that says which, and the fiel…

Set focus to any screen element by its ID. Some SAP actions require focus on a specific element before they work (e.g., F4 search help on a field). Use this to set focus before sending keys with sap_send_key.

Switch the active policy profile for this session. Profiles control which tools are visible: - exploration: read-only tools (discover, inspect, screenshot) - operator: read + write tools (normal SAP interaction) - full: all tools including destructive (transaction execution) A session can only restrict, never widen: if the server was started with --profile, a request above that floor is capped to the floor. Default profile is 'full' unless the server was started with --profile.

Write text into a multiline text editor (GuiTextedit) — long texts, notes, comments, document text.