> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# weather

> Current conditions and multi-day forecasts for any location worldwide

**Server path:** `/weather` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                                            | Description                                                                                         |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [`weather_get_current`](#weather_get_current)   | Get current weather conditions for a location. Provide either a city name or lat/lon coordinates.   |
| [`weather_get_forecast`](#weather_get_forecast) | Get a multi-day weather forecast for a location. Provide either a city name or lat/lon coordinates. |

***

## weather\_get\_current

Get current weather conditions for a location. Provide either a city name or lat/lon coordinates.

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                        |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `city`    | string | No       | —       | City name to look up (e.g., "London", "New York", "Tokyo"). Required if lat/lon not provided. If ambiguous, include country (e.g., "Portland, US") |
| `lat`     | number | No       | —       | Latitude of the location (e.g., 51.5074 for London). Required if city not provided                                                                 |
| `lon`     | number | No       | —       | Longitude of the location (e.g., -0.1278 for London). Required if city not provided                                                                |
| `units`   | string | No       | —       | Unit system: "metric" (Celsius, km/h) or "imperial" (Fahrenheit, mph). Defaults to metric                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "description": "City name to look up (e.g., \"London\", \"New York\", \"Tokyo\"). Required if lat/lon not provided. If ambiguous, include country (e.g., \"Portland, US\")"
      },
      "lat": {
        "type": "number",
        "description": "Latitude of the location (e.g., 51.5074 for London). Required if city not provided"
      },
      "lon": {
        "type": "number",
        "description": "Longitude of the location (e.g., -0.1278 for London). Required if city not provided"
      },
      "units": {
        "type": "string",
        "enum": [
          "metric",
          "imperial"
        ],
        "description": "Unit system: \"metric\" (Celsius, km/h) or \"imperial\" (Fahrenheit, mph). Defaults to metric"
      }
    }
  }
  ```
</Expandable>

***

## weather\_get\_forecast

Get a multi-day weather forecast for a location. Provide either a city name or lat/lon coordinates.

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                                                                                        |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `city`    | string | No       | —       | City name to look up (e.g., "London", "New York", "Tokyo"). Required if lat/lon not provided. If ambiguous, include country (e.g., "Portland, US") |
| `lat`     | number | No       | —       | Latitude of the location (e.g., 51.5074 for London). Required if city not provided                                                                 |
| `lon`     | number | No       | —       | Longitude of the location (e.g., -0.1278 for London). Required if city not provided                                                                |
| `days`    | number | No       | —       | Number of forecast days (1-7). Defaults to 3                                                                                                       |
| `units`   | string | No       | —       | Unit system: "metric" (Celsius, km/h) or "imperial" (Fahrenheit, mph). Defaults to metric                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "city": {
        "type": "string",
        "description": "City name to look up (e.g., \"London\", \"New York\", \"Tokyo\"). Required if lat/lon not provided. If ambiguous, include country (e.g., \"Portland, US\")"
      },
      "lat": {
        "type": "number",
        "description": "Latitude of the location (e.g., 51.5074 for London). Required if city not provided"
      },
      "lon": {
        "type": "number",
        "description": "Longitude of the location (e.g., -0.1278 for London). Required if city not provided"
      },
      "days": {
        "type": "number",
        "description": "Number of forecast days (1-7). Defaults to 3"
      },
      "units": {
        "type": "string",
        "enum": [
          "metric",
          "imperial"
        ],
        "description": "Unit system: \"metric\" (Celsius, km/h) or \"imperial\" (Fahrenheit, mph). Defaults to metric"
      }
    }
  }
  ```
</Expandable>