CalculateRouteMatrixToolCallRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/geoapify/json-schema/geoapify-calculate-route-matrix-tool-call-request-schema.json",
  "title": "CalculateRouteMatrixToolCallRequest",
  "description": "JSON-RPC tools/call request for the calculate_route_matrix MCP tool.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/geoapify-routing-api-openapi.yml#/components/schemas/CalculateRouteMatrixToolCallRequest",
  "type": "object",
  "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": "#/$defs/JsonRpcId"
    },
    "method": {
      "description": "MCP method used to call a tool.",
      "const": "tools/call"
    },
    "params": {
      "description": "Tool call parameters for calculate_route_matrix.",
      "$ref": "#/$defs/CalculateRouteMatrixToolCallParams"
    }
  },
  "x-geoapify-mcp-tool": "calculate_route_matrix",
  "x-geoapify-mcp-category": "Routing",
  "x-geoapify-mcp-input-schema": "#/components/schemas/CalculateRouteMatrixInput",
  "x-geoapify-mcp-output-schema": "#/components/schemas/CalculateRouteMatrixOutput",
  "$defs": {
    "CalculateRouteMatrixInput": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "sources"
      ],
      "properties": {
        "sources": {
          "type": "array",
          "minItems": 1,
          "maxItems": 1000,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "lat",
              "lon"
            ],
            "properties": {
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "description": "Location latitude."
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "description": "Location longitude."
              }
            }
          },
          "description": "Matrix source locations. sources.length multiplied by targets.length must not exceed 1000."
        },
        "targets": {
          "type": "array",
          "minItems": 1,
          "maxItems": 1000,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "lat",
              "lon"
            ],
            "properties": {
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90,
                "description": "Location latitude."
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180,
                "description": "Location longitude."
              }
            }
          },
          "description": "Matrix target locations. Defaults to the source locations when omitted. sources.length multiplied by targets.length must not exceed 1000."
        },
        "mode": {
          "type": "string",
          "enum": [
            "drive",
            "truck",
            "light_truck",
            "medium_truck",
            "bus",
            "motorcycle",
            "scooter",
            "bicycle",
            "walk",
            "hike"
          ],
          "default": "drive",
          "description": "Travel or vehicle mode used to calculate the matrix."
        },
        "type": {
          "type": "string",
          "enum": [
            "balanced",
            "short",
            "less_maneuvers"
          ],
          "default": "balanced",
          "description": "Route optimization preference."
        },
        "traffic": {
          "type": "string",
          "enum": [
            "free_flow",
            "approximated"
          ],
          "default": "free_flow",
          "description": "Traffic model used for motorized routing."
        },
        "avoid": {
          "type": "array",
          "maxItems": 3,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "tolls",
              "highways",
              "ferries"
            ]
          },
          "description": "Route features to avoid. Supported values are \"tolls\", \"highways\", and \"ferries\"."
        },
        "units": {
          "type": "string",
          "enum": [
            "metric",
            "imperial"
          ],
          "default": "metric",
          "description": "Distance and speed units."
        }
      }
    },
    "CalculateRouteMatrixToolCallParams": {
      "type": "object",
      "description": "MCP tools/call params for calculate_route_matrix.",
      "additionalProperties": false,
      "required": [
        "name",
        "arguments"
      ],
      "properties": {
        "name": {
          "description": "Registered MCP tool name.",
          "const": "calculate_route_matrix"
        },
        "arguments": {
          "description": "Arguments validated by the calculate_route_matrix input schema.",
          "$ref": "#/$defs/CalculateRouteMatrixInput"
        }
      }
    },
    "JsonRpcId": {
      "description": "JSON-RPC request identifier. The server echoes this value in the response.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    }
  }
}