# Htmlentities

> Htmlentities is a freemium MCP server for developer tools. Encodes and decodes HTML entities via a Pipeworx MCP endpoint, for AI clients. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/htmlentities
- **Repository:** https://github.com/pipeworx-io/mcp-htmlentities
- **MCP Registry name:** io.github.pipeworx-io/htmlentities
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The Pipeworx HTML entities server gives an MCP client two tools: one escapes text into HTML entities, with a basic mode for the core characters and an extended mode that also converts every non-ASCII character to a numeric entity. The other decodes named entities such as ampersand-amp and numeric forms in decimal or hexadecimal back into plain text.

The README describes the two tools as keyless and offline in their own behaviour, though the connection itself runs through the hosted Pipeworx gateway, which needs network access. Without an API key calls are anonymous and capped daily; a free account raises the cap, and the README says calls are metered the same way as the hosted connection.

The endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the two entity tools. The npm bridge can be set to list only this pack's tools. It suits developers and agent builders who want encoding and decoding available as tool calls inside an MCP-compatible assistant.

## Features

- **Basic HTML escaping:** Escapes ampersands, angle brackets, double quotes and single quotes by default.
- **Extended numeric encoding:** Optional mode converts every non-ASCII character into a numeric entity.
- **Named and numeric decoding:** Turns named and decimal or hexadecimal numeric entities back into plain text.
- **Remote and npm connection:** Connects over streamable HTTP or through a local npx stdio bridge.
- **Optional API key:** A free Pipeworx key raises the daily call cap for anonymous use.

## Good for

- Escaping user-supplied text before inserting it into HTML from an AI agent
- Decoding entity-encoded strings returned by scraped web pages
- Converting non-ASCII text into numeric entities for legacy HTML templates
- Testing entity handling inside an MCP-enabled assistant workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http htmlentities https://gateway.pipeworx.io/htmlentities/mcp
```

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

```sh
https://gateway.pipeworx.io/htmlentities/mcp
```

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

```json
{
  "mcpServers": {
    "htmlentities": {
      "url": "https://gateway.pipeworx.io/htmlentities/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "htmlentities": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/htmlentities/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "htmlentities": {
      "serverUrl": "https://gateway.pipeworx.io/htmlentities/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "htmlentities": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/htmlentities/mcp"
    }
  }
}
```

## Tools

- `encode_html`: Encode text to HTML entities, with basic or extended mode.
- `decode_html`: Decode named and numeric HTML entities back to plain text.

## FAQ

### Does the pack need an API key?

No. The README says calls are anonymous without a key but capped daily; a free account raises the cap to 200 calls a day.

### Which tools does the endpoint expose?

The pack provides encode_html and decode_html, and the README notes the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.

### Is it fully offline?

The README describes the entity tools as keyless and offline, but the connection goes through the Pipeworx gateway and needs network access.

### Is Htmlentities free?

Htmlentities has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add --transport http htmlentities https://gateway.pipeworx.io/htmlentities/mcp

### What are the best alternatives to Htmlentities?

The closest alternatives to Htmlentities are Unicode, Emoji, Numbers, Markdown and Url.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Unicode](https://ai-powered.com/mcp/unicode): Unicode is a freemium MCP server for developer tools.
- [Emoji](https://ai-powered.com/mcp/emoji): Emoji is a freemium MCP server for developer tools.
- [Numbers](https://ai-powered.com/mcp/numbers): Numbers is a freemium MCP server for developer tools.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.
- [Json](https://ai-powered.com/mcp/json): Json is a freemium MCP server for developer tools.
- [Httpstatus](https://ai-powered.com/mcp/httpstatus): Httpstatus is a freemium MCP server for developer tools.
- [Nato](https://ai-powered.com/mcp/nato): Nato is a freemium MCP server for developer tools.

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