`get_times_date`

Pack: sunrisesunset · Endpoint: https://gateway.pipeworx.io/sunrisesunset/mcp

Get sunrise, sunset, dawn, dusk, solar noon, and golden hour times for a specific date at a location.

Parameters

Name	Type	Required	Description
`lat`	number	yes	Latitude of the location (e.g., 40.7128)
`lng`	number	yes	Longitude of the location (e.g., -74.0060)
`date`	string	yes	Date in YYYY-MM-DD format (e.g., “2024-06-21”)

Example call

Arguments

{
  "lat": 40.7128,
  "lng": -74.006,
  "date": "2024-06-21"
}

curl

curl -X POST https://gateway.pipeworx.io/sunrisesunset/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_times_date","arguments":{"lat":40.7128,"lng":-74.006,"date":"2024-06-21"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_times_date', {
  "lat": 40.7128,
  "lng": -74.006,
  "date": "2024-06-21"
});

More examples

{
  "lat": 35.6762,
  "lng": 139.6503,
  "date": "2024-12-21"
}

Response shape

Always returns: lat, lng, date, sunrise, sunset, first_light, last_light, dawn, dusk, solar_noon, golden_hour, day_length, timezone, utc_offset

Field	Type	Description
`lat`	number	Latitude of the location
`lng`	number	Longitude of the location
`date`	string	Date in YYYY-MM-DD format
`sunrise`	string	Sunrise time
`sunset`	string	Sunset time
`first_light`	string	First light time
`last_light`	string	Last light time
`dawn`	string	Dawn time
`dusk`	string	Dusk time
`solar_noon`	string	Solar noon time
`golden_hour`	string	Golden hour time
`day_length`	string	Duration of daylight
`timezone`	string	Timezone identifier
`utc_offset`	number	UTC offset in hours

Full JSON Schema

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude of the location"
    },
    "lng": {
      "type": "number",
      "description": "Longitude of the location"
    },
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD format"
    },
    "sunrise": {
      "type": "string",
      "description": "Sunrise time"
    },
    "sunset": {
      "type": "string",
      "description": "Sunset time"
    },
    "first_light": {
      "type": "string",
      "description": "First light time"
    },
    "last_light": {
      "type": "string",
      "description": "Last light time"
    },
    "dawn": {
      "type": "string",
      "description": "Dawn time"
    },
    "dusk": {
      "type": "string",
      "description": "Dusk time"
    },
    "solar_noon": {
      "type": "string",
      "description": "Solar noon time"
    },
    "golden_hour": {
      "type": "string",
      "description": "Golden hour time"
    },
    "day_length": {
      "type": "string",
      "description": "Duration of daylight"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone identifier"
    },
    "utc_offset": {
      "type": "number",
      "description": "UTC offset in hours"
    }
  },
  "required": [
    "lat",
    "lng",
    "date",
    "sunrise",
    "sunset",
    "first_light",
    "last_light",
    "dawn",
    "dusk",
    "solar_noon",
    "golden_hour",
    "day_length",
    "timezone",
    "utc_offset"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "sunrisesunset": {
      "url": "https://gateway.pipeworx.io/sunrisesunset/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_times_date