---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/sunrise-sunset
---
# Sunrise & Sunset

Precise solar times for any city or GPS coordinate on any date. Returns sunrise, sunset, solar noon, twilight phases, day length, and golden hour windows. For photographers, outdoor apps, and travel planners.

- **Version:** 0.02
- **Categories:** data

## Skills (1)

### Sunrise & Sunset Times (`times`)

Get sunrise, sunset, twilight times, day length, and golden hour windows for any location and date. Supports city names or coordinates.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | City name or coordinates as "lat,lon" (e.g. "Paris" or "48.8566,2.3522") |
| `date` | string | No | Date in YYYY-MM-DD format or "today" (default: today) |

**Returns:** Sunrise, sunset, twilight times, day length, and golden hour windows

**Examples:**

*Sunrise and sunset in Paris:*

```json
{
  "location": "Paris"
}
```

*Sun times for a specific date:*

```json
{
  "location": "Tokyo",
  "date": "2026-06-21"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call sunrise-sunset times --location Paris

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"sunrise-sunset","skill":"times","input":{"location":"Paris"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### Can I use a city name or do I need coordinates?

Either works. Pass a city name or `lat,lon` coordinates as the location.

### Can I check solar times for a specific date?

Yes. Add a `date` in `YYYY-MM-DD` format. If you leave it out, the tool uses today.

### Does it return twilight and golden hour too?

Yes. It includes civil, nautical, and astronomical twilight, plus morning and evening golden hour windows.

### Can I reuse the same location without typing it every time?

Yes. You can save a default latitude and longitude as credentials and reuse them for repeat checks.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs