Platform toolset

The Platform toolset exposes core SnapLogic platform operations to MCP-compatible clients. Use these APIs to run and validate pipelines, discover accounts and assets, manage SLDB files, query Snaplex infrastructure, export projects and pipelines, and save user preferences — all through a standard MCP session.

All Platform toolset endpoints share the base path /api/1/rest/public/platform_mcp/mcp/platform.

Platform toolset APIs
POST /platform_mcp/mcp/platform sends a JSON-RPC 2.0 request to the Platform MCP Server using the Platform toolset and returns the response as a Server-Sent Events (SSE) stream.
GET /platform_mcp/mcp/platform opens a persistent Server-Sent Events (SSE) stream for receiving server-initiated messages from the SnapLogic MCP Server on the Platform toolset.
DELETE /platform_mcp/mcp/platform terminates an active Platform toolset MCP session and releases any associated server-side resources.

Available tools

After initializing a session, call tools/list to retrieve the live set of tools. The following 20 tools are available in the Platform toolset, grouped by function:

Session and organization
Tool name Description Inputs
save_user_preferences Save default org, project path, and Snaplex for the session so that subsequent tool calls do not require them explicitly.
  • default_org — Optional. Org name.
  • default_path — Optional. Project path within the org.
  • snaplex_path — Optional. Default Snaplex runtime path.
refresh_organizations_and_assets_cache Force a refresh of the server-side cache of organizations, projects, and assets. Useful after creating or moving assets in SnapLogic Manager. None.
list_organizations List all SnapLogic organizations the authenticated user belongs to. Returns [{name, id, is_admin}]. Call this first when the org name is unknown — the name values are what other tools expect as their org argument. None.
Account and asset discovery
Tool name Description Inputs
list_accounts List accounts under an org or project path. Returns metadata only (label, path, snode_id, class_id, class_label) — never credential values. Filter by class_id to find accounts compatible with a given Snap type.
  • org — Required.
  • project_path — Optional.
list_assets List the assets directly under one directory path. Use asset_type to narrow results (for example, Pipeline) or pass comma-separated values (for example, Dir,PSpace,Project) to list project containers only. Omit asset_type to return everything under the path. To search the whole org for one type use find_assets_by_type.
  • org — Required.
  • path — Optional.
  • asset_type — Optional.
  • search — Optional.
  • limit — Optional.
  • offset — Optional.
find_assets_by_type Find assets of one type across a project path. Pass project_path for complete results; omitting it searches from the org root but coverage depends on the backend search index and is not guaranteed to be exhaustive. To find Tasks, use asset_type='Job'.
  • org — Required.
  • asset_type — Required.
  • project_path — Optional.
get_asset_details Look up an asset by path. Returns its snode_id and type. Set detail='full' to also retrieve owner, timestamps, and the full raw asset record. For the reverse lookup (snode_id → path) use get_asset_path.
  • org — Required.
  • asset_path — Required.
  • detail — Optional.
  • asset_type — Optional.
get_asset_path Reverse lookup — resolve a snode_id back to its readable asset path. The inverse of get_asset_details (path → snode_id).
  • org — Required.
  • snode_id — Required.
Snaplex management
Tool name Description Inputs
list_snaplexes List all Snaplexes available in the specified org. Use the returned runtime_path_id values with other pipeline tools.
  • org — Optional. Org name. Defaults to default_org from save_user_preferences.
get_snaplex_details Retrieve configuration and current status for a specific Snaplex, including version and health.
  • org — Optional. Org name.
  • runtime_path_id — Required. The Snaplex path ID returned by list_snaplexes.
Pipeline operations
Tool name Description Inputs
execute_pipeline Execute a SnapLogic pipeline from inline SLP content and return the pipeline run result.
  • slp_content — Required. Pipeline JSON (SLP) as a string.
  • slp_encoding — Optional. json (default) or base64.
  • org — Optional.
  • project_path — Optional.
  • snaplex_path — Optional. Snaplex to run on.
  • pipeline_params — Optional. Key-value pairs passed to the pipeline.
  • timeout — Optional. Seconds to wait for completion.
  • duplicate_check — Optional. Set to false to overwrite an existing pipeline at the same path. Default: true.
import_pipeline Import an SLP pipeline definition into a SnapLogic project without executing it.
  • slp_content — Required. Pipeline JSON (SLP) as a string.
  • slp_encoding — Optional.
  • org — Optional.
  • project_path — Optional.
  • duplicate_check — Optional. Default: true.
validate_pipeline Validate an SLP pipeline against a Snaplex without executing it. Returns validation errors and warnings.
  • slp_content — Required. Pipeline JSON (SLP) as a string.
  • slp_encoding — Optional.
  • org — Optional.
  • project_path — Optional.
  • snaplex_path — Optional. Snaplex to validate against.
export_pipeline Export a SnapLogic pipeline definition (SLP JSON) by name. Returns the complete pipeline definition including metadata, which can be passed directly to import_pipeline. Uses the Export individual assets API.
  • org — Required.
  • project_path — Optional.
  • pipeline_name — Required. Name of the pipeline to export.
  • return_encoding — Optional. json (default) or base64.
export_project Export a SnapLogic project as a ZIP archive. The ZIP is written to the project (timestamped) and the response returns a short-lived presigned download URL — the archive content does not pass through the model context. Account assets are opt-in only; when included, the response note warns that the presigned link carries an encrypted credential envelope and must be treated as a secret. Uses the Export a project API.
  • org — Required.
  • project_path — Optional.
  • asset_types — Optional. Comma-separated list of asset types to include in the ZIP. Defaults to Pipeline,Job. Add Account only when exporting credential material is intended.
  • include_file_asset_metadata — Optional. When true (default), the response includes the project's SLDB file list. Fetch individual files via download_sldb_file.
SLDB file operations
Tool name Description Inputs
list_sldb_files List files and folders at a given path in SLDB cloud storage.
  • org — Optional.
  • path — Optional. SLDB path to list. Defaults to the root.
upload_sldb Upload a file to SLDB cloud storage.
  • path — Required. Target SLDB path including filename.
  • file_content — Required. File content as a string.
  • encoding — Optional. base64 or text. Default: text.
  • org — Optional.
  • overwrite — Optional. Set to true to replace an existing file. Default: false.
download_sldb_file Download a file from SLDB cloud storage and return its content.
  • path — Required. SLDB path of the file to download.
  • org — Optional.
move_sldb_file Move or rename a file within SLDB cloud storage.
  • source_path — Required. Current SLDB path of the file.
  • dest_path — Required. Target SLDB path.
  • org — Optional.
delete_sldb_file Delete a file from SLDB cloud storage.
  • path — Required. SLDB path of the file to delete.
  • org — Optional.
Note: Tool calls are logged to the Tectonic activity log (operation metadata only, not payload content). Audit log entries include the calling user, tool name, org, and timestamp.