Sap Adt MCP

Set a debugger watchpoint that breaks when a variable changes (or a condition holds). Phase 3, WRITE — refused under read-only mode. NOTE: the watchpoint request/response contract has no reference implementation and is best-effort until validated on a live system; check `raw`.

Return the call stack of the currently attached debuggee (after adt_debug_listen caught one).

Advance the attached debuggee (Phase 2, flow control). `kind`: into (step into), over (step over), return (step out), continue (resume until the next breakpoint), runToLine / jumpToLine (need `uri`), terminate (stop the debuggee). WRITE — refused under read-only mode. Returns the new state (position, reached breakpoints) plus raw XML. A `continue` that lets the run finish answers `status: "debuggeeEnded"` — that is success (the debuggee resumed, the triggering request returned), not an error.

End the debug session: release the attached debuggee (stepContinue), then delete this process's listener and every breakpoint it set. Call when finished (or to reset after an error) so no dangling breakpoints/listeners are left on the system and no suspended request is left hanging.

Read variable values from the currently attached debuggee. Pass `names` (variable names/ids in scope, e.g. ['sy-subrc','lv_total']); omit to read the top-level scope roots.

Delete an ABAP object. Acquires a lock and issues DELETE. Refused under read-only mode.

Fetch the full detail of one ABAP short dump by id. Performs two requests: a metadata XML lookup (runtime error, program, links to dump text) followed by a fetch of the formatted dump text from the link returned by SAP. Returns the metadata plus a chapter map (shortText, whatHappened, errorAnalysis, howToCorrect, whereTerminated, sourceCodeExtract, …). Pass chapters: ['key', …] to limit the response to specific chapters; set full: true to also include the raw dump text (typically 100KB+).

Fetch SAP Note metadata (title, component, version, type, implementation prerequisites) via the Note Assistant ADT API. EXPERIMENTAL — only available on systems shipping the SNOTE ADT plug-in (modern S/4HANA). On systems without it the response carries available:false and a hint to use GUI SNOTE.

