# agenttime

agenttime — an MCP server with authoritative time across 597 timezones, sunrise and sunset by coordinates (US Naval Observatory), and moon phases. Essential for scheduling, astronomy, and agricultural agents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1319 installs
- Author: heavysword1
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/heavysword1/agenttime
- Updated: 2026-05-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/agenttime

## What it does

agenttime exposes three tools to agents: `get_current_time` retrieves the current time in any timezone with UTC offset, DST status, and week number; `get_astronomy` takes coordinates and returns sunrise, sunset, twilight times, and lunar rise and set using US Naval Observatory data; `get_moon_phases` shows upcoming lunar phases and current illumination percentage.

The server runs over HTTPS with no authentication required—just add it to your IDE config. Compatible with Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed, and Gemini CLI.

## Requirements
- Remote server: `https://agenttime--heavysword1.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http agenttime https://agenttime--heavysword1.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add agenttime --url https://agenttime--heavysword1.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agenttime": {
            "url": "https://agenttime--heavysword1.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agenttime": {
            "type": "http",
            "url": "https://agenttime--heavysword1.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http agenttime https://agenttime--heavysword1.run.tools
```

## When to use it
- get sunrise and sunset times for a specific location
- retrieve the current time in any timezone
- check the moon phase and illumination percentage
- calculate civil and nautical twilight times
- verify daylight saving time status for a region

## Example prompts
- Find the optimal planting time based on sunrise at coordinates 40.7128, -74.0060
- What is the current time in New Delhi and Sydney?
- Show me the moon phase calendar for the next four weeks

## Similar
- [get-current-datetime](https://affpapa.org/en/nevibecode/agents/get-current-datetime.md) — subagent · ★ 2744 repo stars
- [Time (Reference)](https://affpapa.org/en/nevibecode/mcp/time-reference.md) — MCP server · ★ 92149 repo stars
- [time-mcp](https://affpapa.org/en/nevibecode/mcp/time-mcp.md) — MCP server · ★ 72 repo stars
- [time](https://affpapa.org/en/nevibecode/mcp/time.md) — MCP server
- [Open Ephemeris](https://affpapa.org/en/nevibecode/mcp/open-ephemeris.md) — MCP server · ★ 5 repo stars
- [Meeting Intelligence API](https://affpapa.org/en/nevibecode/mcp/meeting-intelligence-api.md) — MCP server · 10853 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
