{
  "openapi": "3.1.0",
  "info": {
    "title": "Geoapify MCP Tool: Places: Search Reachable Places",
    "version": "1.3.0",
    "description": "AI-focused, tool-specific OpenAPI specification for search_reachable_places over the Geoapify JSON-RPC transport. Import this specification when an integration needs this tool without the full MCP catalog.",
    "contact": {
      "name": "Geoapify",
      "url": "https://geoapify.com",
      "email": "info@geoapify.com"
    }
  },
  "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": "Places",
      "description": "Places MCP tools."
    }
  ],
  "paths": {
    "/mcp": {
      "post": {
        "tags": [
          "Places"
        ],
        "operationId": "callSearchReachablePlaces",
        "summary": "Places: Search Reachable Places",
        "description": "Use this tool to find places of one supported category inside a travel-time or travel-distance isoline from an origin. Calculates the area and applies it to the Places search before limiting results. Results describe area membership, not individual journey times; use calculate_route_matrix for travel-time ranking. Call list_place_categories first to get the supported category values.",
        "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/SearchReachablePlacesToolCallRequest"
              },
              "examples": {
                "searchReachablePlacesTime": {
                  "summary": "Find pharmacies within a 15-minute drive",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "tools/call",
                    "params": {
                      "name": "search_reachable_places",
                      "arguments": {
                        "origin": {
                          "lat": 36.9743711,
                          "lon": -76.4166222
                        },
                        "type": "time",
                        "range": 900,
                        "category": "healthcare.pharmacy",
                        "mode": "drive",
                        "limit": 20
                      }
                    }
                  }
                },
                "searchReachablePlacesDistance": {
                  "summary": "Find restaurants within a 2-kilometer walk",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 2,
                    "method": "tools/call",
                    "params": {
                      "name": "search_reachable_places",
                      "arguments": {
                        "origin": {
                          "lat": 36.9743711,
                          "lon": -76.4166222
                        },
                        "type": "distance",
                        "range": 2000,
                        "category": "catering.restaurant",
                        "mode": "walk",
                        "include_geometry": true
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response for the search_reachable_places MCP tool. Tool execution and validation failures also use HTTP 200 with result.isError set to true.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchReachablePlacesToolCallResponse"
                },
                "examples": {
                  "searchReachablePlacesSuccess": {
                    "summary": "Places in a reachable area",
                    "description": "Illustrative response for a category search within a 15-minute drive.",
                    "value": {
                      "jsonrpc": "2.0",
                      "id": 1,
                      "result": {
                        "content": [
                          {
                            "type": "text",
                            "text": "{\"reachability\":{\"origin\":{\"lat\":36.9743711,\"lon\":-76.4166222},\"type\":\"time\",\"range\":900,\"range_units\":\"seconds\",\"mode\":\"drive\",\"units\":\"metric\",\"route_type\":\"balanced\",\"traffic\":\"free_flow\"},\"category\":\"healthcare.pharmacy\",\"count\":1,\"results\":[{\"name\":\"Example Pharmacy\",\"lat\":36.98,\"lon\":-76.42,\"categories\":[\"healthcare.pharmacy\"]}]}"
                          }
                        ],
                        "structuredContent": {
                          "reachability": {
                            "origin": {
                              "lat": 36.9743711,
                              "lon": -76.4166222
                            },
                            "type": "time",
                            "range": 900,
                            "range_units": "seconds",
                            "mode": "drive",
                            "units": "metric",
                            "route_type": "balanced",
                            "traffic": "free_flow"
                          },
                          "category": "healthcare.pharmacy",
                          "count": 1,
                          "results": [
                            {
                              "name": "Example Pharmacy",
                              "lat": 36.98,
                              "lon": -76.42,
                              "categories": [
                                "healthcare.pharmacy"
                              ]
                            }
                          ]
                        },
                        "isError": false
                      }
                    }
                  }
                }
              }
            }
          },
          "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": "search_reachable_places",
        "x-geoapify-mcp-input-schema": "#/components/schemas/SearchReachablePlacesInput",
        "x-geoapify-mcp-output-schema": "#/components/schemas/SearchReachablePlacesOutput"
      }
    }
  },
  "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."
          }
        }
      },
      "SearchReachablePlacesInput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "origin",
          "type",
          "range",
          "category"
        ],
        "properties": {
          "origin": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "lat",
              "lon"
            ],
            "properties": {
              "lat": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "lon": {
                "type": "number",
                "minimum": -180,
                "maximum": 180
              }
            },
            "description": "Origin from which travel reachability is calculated."
          },
          "type": {
            "type": "string",
            "enum": [
              "time",
              "distance"
            ],
            "description": "Time in seconds, or distance in meters (metric) or miles (imperial)."
          },
          "mode": {
            "type": "string",
            "enum": [
              "drive",
              "light_truck",
              "medium_truck",
              "truck",
              "heavy_truck",
              "truck_dangerous_goods",
              "long_truck",
              "bus",
              "scooter",
              "motorcycle",
              "bicycle",
              "mountain_bike",
              "road_bike",
              "walk",
              "hike",
              "transit",
              "approximated_transit"
            ],
            "default": "drive",
            "description": "Travel or vehicle mode."
          },
          "units": {
            "type": "string",
            "enum": [
              "metric",
              "imperial"
            ],
            "default": "metric"
          },
          "route_type": {
            "type": "string",
            "enum": [
              "balanced",
              "short",
              "less_maneuvers"
            ],
            "default": "balanced"
          },
          "traffic": {
            "type": "string",
            "enum": [
              "free_flow",
              "approximated"
            ],
            "default": "free_flow"
          },
          "avoid": {
            "type": "array",
            "maxItems": 3,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "tolls",
                "ferries",
                "highways"
              ]
            }
          },
          "max_speed": {
            "type": "number",
            "minimum": 6.5,
            "maximum": 252,
            "description": "Maximum speed: 10–252 km/h for metric, or 6.5–155 mph for imperial."
          },
          "range": {
            "type": "number",
            "minimum": 1,
            "description": "Travel limit in seconds for time, meters for metric distance, or miles for imperial distance. Gateway account limits apply."
          },
          "category": {
            "type": "string",
            "minLength": 3,
            "maxLength": 64,
            "pattern": "^[a-z0-9_-]+(?:\\.[a-z0-9_-]+)*$",
            "description": "One supported place category. Call list_place_categories first to get the supported category values."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20,
            "description": "Maximum number of places to return."
          },
          "lang": {
            "type": "string",
            "default": "en",
            "description": "Result language as a supported two-letter language code."
          },
          "include_geometry": {
            "type": "boolean",
            "default": false,
            "description": "Include the calculated isoline GeoJSON FeatureCollection."
          }
        }
      },
      "SearchReachablePlacesOutput": {
        "type": "object",
        "required": [
          "reachability",
          "category",
          "count",
          "results"
        ],
        "properties": {
          "reachability": {
            "type": "object",
            "required": [
              "origin",
              "type",
              "range",
              "range_units",
              "mode",
              "units",
              "route_type",
              "traffic"
            ],
            "properties": {
              "origin": {
                "type": "object",
                "required": [
                  "lat",
                  "lon"
                ],
                "properties": {
                  "lat": {
                    "type": "number",
                    "minimum": -90,
                    "maximum": 90
                  },
                  "lon": {
                    "type": "number",
                    "minimum": -180,
                    "maximum": 180
                  }
                },
                "description": "Origin from which travel reachability is calculated."
              },
              "type": {
                "type": "string",
                "enum": [
                  "time",
                  "distance"
                ],
                "description": "Time in seconds, or distance in meters (metric) or miles (imperial)."
              },
              "mode": {
                "type": "string",
                "enum": [
                  "drive",
                  "light_truck",
                  "medium_truck",
                  "truck",
                  "heavy_truck",
                  "truck_dangerous_goods",
                  "long_truck",
                  "bus",
                  "scooter",
                  "motorcycle",
                  "bicycle",
                  "mountain_bike",
                  "road_bike",
                  "walk",
                  "hike",
                  "transit",
                  "approximated_transit"
                ],
                "default": "drive",
                "description": "Travel or vehicle mode."
              },
              "units": {
                "type": "string",
                "enum": [
                  "metric",
                  "imperial"
                ],
                "default": "metric"
              },
              "route_type": {
                "type": "string",
                "enum": [
                  "balanced",
                  "short",
                  "less_maneuvers"
                ],
                "default": "balanced"
              },
              "traffic": {
                "type": "string",
                "enum": [
                  "free_flow",
                  "approximated"
                ],
                "default": "free_flow"
              },
              "avoid": {
                "type": "array",
                "maxItems": 3,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "enum": [
                    "tolls",
                    "ferries",
                    "highways"
                  ]
                }
              },
              "max_speed": {
                "type": "number",
                "minimum": 6.5,
                "maximum": 252,
                "description": "Maximum speed: 10–252 km/h for metric, or 6.5–155 mph for imperial."
              },
              "range": {
                "type": "number",
                "minimum": 1,
                "description": "Travel limit in seconds for time, meters for metric distance, or miles for imperial distance. Gateway account limits apply."
              },
              "range_units": {
                "type": "string",
                "enum": [
                  "seconds",
                  "meters",
                  "miles"
                ]
              }
            }
          },
          "category": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "minimum": 0
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Public place properties after the MCP compact-output filters are applied.",
              "properties": {
                "name": {
                  "type": "string"
                },
                "continent": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "country_code": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "state_code": {
                  "type": "string"
                },
                "state_COG": {
                  "type": "string"
                },
                "department_COG": {
                  "type": "string"
                },
                "state_district": {
                  "type": "string"
                },
                "province": {
                  "type": "string"
                },
                "department": {
                  "type": "string"
                },
                "arrondissement": {
                  "type": "string"
                },
                "county": {
                  "type": "string"
                },
                "county_code": {
                  "type": "string"
                },
                "county_district": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "city_district": {
                  "type": "string"
                },
                "postcode": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "openGeoDB:postal_codes": {
                  "type": "string"
                },
                "district": {
                  "type": "string"
                },
                "suburb": {
                  "type": "string"
                },
                "municipality": {
                  "type": "string"
                },
                "commune": {
                  "type": "string"
                },
                "subdistrict": {
                  "type": "string"
                },
                "city_block": {
                  "type": "string"
                },
                "neighbourhood": {
                  "type": "string"
                },
                "quarter": {
                  "type": "string"
                },
                "section": {
                  "type": "string"
                },
                "sector": {
                  "type": "string"
                },
                "subdivision": {
                  "type": "string"
                },
                "croft": {
                  "type": "string"
                },
                "allotments": {
                  "type": "string"
                },
                "residental": {
                  "type": "string"
                },
                "farm": {
                  "type": "string"
                },
                "farmyard": {
                  "type": "string"
                },
                "industrial": {
                  "type": "string"
                },
                "retail": {
                  "type": "string"
                },
                "borough": {
                  "type": "string"
                },
                "town": {
                  "type": "string"
                },
                "township": {
                  "type": "string"
                },
                "village": {
                  "type": "string"
                },
                "hamlet": {
                  "type": "string"
                },
                "locality": {
                  "type": "string"
                },
                "isolated_dwelling": {
                  "type": "string"
                },
                "street": {
                  "type": "string"
                },
                "road": {
                  "type": "string"
                },
                "footway": {
                  "type": "string"
                },
                "pedestrian": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                },
                "housenumber": {
                  "type": "string"
                },
                "house_number": {
                  "type": "string"
                },
                "house_name": {
                  "type": "string"
                },
                "old_name": {
                  "type": "string"
                },
                "other": {
                  "type": "string"
                },
                "formatted": {
                  "type": "string"
                },
                "unlocode": {
                  "type": "string"
                },
                "iso3166_sublevel": {
                  "type": "string"
                },
                "plus_code": {
                  "type": "string"
                },
                "plus_code_short": {
                  "type": "string"
                },
                "website": {
                  "type": "string"
                },
                "opening_hours": {
                  "type": "string"
                },
                "opening_hours_covid19": {
                  "type": "string"
                },
                "brand": {
                  "type": "string"
                },
                "operator": {
                  "type": "string"
                },
                "branch": {
                  "type": "string"
                },
                "network": {
                  "type": "string"
                },
                "owner": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "craft": {
                  "type": "string"
                },
                "ref": {
                  "type": "string"
                },
                "int_ref": {
                  "type": "string"
                },
                "ele": {
                  "type": "string"
                },
                "color": {
                  "type": "string"
                },
                "water_source": {
                  "type": "string"
                },
                "postcodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "other_names": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "population": {
                  "oneOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "object",
                      "required": [
                        "actual",
                        "by_years"
                      ],
                      "properties": {
                        "actual": {
                          "type": "string"
                        },
                        "by_years": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  ]
                },
                "lon": {
                  "type": "number",
                  "minimum": -180,
                  "maximum": 180
                },
                "lat": {
                  "type": "number",
                  "minimum": -90,
                  "maximum": 90
                },
                "parent_as_place_id": {
                  "type": "boolean"
                },
                "timezone": {
                  "type": "object",
                  "required": [
                    "name",
                    "offset_STD",
                    "offset_DST",
                    "offset_STD_seconds",
                    "offset_DST_seconds"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "name_alt": {
                      "type": "string"
                    },
                    "country_codes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "offset_STD": {
                      "type": "string"
                    },
                    "offset_DST": {
                      "type": "string"
                    },
                    "offset_STD_seconds": {
                      "type": "number"
                    },
                    "offset_DST_seconds": {
                      "type": "number"
                    },
                    "abbreviation_STD": {
                      "type": "string"
                    },
                    "abbreviation_DST": {
                      "type": "string"
                    }
                  }
                },
                "website_other": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "website_international": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "description_international": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "name_international": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "cuisine_international": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "ref_other": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "disused": {
                  "type": "boolean"
                },
                "commercial": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "additionalProperties": true
                    }
                  ]
                },
                "payment_options": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  }
                },
                "recycling_options": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  }
                },
                "fuel_options": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  }
                },
                "targeted_for": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  }
                },
                "socket_options": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "additionalProperties": true
                  }
                },
                "distance": {
                  "type": "number"
                },
                "categories": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "datasource": {
                  "type": "object",
                  "properties": {
                    "sourcename": {
                      "type": "string"
                    },
                    "attribution": {
                      "type": "string"
                    },
                    "license": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                },
                "mappedTo": {
                  "type": "object",
                  "properties": {
                    "lon": {
                      "type": "number",
                      "minimum": -180,
                      "maximum": 180
                    },
                    "lat": {
                      "type": "number",
                      "minimum": -90,
                      "maximum": 90
                    }
                  }
                },
                "place_id": {
                  "type": "string",
                  "minLength": 3,
                  "maxLength": 2048
                },
                "brand_details": {
                  "type": "object",
                  "additionalProperties": true
                },
                "operator_details": {
                  "type": "object",
                  "additionalProperties": true
                },
                "network_details": {
                  "type": "object",
                  "additionalProperties": true
                },
                "owner_details": {
                  "type": "object",
                  "additionalProperties": true
                },
                "name_other": {
                  "type": "object",
                  "additionalProperties": true
                },
                "contact": {
                  "type": "object",
                  "additionalProperties": true
                },
                "facilities": {
                  "type": "object",
                  "additionalProperties": true
                },
                "wiki_and_media": {
                  "type": "object",
                  "additionalProperties": true
                },
                "historic": {
                  "type": "object",
                  "additionalProperties": true
                },
                "heritage": {
                  "type": "object",
                  "additionalProperties": true
                },
                "artwork": {
                  "type": "object",
                  "additionalProperties": true
                },
                "accommodation": {
                  "type": "object",
                  "additionalProperties": true
                },
                "catering": {
                  "type": "object",
                  "additionalProperties": true
                },
                "parking": {
                  "type": "object",
                  "additionalProperties": true
                },
                "airport": {
                  "type": "object",
                  "additionalProperties": true
                },
                "power": {
                  "type": "object",
                  "additionalProperties": true
                },
                "way": {
                  "type": "object",
                  "additionalProperties": true
                },
                "building": {
                  "type": "object",
                  "additionalProperties": true
                },
                "place_of_worship": {
                  "type": "object",
                  "additionalProperties": true
                },
                "fire_hydrant": {
                  "type": "object",
                  "additionalProperties": true
                },
                "defibrilator": {
                  "type": "object",
                  "additionalProperties": true
                },
                "restrictions": {
                  "type": "object",
                  "additionalProperties": true
                },
                "production": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            },
            "description": "Places within the isoline, ordered by proximity and relevance, not travel time. The limit applies after the geographic filter."
          },
          "isoline": {
            "type": "object",
            "description": "GeoJSON FeatureCollection with one Polygon or MultiPolygon Feature per requested range, or no features when no area is reachable. Collection and feature properties contain the isoline ID; feature properties identify the origin, mode, type, and range."
          }
        }
      },
      "SearchReachablePlacesToolCallParams": {
        "type": "object",
        "description": "MCP tools/call params for search_reachable_places.",
        "additionalProperties": false,
        "required": [
          "name",
          "arguments"
        ],
        "properties": {
          "name": {
            "description": "Registered MCP tool name.",
            "const": "search_reachable_places"
          },
          "arguments": {
            "description": "Arguments validated by the search_reachable_places input schema.",
            "$ref": "#/components/schemas/SearchReachablePlacesInput"
          }
        }
      },
      "SearchReachablePlacesToolCallRequest": {
        "type": "object",
        "description": "JSON-RPC tools/call request for the search_reachable_places 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 search_reachable_places.",
            "$ref": "#/components/schemas/SearchReachablePlacesToolCallParams"
          }
        },
        "examples": [
          {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "search_reachable_places",
              "arguments": {
                "origin": {
                  "lat": 36.9743711,
                  "lon": -76.4166222
                },
                "type": "time",
                "range": 900,
                "category": "healthcare.pharmacy",
                "mode": "drive",
                "limit": 20
              }
            }
          },
          {
            "jsonrpc": "2.0",
            "id": 2,
            "method": "tools/call",
            "params": {
              "name": "search_reachable_places",
              "arguments": {
                "origin": {
                  "lat": 36.9743711,
                  "lon": -76.4166222
                },
                "type": "distance",
                "range": 2000,
                "category": "catering.restaurant",
                "mode": "walk",
                "include_geometry": true
              }
            }
          }
        ],
        "x-geoapify-mcp-tool": "search_reachable_places",
        "x-geoapify-mcp-category": "Places",
        "x-geoapify-mcp-input-schema": "#/components/schemas/SearchReachablePlacesInput",
        "x-geoapify-mcp-output-schema": "#/components/schemas/SearchReachablePlacesOutput"
      },
      "SearchReachablePlacesToolCallSuccessResponse": {
        "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/SearchReachablePlacesOutput"
              },
              "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
              }
            }
          }
        }
      },
      "SearchReachablePlacesToolCallResponse": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/SearchReachablePlacesToolCallSuccessResponse"
          },
          {
            "$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": []
    }
  ]
}
