# coldHat

> coldHat is a free MCP server for ai models and llm tooling. Load anyone's public AI working rules from a GitHub repo into any chat by name. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://coldhat.f-keys.com
- **Repository:** https://github.com/vince-gonzalez/coldhat
- **MCP Registry name:** io.github.vince-gonzalez/coldhat
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

coldHat starts from a simple problem: your instructions to an assistant live in one app and get lost in the next. A hat is a hat.md file in a public GitHub repository named coldhat, so only its owner can change it. The assistant reads it, answers with a short hat code to prove it did, and follows the rules for the rest of the chat.

Every hat ends with a seal, a second code on its last line. If the assistant cannot quote it, the hat was cut off and it says so. Hats can be stacked up to three at a time with later layers winning, and an amp/ prefix compiles a stack deterministically, resolving conflicts between rules before the model sees them without a second model call. The site reports merged stacks kept the right output format 63 of 64 times in its test, against 4 of 64 for plain stacks.

It can also wear Fabric patterns and prompts.chat prompts, and the site offers a prompt grader and a consensus hat built from 195 public prompt templates. Teams get locked rules and commit-pinned versions. Connector users call the wear_hat and wear_stack tools.

## Features

- **Hat by GitHub name:** Wear anyone's public hat.md with one line, or add the connector once.
- **Cut-off detection:** A closing seal reveals when a hat arrived truncated.
- **Stacking:** Combine up to three pieces; later layers win where they conflict.
- **Deterministic merge:** The amp/ prefix resolves rule conflicts without a second model call.
- **Locked rules and pins:** Rules under ## Locked cannot be overridden; @commit pins an exact version.
- **Prompt grader:** Paste a system prompt to find contradictions, repeats and rules lost to truncation.

## Good for

- Carry the same working rules from Claude to ChatGPT or Grok
- Share a team style guide as a pinned, verifiable prompt
- Check whether an assistant's reply used the current version of a hat
- Combine a Fabric pattern with your own editing rules

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http coldhat https://coldhat.f-keys.com/mcp
```

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

```sh
https://coldhat.f-keys.com/mcp
```

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

```json
{
  "mcpServers": {
    "coldhat": {
      "url": "https://coldhat.f-keys.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "coldhat": {
      "type": "http",
      "url": "https://coldhat.f-keys.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "coldhat": {
      "serverUrl": "https://coldhat.f-keys.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "coldhat": {
      "type": "http",
      "url": "https://coldhat.f-keys.com/mcp"
    }
  }
}
```

## Tools

- `wear_hat`: Load a hat by address.
- `wear_stack`: Load a stack of up to three hats.

## FAQ

### Which chats can read a hat from its address?

Claude, ChatGPT and Grok read it; Gemini and Perplexity need the hat pasted instead (tested 2026-10-10).

### Who can change my hat?

Only you, because it lives in your public coldhat repository.

### Does it cost anything?

The site describes it as public with no install, and no prices are listed.

### How do I verify a reply?

Send the reply to coldhat.f-keys.com/verify with the hat address; it reports verified, stale or cut off.

### Is coldHat free?

Yes. coldHat is free to use.

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

Run this command in your terminal: claude mcp add --transport http coldhat https://coldhat.f-keys.com/mcp

### What are the best alternatives to coldHat?

The closest alternatives to coldHat are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

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