Skip to main content
Glama

convert_file

GISGP Lite ($3 a month, or $1 once for 24 hours) — pass the api_key of that account (or Authorization: Bearer). convert one GIS file between formats with the full site converter: input shapefile (.zip), KML/KMZ, GPX, CSV, GeoJSON, GPKG, FlatGeobuf, MapInfo TAB (.zip, source="mapinfo-tab"), FileGDB (.zip, source="filegdb"), DXF or DWG; to geojson | shapefile | kml | kmz | gpx | csv | xlsx | gpkg | flatgeobuf | mapinfo-tab | wkt | dxf. source_epsg for projected CSV / a shapefile without .prj, target_epsg to reproject (GeoJSON-composable pairs). File up to 4.5 MB inline (base64). Returns JSON {ok, filename, content_type, size, data_base64} or {ok, download_url} for big results, {ok: false, error, pairs} otherwise.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
toYes
sourceNo
api_keyNo
filenameYes
data_base64Yes
source_epsgNo
target_epsgNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations the description carries the full burden, and it supplies real behavioral facts: paid tier and pricing, auth requirement, 4.5 MB inline size cap, and the two success shapes plus the failure shape with a `pairs` field. It does not state whether the operation is non-destructive or note any rate limits, but the disclosed constraints are substantive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Length is justified by 7 parameters and two large format lists, but the description opens with pricing and auth ('GISGP Lite ($3 a month...)') instead of the tool's function, pushing the actual purpose to the second clause of a run-on sentence. Dense but poorly front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a general-purpose converter with a live output schema, the definition covers auth, supported formats, projection handling, size limits, and the success/error envelopes, which is close to sufficient. Minor gaps remain around what `pairs` means in an error and whether download_url expires, but nothing critical for correct invocation is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description must compensate and largely does: it enumerates legal `to` values, explains `source` enum-like values, defines `source_epsg`/`target_epsg` purpose, ties `api_key` to the account tier, and implies base64/`filename` via the inline-file sentence. Only `filename` and the exact `pairs` semantics are left implicit.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('convert one GIS file between formats with the full site converter') and enumerates the complete set of accepted inputs and outputs. This implicitly distinguishes it from the dozens of pair-specific siblings (geojson_to_kml, shapefile_to_geojson, etc.), but it never names or contrasts those siblings explicitly, so the routing signal is inferred rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear operating context: pass the account api_key (or Bearer header), 4.5 MB inline limit, source="mapinfo-tab"/"filegdb" for zipped TAB/FileGDB, and source_epsg/target_epsg for projected CSV or missing .prj. What is missing is any when-not guidance or explicit pointer to the narrower sibling converters for single-pair jobs.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.