{ "openapi": "3.1.0", "info": { "title": "Geoapify MCP Tool: Utilities: Combine Geometries", "version": "1.1.0", "description": "AI-focused, tool-specific OpenAPI specification for combine_geometries over the Geoapify JSON-RPC transport. Import this specification when an integration needs this tool without the full MCP catalog." }, "servers": [ { "url": "https://api.geoapify.com/v1", "description": "Default API endpoint." }, { "url": "https://api-eu.geoapify.com/v1", "description": "EU-focused endpoint. Geoapify service processing uses EU infrastructure." } ], "tags": [ { "name": "Utilities", "description": "Utilities MCP tools." } ], "paths": { "/mcp": { "post": { "tags": [ "Utilities" ], "operationId": "callCombineGeometries", "summary": "Utilities: Combine Geometries", "description": "Use this tool to create a new geometry by intersecting, subtracting, unioning, or enveloping GeoJSON inputs. Use evaluate_spatial_relation for a boolean relationship, measure_geometry for numeric measurements, or transform_geometry to modify one geometry.\n\n## Operations\n\n### `intersection`\n\nReturn the area shared by all input polygons.\n\n**Input**\n\n- Required: `operation` = `\"intersection\"`, `geometries`\n- Optional: none\n\n**Output**\n\nReturns `{ \"type\": \"geojson\", \"data\": Feature }` for the shared Polygon or MultiPolygon area, or `{ \"type\": \"empty\", \"data\": null }` when the inputs have no shared area.\n\n### `difference`\n\nSubtract every later polygon from the first polygon.\n\n**Input**\n\n- Required: `operation` = `\"difference\"`, `geometries`\n- Optional: none\n\n**Output**\n\nReturns `{ \"type\": \"geojson\", \"data\": Feature }` for the part of the first Polygon or MultiPolygon that remains, or `{ \"type\": \"empty\", \"data\": null }` when nothing remains.\n\n### `union`\n\nMerge two or more polygons into their geometric union.\n\n**Input**\n\n- Required: `operation` = `\"union\"`, `geometries`\n- Optional: none\n\n**Output**\n\nReturns `{ \"type\": \"geojson\", \"data\": Feature }` containing the merged Polygon or MultiPolygon.\n\n### `envelope`\n\nReturn a rectangular envelope containing all input geometries.\n\n**Input**\n\n- Required: `operation` = `\"envelope\"`, `geometries`\n- Optional: none\n\n**Output**\n\nReturns `{ \"type\": \"geojson\", \"data\": Feature }` containing the rectangular Polygon that encloses all input geometries.", "parameters": [ { "name": "MCP-Protocol-Version", "in": "header", "required": false, "description": "Optional protocol version. Defaults to 2025-06-18 when omitted; explicitly unsupported versions are rejected.", "schema": { "type": "string", "enum": [ "2025-06-18" ] }, "example": "2025-06-18" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CombineGeometriesToolCallRequest" }, "examples": { "combineIntersection": { "summary": "Geometry: intersect two polygons", "value": { "jsonrpc": "2.0", "id": 10, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "intersection", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } } }, "combineDifference": { "summary": "Geometry: subtract one polygon from another", "value": { "jsonrpc": "2.0", "id": 11, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "difference", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } }, "description": "Every geometry after the first is subtracted from the first geometry." }, "combineUnion": { "summary": "Geometry: merge two polygons", "value": { "jsonrpc": "2.0", "id": 12, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "union", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } } }, "combineEnvelope": { "summary": "Geometry: calculate an envelope around mixed geometries", "value": { "jsonrpc": "2.0", "id": 13, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "envelope", "geometries": [ { "type": "Point", "coordinates": [ 13.405, 52.52 ] }, { "type": "LineString", "coordinates": [ [ 13.38, 52.5 ], [ 13.41, 52.53 ], [ 13.44, 52.54 ] ] } ] } } } } } } } }, "responses": { "200": { "description": "JSON-RPC response for the combine_geometries MCP tool. Tool execution and validation failures also use HTTP 200 with result.isError set to true.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CombineGeometriesToolCallResponse" } } } }, "400": { "description": "Invalid HTTP request or unsupported MCP protocol version. Tool validation errors are returned with HTTP 200 and result.isError set to true.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" }, "example": { "statusCode": 400, "error": "Bad Request", "message": "MCP-Protocol-Version header must be \"2025-06-18\"" } } } }, "401": { "description": "Missing or invalid Geoapify API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" }, "example": { "statusCode": 401, "error": "Unauthorized", "message": "Invalid apiKey" } } } }, "429": { "description": "Rate limit or quota exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" }, "example": { "statusCode": 429, "error": "Too Many Requests", "message": "Quota exceeded" } } } }, "500": { "description": "Internal gateway error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayError" }, "example": { "statusCode": 500, "error": "Internal Server Error", "message": "Request failed, please try again later" } } } } }, "x-geoapify-mcp-tool": "combine_geometries", "x-geoapify-mcp-input-schema": "#/components/schemas/CombineGeometriesInput", "x-geoapify-mcp-output-schema": "#/components/schemas/CombineGeometriesOutput", "x-geoapify-mcp-operations": [ { "name": "intersection", "description": "Return the area shared by all input polygons.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesIntersectionInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesIntersectionOutput" } }, { "name": "difference", "description": "Subtract every later polygon from the first polygon.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesDifferenceInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesDifferenceOutput" } }, { "name": "union", "description": "Merge two or more polygons into their geometric union.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesUnionInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesUnionOutput" } }, { "name": "envelope", "description": "Return a rectangular envelope containing all input geometries.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesEnvelopeInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesEnvelopeOutput" } } ] } } }, "components": { "schemas": { "JsonRpcId": { "description": "JSON-RPC request identifier. The server echoes this value in the response.", "oneOf": [ { "type": "string" }, { "type": "integer" }, { "type": "null" } ] }, "JsonRpcError": { "type": "object", "description": "JSON-RPC error object.", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "JSON-RPC error code, such as -32600 for an invalid request, -32601 for an unknown method, or -32602 for invalid parameters." }, "message": { "type": "string", "description": "Human-readable JSON-RPC error message." }, "data": { "description": "Optional machine-readable error details." } } }, "JsonRpcErrorResponse": { "type": "object", "description": "JSON-RPC error response returned for invalid requests or unknown methods.", "required": [ "jsonrpc", "id", "error" ], "properties": { "jsonrpc": { "const": "2.0" }, "id": { "$ref": "#/components/schemas/JsonRpcId" }, "error": { "$ref": "#/components/schemas/JsonRpcError" } } }, "GatewayError": { "type": "object", "description": "HTTP gateway error returned before or outside JSON-RPC tool execution.", "required": [ "statusCode", "error", "message" ], "properties": { "statusCode": { "type": "integer", "description": "HTTP status code." }, "error": { "type": "string", "description": "HTTP error name." }, "message": { "type": "string", "description": "Human-readable error message." } } }, "CombineGeometriesIntersectionInput": { "type": "object", "title": "intersection", "description": "Return the area shared by all input polygons.", "additionalProperties": false, "required": [ "operation", "geometries" ], "properties": { "operation": { "const": "intersection", "description": "Return the area shared by all input polygons." }, "geometries": { "type": "array", "minItems": 2, "maxItems": 100, "items": { "type": "object", "description": "GeoJSON Geometry (Polygon, or MultiPolygon); not a Feature or FeatureCollection." }, "description": "GeoJSON geometries to combine." } } }, "McpGeometryGeojsonOrEmptyResult": { "type": "object", "description": "Typed geometry-operation result. The type value determines the data schema.", "oneOf": [ { "type": "object", "title": "GeoJSON result", "required": [ "type", "data" ], "properties": { "type": { "const": "geojson", "description": "The result contains GeoJSON data." }, "data": { "type": "object", "description": "GeoJSON Geometry, Feature, or FeatureCollection object." } } }, { "type": "object", "title": "Empty result", "required": [ "type", "data" ], "properties": { "type": { "const": "empty", "description": "The operation completed but produced no geometry." }, "data": { "type": "null", "description": "No result was produced." } } } ], "discriminator": { "propertyName": "type" } }, "CombineGeometriesIntersectionOutput": { "title": "intersection output", "description": "Returns `{ \"type\": \"geojson\", \"data\": Feature }` for the shared Polygon or MultiPolygon area, or `{ \"type\": \"empty\", \"data\": null }` when the inputs have no shared area.", "allOf": [ { "$ref": "#/components/schemas/McpGeometryGeojsonOrEmptyResult" } ] }, "CombineGeometriesDifferenceInput": { "type": "object", "title": "difference", "description": "Subtract every later polygon from the first polygon.", "additionalProperties": false, "required": [ "operation", "geometries" ], "properties": { "operation": { "const": "difference", "description": "Subtract every later polygon from the first polygon." }, "geometries": { "type": "array", "minItems": 2, "maxItems": 100, "items": { "type": "object", "description": "GeoJSON Geometry (Polygon, or MultiPolygon); not a Feature or FeatureCollection." }, "description": "Ordered polygons. Every geometry after the first is subtracted from the first." } } }, "CombineGeometriesDifferenceOutput": { "title": "difference output", "description": "Returns `{ \"type\": \"geojson\", \"data\": Feature }` for the part of the first Polygon or MultiPolygon that remains, or `{ \"type\": \"empty\", \"data\": null }` when nothing remains.", "allOf": [ { "$ref": "#/components/schemas/McpGeometryGeojsonOrEmptyResult" } ] }, "CombineGeometriesUnionInput": { "type": "object", "title": "union", "description": "Merge two or more polygons into their geometric union.", "additionalProperties": false, "required": [ "operation", "geometries" ], "properties": { "operation": { "const": "union", "description": "Merge two or more polygons into their geometric union." }, "geometries": { "type": "array", "minItems": 2, "maxItems": 100, "items": { "type": "object", "description": "GeoJSON Geometry (Polygon, or MultiPolygon); not a Feature or FeatureCollection." }, "description": "GeoJSON geometries to combine." } } }, "McpGeometryGeojsonResult": { "type": "object", "oneOf": [ { "type": "object", "title": "GeoJSON result", "required": [ "type", "data" ], "properties": { "type": { "const": "geojson", "description": "The result contains GeoJSON data." }, "data": { "type": "object", "description": "GeoJSON Geometry, Feature, or FeatureCollection object." } } } ], "discriminator": { "propertyName": "type" } }, "CombineGeometriesUnionOutput": { "title": "union output", "description": "Returns `{ \"type\": \"geojson\", \"data\": Feature }` containing the merged Polygon or MultiPolygon.", "allOf": [ { "$ref": "#/components/schemas/McpGeometryGeojsonResult" } ] }, "CombineGeometriesEnvelopeInput": { "type": "object", "title": "envelope", "description": "Return a rectangular envelope containing all input geometries.", "additionalProperties": false, "required": [ "operation", "geometries" ], "properties": { "operation": { "const": "envelope", "description": "Return a rectangular envelope containing all input geometries." }, "geometries": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "object", "description": "GeoJSON Geometry (Point, LineString, Polygon, MultiPoint, MultiLineString, or MultiPolygon); not a Feature or FeatureCollection." }, "description": "GeoJSON geometries to combine." } } }, "CombineGeometriesEnvelopeOutput": { "title": "envelope output", "description": "Returns `{ \"type\": \"geojson\", \"data\": Feature }` containing the rectangular Polygon that encloses all input geometries.", "allOf": [ { "$ref": "#/components/schemas/McpGeometryGeojsonResult" } ] }, "CombineGeometriesInput": { "description": "Choose one combination operation. Each branch lists the exact accepted geometry types and limits.", "oneOf": [ { "$ref": "#/components/schemas/CombineGeometriesIntersectionInput" }, { "$ref": "#/components/schemas/CombineGeometriesDifferenceInput" }, { "$ref": "#/components/schemas/CombineGeometriesUnionInput" }, { "$ref": "#/components/schemas/CombineGeometriesEnvelopeInput" } ] }, "CombineGeometriesOutput": { "$ref": "#/components/schemas/McpGeometryGeojsonOrEmptyResult" }, "CombineGeometriesToolCallParams": { "type": "object", "description": "MCP tools/call params for combine_geometries.", "additionalProperties": false, "required": [ "name", "arguments" ], "properties": { "name": { "description": "Registered MCP tool name.", "const": "combine_geometries" }, "arguments": { "description": "Arguments validated by the combine_geometries input schema.", "$ref": "#/components/schemas/CombineGeometriesInput" } } }, "CombineGeometriesToolCallRequest": { "type": "object", "description": "JSON-RPC tools/call request for the combine_geometries MCP tool.", "additionalProperties": false, "required": [ "jsonrpc", "id", "method", "params" ], "properties": { "jsonrpc": { "description": "JSON-RPC protocol version.", "const": "2.0" }, "id": { "description": "Client-supplied JSON-RPC request id echoed in the response.", "$ref": "#/components/schemas/JsonRpcId" }, "method": { "description": "MCP method used to call a tool.", "const": "tools/call" }, "params": { "description": "Tool call parameters for combine_geometries.", "$ref": "#/components/schemas/CombineGeometriesToolCallParams" } }, "examples": [ { "jsonrpc": "2.0", "id": 10, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "intersection", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } }, { "jsonrpc": "2.0", "id": 11, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "difference", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } }, { "jsonrpc": "2.0", "id": 12, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "union", "geometries": [ { "type": "Polygon", "coordinates": [ [ [ 13.38, 52.5 ], [ 13.42, 52.5 ], [ 13.42, 52.54 ], [ 13.38, 52.54 ], [ 13.38, 52.5 ] ] ] }, { "type": "Polygon", "coordinates": [ [ [ 13.4, 52.51 ], [ 13.44, 52.51 ], [ 13.44, 52.55 ], [ 13.4, 52.55 ], [ 13.4, 52.51 ] ] ] } ] } } }, { "jsonrpc": "2.0", "id": 13, "method": "tools/call", "params": { "name": "combine_geometries", "arguments": { "operation": "envelope", "geometries": [ { "type": "Point", "coordinates": [ 13.405, 52.52 ] }, { "type": "LineString", "coordinates": [ [ 13.38, 52.5 ], [ 13.41, 52.53 ], [ 13.44, 52.54 ] ] } ] } } } ], "x-geoapify-mcp-tool": "combine_geometries", "x-geoapify-mcp-category": "Utilities", "x-geoapify-mcp-input-schema": "#/components/schemas/CombineGeometriesInput", "x-geoapify-mcp-output-schema": "#/components/schemas/CombineGeometriesOutput", "x-geoapify-mcp-operations": [ { "name": "intersection", "description": "Return the area shared by all input polygons.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesIntersectionInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesIntersectionOutput" } }, { "name": "difference", "description": "Subtract every later polygon from the first polygon.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesDifferenceInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesDifferenceOutput" } }, { "name": "union", "description": "Merge two or more polygons into their geometric union.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesUnionInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesUnionOutput" } }, { "name": "envelope", "description": "Return a rectangular envelope containing all input geometries.", "inputSchema": { "$ref": "#/components/schemas/CombineGeometriesEnvelopeInput" }, "outputSchema": { "$ref": "#/components/schemas/CombineGeometriesEnvelopeOutput" } } ] }, "CombineGeometriesToolCallSuccessResponse": { "type": "object", "description": "Successful JSON-RPC response with tool-specific structured content.", "required": [ "jsonrpc", "id", "result" ], "properties": { "jsonrpc": { "const": "2.0" }, "id": { "$ref": "#/components/schemas/JsonRpcId" }, "result": { "type": "object", "required": [ "content", "structuredContent", "isError" ], "properties": { "content": { "type": "array", "description": "JSON text representation of structuredContent.", "items": { "type": "object", "required": [ "type", "text" ], "properties": { "type": { "const": "text" }, "text": { "type": "string", "description": "JSON-encoded copy of structuredContent." } } } }, "structuredContent": { "$ref": "#/components/schemas/CombineGeometriesOutput" }, "isError": { "const": false } } } } }, "ToolCallErrorResponse": { "type": "object", "description": "JSON-RPC tools/call response when tool execution fails.", "required": [ "jsonrpc", "id", "result" ], "properties": { "jsonrpc": { "const": "2.0" }, "id": { "$ref": "#/components/schemas/JsonRpcId" }, "result": { "type": "object", "required": [ "content", "isError" ], "properties": { "content": { "type": "array", "description": "Tool error details represented as JSON text.", "items": { "type": "object", "required": [ "type", "text" ], "properties": { "type": { "const": "text" }, "text": { "type": "string", "description": "JSON-encoded GatewayError with statusCode, error, and message fields." } } } }, "isError": { "const": true } } } } }, "CombineGeometriesToolCallResponse": { "oneOf": [ { "$ref": "#/components/schemas/CombineGeometriesToolCallSuccessResponse" }, { "$ref": "#/components/schemas/ToolCallErrorResponse" }, { "$ref": "#/components/schemas/JsonRpcErrorResponse" } ] } }, "securitySchemes": { "ApiKeyInHeader": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Geoapify API key header. Recommended authentication method for MCP clients." } } }, "x-geoapify-mcp-tool-index": "index.json", "security": [ { "ApiKeyInHeader": [] } ] }