Fetch the ABAP source of an object (program, class, interface, function module, include, CDS, table). Returns plain text. DDIC primitives without plain-text source (data element, domain, message class) return their ADT XML metadata instead (format: 'xml'). For sources larger than the MCP per-call output cap (~64 KB), use firstLine/lastLine to paginate or onlyMethod to slice a single method body — or pass `outputFile` to write the full source straight to disk (then edit it and write it back with adt_set_source `sourceFile`, keeping large objects entirely off the agent's I/O path).

Fetch detail of a single transport request (header + included objects).

Full-text regex search across ABAP source. Complements adt_search_objects (which only matches names). Scope the search to a package (optionally recursive), a transport request, or an explicit object list. Fetches /source/main for each source-bearing object (programs, classes, interfaces, includes, CDS/DDLS, DCLS, DDLX, behavior definitions) and returns matching lines as object + line + text. DDIC primitives (tables, data elements, domains) and function groups are skipped (no single source document). Bounded by maxObjects and maxMatches — large packages are truncated, not silently capped.

Implement (download + apply) a SAP Note via the Note Assistant ADT API. WRITE operation — subject to read-only mode and requires a transport. EXPERIMENTAL and potentially disruptive: implementing a note changes system objects. Only available on systems shipping the SNOTE ADT plug-in. Prefer GUI SNOTE for anything non-trivial.

List ABAP short dumps (ST22) from the runtime-dumps Atom feed. Each entry exposes id, runtime error name, terminated program, timestamp, user, and any release-specific rba:*/dump:* fields surfaced by the system. The server-side row cap is unreliable across releases (some ignore it) — adt_list_dumps trims to maxResults on the client too. Use adt_get_dump with an id for the full dump text.

List the inactive objects worklist for the connected user (the ADT 'Inactive Objects' view — what has been edited but not yet activated). Returns each object with its type and, where available, the transport it sits in. An empty list means everything is activated.

List runtime enqueue locks (the SM12 analog). NOTE: most ABAP systems do NOT expose SM12 runtime enqueues over ADT REST — in that case the response carries available:false and a hint to use SM12. This is distinct from the editing lock acquired by adt_lock (a single object) and from DDIC lock-object definitions.

Description is built at runtime.

List the API release-state contracts the system defines — the catalog used to classify released objects (e.g. USE_IN_KEY_USER_APPS = C1, ADD_CUSTOM_FIELDS = C0), each with its compatibility-contract description. This is the released-API classification catalog, not a per-object enumeration (object-level released-API listing requires the release-dependent RIS search facet). Backed by repository/informationsystem/releasestates.

List configured SAP systems available for ADT calls, the default system, and read-only flags.

List transport requests visible to the configured user. Filter by user (requestor) and / or status (modifiable / released). Endpoint shape may vary across NetWeaver releases — falls back to adt_request if your system uses a different path.

List the version history of an object via the ADT versions sub-resource ({objectUri}/versions). NOTE: many on-prem NetWeaver releases do not expose a version-history REST endpoint and return 404 — in that case use adt_compare_versions to diff active vs inactive instead. The response carries available:false with a hint when the endpoint is absent.

Acquire a stateful lock on an ABAP object. Returns a lockHandle to reuse across multiple adt_set_source calls. On CTS conflicts the error includes longText and t100 details (which TR is blocking, who owns it) so the caller can recover.

Ping a configured SAP system by calling the ADT discovery endpoint. Use to verify credentials and network reachability.

Run the ABAP pretty printer on supplied source code (stateless — no object lookup, no lock).

Generate a complete RAP stack from a short spec: CDS root view entity → behavior definition (managed) → behavior implementation class → service definition → service binding. DEFAULTS TO dryRun:true — returns the planned object names and generated source for review WITHOUT creating anything. Set dryRun:false to actually create them in dependency order (subject to read-only mode; requires a transport for non-local packages). The service binding is always plan-only (its publish step is not automated). Built on the same create primitives as adt_create_object.

Read the output (spool list) of a background job / spool request (SP01 analog). EXPERIMENTAL — see adt_schedule_job for availability constraints; returns available:false on systems without an ADT spool service.

Execute an OpenSQL SELECT against the SAP database via the ADT Data Preview endpoint. Read-only by design (SELECT only — INSERT/UPDATE/DELETE rejected client- and server-side). Returns structured { columns, rows }. Use ABAP OpenSQL syntax: 'SELECT matnr matkl FROM mara WHERE matnr LIKE \'M%\''. Row count capped at maxRows (default 100, hard cap 5000). Requires NetWeaver 7.55+ or S/4HANA — older systems may not expose this endpoint.

Release a transport request. Subject to read-only mode.

File a bug or enhancement about a sap-adt-mcp TOOL back to the maintainer. The report is redacted (hosts, users, passwords, IPs, emails stripped), de-duplicated, and becomes a GitHub issue. Use this for defects the automatic crash reporter cannot see: wrong data in an otherwise-successful response, a parameter that is silently ignored, or a missing capability. Do NOT use it for problems in the user's ABAP code or SAP system — only for defects in this MCP server's own tools.

Generic ADT REST call — escape hatch for endpoints not covered by a high-level tool. Handles Basic auth, sap-client, cookies, CSRF token automatically. Path is confined to the /sap/bc/adt/ namespace.

Run ABAP Test Cockpit (ATC) on one or more objects. ATC endpoint shape varies across NetWeaver releases.

Run ABAP Test Cockpit (ATC) over an ENTIRE package via the full ADT worklist flow (create worklist → run → fetch results). Returns parsed findings (check, message, priority, location) plus a priority histogram and the worklist id. When checkVariant is omitted, the system default check variant from ATC customizing is used. This is the bulk counterpart to adt_run_atc (single object).

Run ABAP Test Cockpit (ATC) over every object in a transport request via the full ADT worklist flow. Resolves the transport's object references, runs ATC against them, and returns parsed findings + priority histogram + worklist id. When checkVariant is omitted, the system default check variant is used.

Run ABAP Unit tests for one or more objects (typically test container classes).

Schedule an ABAP background job (SM36 analog) that runs a report with a variant. WRITE operation — subject to read-only mode. EXPERIMENTAL: no standardized ADT job-scheduling API exists on classic NetWeaver; on systems without an extension service the response carries available:false. Prefer SM36 for anything important.

Quick-search the ABAP repository for objects whose name matches a pattern. Use '*' as wildcard.

Replace the ABAP source of an object. The new source is the FULL text of the include — it ATOMICALLY REPLACES the entire include on the server. Passing a partial chunk or diff will delete the rest of the include. Supply the source inline via `source`, OR — for a large object that would blow the per-call I/O cap — via `sourceFile` (a local path the MCP process reads itself). Orchestrates lock → PUT → unlock automatically. Requires read-only mode to be off for the target system.

Replace ABAP source incrementally for files larger than the MCP per-call I/O cap. Caller acquires a lock with adt_lock, then sends the source in N chunks (chunkIndex 0..N-1) under a stable bufferId, and finally commits with commit=true to trigger the actual PUT. The chunks accumulate in server-side memory (10-minute TTL, 4 MB total cap per buffer). Same partial-source guard as adt_set_source applies at commit time.

Run an ADT syntax check on an object. Returns the raw <chkrun:reports> XML. Includes only compile in the context of a main program: for type=include, pass `context` (the main program / function group), otherwise the check returns status='notProcessed'. When omitted for an include, the tool tries to auto-resolve the include's first main program.

Identify the connected SAP system: product (S/4HANA version, ECC or plain NetWeaver), SAP_BASIS release and SP level, and whether the ABAP Cloud development model is available (SAP_BASIS ≥ 7.57). Read-only — derived from table CVERS (installed software components) via the same Data Preview endpoint as adt_read_table, so it needs NetWeaver 7.55+ / S/4HANA. Call it before choosing release-sensitive guidance (Clean Core vs classic ABAP) or a release-dependent ADT endpoint.

Diff every object listed in a transport between two systems. Capped at maxObjects (default 50).

Where is a transport request right now? Reads the request header (E070: status, owner, target) and the tp action log (TPALOG: export, forward into a follow-on import buffer, import steps with return codes) on one or more configured systems, and summarizes per target system: exported, in-import-queue, imported, imported-with-errors or import-aborted. Pass `systems` with every system of the route (e.g. ['DEV','QAS','PRD']) for the full picture — each system only logs the tp steps that touched it. Read-only (Data Preview SELECTs; NetWeaver 7.55+ / S/4HANA). The TMS buffer file itself is not reach…

Release a stateful lock previously acquired with adt_lock.

F4-style value help for a DDIC field, data element or domain: the domain's fixed values (with texts, DD07L/DD07T) and/or the contents of its check table / value table, joined with the text table in the requested language. Pass exactly one of `domain`, `dataElement`, or `table` + `field`. Read-only (Data Preview SELECTs on DDIC tables; needs NetWeaver 7.55+ / S/4HANA). Search helps (SE11 elementary/collective) are not evaluated — when a field has neither fixed values nor a check table the result says so.

Where-used list for an object. Returns the references that point to it. Widely-used objects can have thousands of references, so the list is capped at `maxResults` (default 200) — `numberOfResults` always reports the backend's full count and `truncated` says whether the list was cut. The result also carries `request` (method, url, headers, body) so the underlying ADT call can be replayed by hand.