Back to Directory/Developer Tools

io.github.daedalus/mcp-epochs

MCP tool that provides current Unix timestamp

Developer ToolsPythonv0.1.0

mcp-epochs

mcp-name: io.github.daedalus/mcp-epochs

MCP tool that provides current Unix timestamp (epochs) to LLMs.

PyPI Python Coverage Ruff

Install

pip install mcp-epochs

Usage

mcp-epochs

This runs the MCP server with STDIO transport. The server provides a get_unix_time tool.

MCP Configuration

{
  "mcpServers": {
    "mcp-epochs": {
      "command": "mcp-epochs"
    }
  }
}

Development

git clone https://github.com/daedalus/mcp-epochs.git
cd mcp-epochs
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

API

get_unix_time()

Returns the current Unix timestamp as a dictionary with the following keys:

  • unix_time (int): Current Unix timestamp in seconds since epoch.
  • unix_time_ms (int): Current Unix timestamp in milliseconds since epoch.
  • iso8601 (str): Current UTC time in ISO 8601 format (e.g., "2026-03-26T21:30:00Z").

run_server()

Starts the MCP server using STDIO transport for local desktop MCP clients.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-epochs

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-daedalus-mcp-epochs": {
      "command": "uvx",
      "args": [
        "mcp-epochs"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-epochspypi

Compatible MCP Clients

io.github.daedalus/mcp-epochs works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More