# HammerTime

> HammerTime is an open-source MCP server for communication. Generate Discord timestamps and manage HammerTime bot settings from an AI client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web, discord
- **Website:** https://hammertime.cyou/en/api
- **Repository:** https://github.com/wentthefox/hammertimebot/tree/HEAD/packages/api
- **MCP Registry name:** io.github.WentTheFox/hammertime
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-15

## About

Every MCP tool is a HammerTime bot command with the same name and options. The commands are at, at12, iso, unix, in, ago, add, subtract and snowflake, and each returns the time in every Discord timestamp format along with the exact interpreted time and zone. Options you leave out fall back to the saved settings of the Discord account the key belongs to, such as time zone.

Auth uses a bearer key made on the HammerTime website, one per linked Discord account, with permissions timestamps:create, settings:read and settings:write. Reading and patching settings works through REST; the same keys call /mcp. Limits default to 60 requests a minute per key with a burst of half that, shared across REST and MCP, and responses carry RateLimit headers.

Use is counted like bot commands unless you turn telemetry off in your app settings. The project says it is not affiliated with Discord.

## Features

- **Bot commands as tools:** Nine timestamp commands match the bot one to one.
- **All Discord formats:** Replies include every timestamp format, or the one you request.
- **Account settings:** Read and change the bot settings of the linked account.
- **Scoped API keys:** Permissions are limited to timestamps and settings.
- **Rate-limit headers:** Remaining quota and Retry-After are reported.
- **OpenAPI docs:** Swagger UI and an OpenAPI document are served.

## Good for

- Turn "6:30pm Friday my time" into a Discord timestamp
- Schedule an announcement with a relative timestamp
- Convert a Unix time or snowflake to a readable date
- Adjust the saved time zone from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hammertime https://api.hammertime.cyou/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.hammertime.cyou/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hammertime": {
      "url": "https://api.hammertime.cyou/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hammertime": {
      "type": "http",
      "url": "https://api.hammertime.cyou/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hammertime": {
      "serverUrl": "https://api.hammertime.cyou/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hammertime": {
      "type": "http",
      "url": "https://api.hammertime.cyou/mcp"
    }
  }
}
```

## Tools

- `at`: Timestamp for a time of day.
- `at12`: Timestamp from a 12-hour time.
- `iso`: Timestamp from an ISO date.
- `unix`: Timestamp from a Unix time.
- `in`: Timestamp a duration from now.
- `ago`: Timestamp a duration in the past.
- `add`: Add a duration to a time.
- `subtract`: Subtract a duration from a time.
- `snowflake`: Timestamp from a Discord snowflake.

## FAQ

### How do I authenticate?

Create a key on the HammerTime website and send it as a bearer token.

### What is the rate limit?

60 requests per minute per key on average, burst of half, shared by REST and MCP.

### Is it affiliated with Discord?

No.

### Is telemetry on?

Runs are counted unless you turn telemetry off.

### Is HammerTime free?

Yes. HammerTime is open source, so you can use and self-host it for free.

### How do I add HammerTime to Claude Code?

Run this command in your terminal: claude mcp add --transport http hammertime https://api.hammertime.cyou/mcp

### What are the best alternatives to HammerTime?

The closest alternatives to HammerTime are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/hammertime
