# Html Entity Finder — MCP tool `findutils:html_entity_finder`

Search the HTML entity catalog and return matching entities with their character, named entity, decimal code, hex code, and category. Search by character (€), entity name (&euro; or euro), descriptive name (Euro Sign), or keyword (currency); filter by category; with no query the catalog is listed in order. Results are ranked by match strength.

- Category: text
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/html-entity-finder/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/html-entity-finder/
- Same tool on the other surface: https://findutils.com/api/html-entity-finder/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "html_entity_finder",
      "arguments": {
        "query": "euro"
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `query` | string | no | Search text: a character, an entity such as &copy;, a name, or a keyword. Empty lists the catalog. Default: `""`. |
| `category` | string (all \| Currency Symbols \| Math Symbols \| Arrows \| Latin Characters \| Greek Letters \| Punctuation \| Technical Symbols \| Geometric Shapes \| Miscellaneous Symbols) | no | Restrict results to one category. Default: all. Default: `"all"`. |
| `limit` | integer | no | Maximum number of entities to return (1-500). Default: 50. Default: `50`. |

Example arguments (verified):

```json
{
  "query": "euro"
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/html-entity-finder/execute \
  -H "Content-Type: application/json" \
  -d '{
    "query": "euro"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/html-entity-finder
```

Full REST reference: https://findutils.com/api/html-entity-finder/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt
