FME MCP - Tools Reference Catalogue
A complete index of tools exposed by FME MCP (fme-mcp), organised by domain.
🖥️ Desktop Interactivity & Bridge
fme_diagnose
Runs comprehensive system and environment diagnostics for FME Form and FME Flow.
- Returns: Installation path, FME version, build number, licensing status, embedded Python runtime, active desktop processes (fmeworkbench.exe, fmedatainspector.exe), and loopback bridge availability.
fme_inspect_canvas
Parses the visual workspace canvas topology directly from .fmw XML.
- Arguments:
- workspace_path (string, required): Path to the .fmw workspace file.
- Returns: Transformer layout coordinates $(X, Y)$, feature types, port connection links, and automated warning detection for unconnected output ports.
fme_open_in_workbench
Launches or focuses FME Workbench GUI with the target workspace in a detached, non-blocking process.
- Arguments:
- workspace_path (string, required): Path to the .fmw workspace file.
fme_open_in_inspector
Launches FME Data Inspector GUI directly on any spatial dataset for interactive visual map exploration.
- Arguments:
- dataset_path (string, required): Path to the spatial dataset (.gpkg, .shp, .xlsx, .csv, .geojson).
fme_preview_dataset
Provides instant schema and sample feature inspection without needing to launch desktop GUIs.
- Arguments:
- dataset_path (string, required): Path to the dataset file (.gpkg, .sqlite, .xlsx, .csv).
- limit (integer, default 10): Maximum sample records to return.
📁 Workspaces & Jobs
fme_discover_workspaces
Crawls an authorised directory to discover .fmw workspace files.
- Arguments:
- directory (string, optional): Base path to scan (defaults to current working directory).
- recursive (boolean, optional): Recursively scan subdirectories (default true).
fme_get_workspace
Inspects an FME workspace without execution.
- Arguments:
- workspace_path (string, required): Path to the .fmw file.
- Returns: Published parameters, transformers count, readers, writers, file size.
fme_run_workspace
Executes an FME workspace synchronously.
- Arguments:
- workspace_path (string, required): Path to the .fmw file.
- parameters (object, optional): Published parameters key-value mapping.
- log_file (string, optional): Target path for execution log.
- timeout_seconds (integer, optional): Execution timeout (default 600).
fme_audit_performance
Audits an FME workspace for performance anti-patterns, heavy blocking transformers, unindexed reader queries, unconnected rejected/error ports, and feature caching overhead.
- Arguments:
- workspace_path (string, required): Path to the .fmw workspace file.
- strict_mode (boolean, optional, default false): Strict scoring mode.
- Returns: Performance score (0–100), rating (EXCELLENT, GOOD, FAIR, POOR, CRITICAL), identified bottleneck transformers, unindexed readers, and actionable optimization recommendations.
fme_export_markdown_docs
Resiliently extracts canvas bookmarks, developer annotations, published parameters, readers/writers, and transformer hierarchies from .fmw files and exports clean GitHub-flavored Markdown documentation.
- Arguments:
- workspace_path (string, required): Path to the .fmw workspace file.
- output_file (string, optional): Output file path to write Markdown.
- Returns: Formatted markdown documentation string and file write confirmation.
🌍 Spatial Intelligence
gis_reproject
Transforms 2D coordinates between common Coordinate Reference Systems (CRS).
- Arguments:
- x (number, required): Longitude / Easting.
- y (number, required): Latitude / Northing.
- source_epsg (integer, default 4326): Source EPSG code.
- target_epsg (integer, default 2154): Target EPSG code (e.g. Lambert-93 or 3857 Web Mercator).
gis_buffer
Generates a circular buffer polygon around a center coordinate.
- Arguments:
- center_lon (number, required): Longitude in degrees.
- center_lat (number, required): Latitude in degrees.
- radius_metres (number, required): Radius in metres.
- num_points (integer, default 32): Number of perimeter vertices.
gis_validate_geometry
Validates structural integrity, closed polygon rings, and self-intersections.
- Arguments:
- geojson_geometry (object, required): GeoJSON geometry object.
gis_intersection
Computes the geometric intersection between two 2D geometries (GeoJSON or WKT).
- Arguments:
- geom_a (string or object, required): First geometry (GeoJSON dict or WKT string).
- geom_b (string or object, required): Second geometry (GeoJSON dict or WKT string).
- Returns: Intersection geometry in GeoJSON and WKT format, area, and bounding envelope.
gis_difference
Computes the geometric difference (geom_a minus geom_b).
- Arguments:
- geom_a (string or object, required): Base geometry (GeoJSON dict or WKT string).
- geom_b (string or object, required): Geometry to subtract (GeoJSON dict or WKT string).
- Returns: Difference geometry in GeoJSON and WKT format, area, and bounding envelope.
gis_simplify
Simplifies complex geometry vertices using the Douglas-Peucker algorithm while preserving topology.
- Arguments:
- geom (string or object, required): Geometry to simplify (GeoJSON dict or WKT string).
- tolerance (number, required): Simplification tolerance in CRS units.
- preserve_topology (boolean, default true): Whether to preserve valid topology.
- Returns: Simplified geometry, vertex reduction count, and percentage reduction.
gis_bounding_box
Calculates the spatial bounding box (envelope) of a geometry.
- Arguments:
- geom (string or object, required): Geometry (GeoJSON dict or WKT string).
- Returns: Coordinates $[min_x, min_y, max_x, max_y]$, center coordinates, dimensions (width, height), and GeoJSON Polygon representation.
📊 Data Engineering & Quality
data_read_metadata
Inspects tabular or spatial file metadata.
- Arguments:
- dataset_path (string, required): Path to dataset file (CSV, GeoJSON, etc.).
data_profile
Computes column statistics, null counts, distinct distributions, and completeness percentages.
- Arguments:
- dataset_path (string, required): Path to tabular dataset.
- max_rows (integer, default 1000): Sample size ceiling.
quality_score_dataset
Computes overall quality score index (0–100) based on completeness and data integrity rules.
- Arguments:
- dataset_path (string, required): Path to CSV dataset.
quality_generate_data_contract
Generates a formal Data Contract in standard YAML schema from existing dataset characteristics.
- Arguments:
- dataset_path (string, required): Path to dataset.