MCP dla agentów AI

API jest też dostępne jako serwer MCP (Model Context Protocol), dzięki czemu asystenci i agenci AI, tacy jak Claude, ChatGPT czy Cursor, mogą wywoływać je jako wbudowane narzędzie. Dodaj je jako konektor z poniższym adresem URL, bez klucza API i rejestracji:

https://api.sunrise-sunset.org/mcp

To serwer bezstanowy (transport Streamable HTTP) z dwoma narzędziami: get_sun_times zwraca wszystkie dane opisane w dokumentacji API dla jednego dnia, a get_sun_times_range obejmuje do 366 kolejnych dni w jednym wywołaniu. Dane i wymóg podania źródła są takie same jak w pozostałej części API.

Jak się połączyć

• W Claude (claude.ai lub aplikacji): Settings → Connectors → Add custom connector i wklej powyższy adres URL.
• W Claude Code, w terminalu:

  claude mcp add --transport http sunrise-sunset https://api.sunrise-sunset.org/mcp

• W ChatGPT: Settings → Apps & Connectors → Advanced settings → Developer mode, a następnie dodaj adres URL jako własny konektor.
• W Codex, w terminalu:

  codex mcp add sunrise-sunset --url https://api.sunrise-sunset.org/mcp

• W Cursor dodaj do ~/.cursor/mcp.json (lub .cursor/mcp.json w projekcie):

  { "mcpServers": { "sunrise-sunset": { "url": "https://api.sunrise-sunset.org/mcp" } } }

• Działa też każdy inny klient zgodny z MCP: to standardowy zdalny serwer MCP przez Streamable HTTP, bez uwierzytelniania.

O co zapytać po połączeniu

• “Kiedy jutro przypada złota godzina w miejscowości Paryż?”
• “O ile skraca się dzień w listopadzie w miejscowości Oslo?”
• “Które noce w tym miesiącu będą najciemniejsze do obserwacji gwiazd na wyspie Teneryfa?”

Narzędzia zwracają te same dane co nasze API wschodu i zachodu słońca: obowiązują wszystkie opisane tam definicje pól.

Usługa jest bezpłatna i wymaga podania źródła tak samo jak API: wskaż sunrise-sunset.org w widocznym miejscu, aby odbiorcy wiedzieli, skąd pochodzą dane (szczegóły).

Kontakt

W sprawach dotyczących API skontaktuj się z nami.