APIs

APIs registered on the Neptune DXP - Open Edition platform are exposed through MCP as read-only. The MCP server provides tools to list and inspect APIs, but there are no tools to create, modify, or delete an API. Use the Cockpit for write operations.

Required role: apidesigner.

If your user account does not have this role, every tool in this group fails immediately with an access denied error. Contact an administrator to request the role, or see Access control for more information on how roles are enforced.

Available tools

Parameters are shown with their type and a short description. UUIDs are always strings.

Tool Description Parameters

list_apis

List all APIs in Neptune DXP - Open Edition. Returns a summary per API (id, name, description, endpoint, type, version, group, package).

Use get_api for full endpoints, paths, and definitions.

None

get_api

Return detailed information about an API, including its endpoints, paths, and definitions.

id (string)

save_api

Create or update an API. Pass the full API object. Omit id to create a new API.

api (object): Full API definition object.

delete_api

Delete an API by its ID.

id (string)