# Public Suffix List

> Public Suffix List is an open-source MCP server for developer tools. Splits domains into subdomain, registrable domain and public suffix via Mozilla's list. It can run locally on your machine or as a hosted remote server.

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

## About

The README describes this server as a wrapper around the Mozilla-maintained Public Suffix List, the catalog of effective top-level domains such as co.uk or github.io that browsers use to set cookie boundaries. Instead of forcing an agent to hard-code suffix rules, it exposes lookups that break a hostname into its parts.

The four tools cover a full parse, just the public suffix, the registrable domain used as a site boundary, and metadata about the list itself, including its last refresh and rule count. The README says responses are cached for 24 hours inside the pack and that no key is required for basic use.

It suits developers working on cookie scoping, same-site checks, or domain grouping who want a live rules source reachable from an MCP client. The hosted gateway also lists shared Pipeworx meta-tools alongside these, and the README notes that connections are metered by daily call limits.

## Features

- **Full domain parsing:** Splits a hostname into subdomain, registrable domain and public suffix in one call.
- **Public suffix lookup:** Returns only the public suffix for a given domain.
- **Registrable domain lookup:** Returns the registrable domain, the site boundary, for a hostname.
- **List version metadata:** Reports the list's refresh time and line count.
- **Keyless anonymous access:** Works without an API key, with a daily anonymous call cap that a free key raises.

## Good for

- Grouping subdomains under a single registrable domain for analytics
- Checking whether two hostnames share a site for same-site cookie logic
- Extracting the registrable domain from user-submitted URLs
- Validating that a hostname uses a recognised public suffix

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http public-suffix-list https://gateway.pipeworx.io/public-suffix-list/mcp
```

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

```sh
https://gateway.pipeworx.io/public-suffix-list/mcp
```

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

```json
{
  "mcpServers": {
    "public-suffix-list": {
      "url": "https://gateway.pipeworx.io/public-suffix-list/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "public-suffix-list": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/public-suffix-list/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "public-suffix-list": {
      "serverUrl": "https://gateway.pipeworx.io/public-suffix-list/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "public-suffix-list": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/public-suffix-list/mcp"
    }
  }
}
```

## Tools

- `parse`: Split a domain into subdomain, registrable domain and public suffix.
- `public_suffix`: Return just the public suffix.
- `registrable_domain`: Return the domain plus nearest suffix (the site).
- `list_version`: Return list refresh time and line count.

## FAQ

### Does it need an API key?

The README says calls work without a key but are capped at 50 per day anonymously; a free Pipeworx key raises the cap to 200 per day.

### How often is the list refreshed?

The README says data is cached for 24 hours inside the pack, and a list_version tool reports the last refresh time.

### Which data source does it use?

The README names the Mozilla list published at publicsuffix.org.

### Is Public Suffix List free?

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

### How do I add Public Suffix List to Claude Code?

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

### What are the best alternatives to Public Suffix List?

The closest alternatives to Public Suffix List are Profullstack, TLDMint Live Domain & DNS MCP, Url, Dns and SaaS Custom Domains.

## 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

- [Profullstack](https://ai-powered.com/mcp/profullstack): Profullstack is a free MCP server for developer tools.
- [TLDMint Live Domain & DNS MCP](https://ai-powered.com/mcp/tldmint-live-domain-and-dns-mcp): TLDMint Live Domain & DNS MCP is a free MCP server for developer tools.
- [Url](https://ai-powered.com/mcp/url): Url is a freemium MCP server for developer tools.
- [Dns](https://ai-powered.com/mcp/dns-2): Dns is a freemium MCP server for developer tools.
- [SaaS Custom Domains](https://ai-powered.com/mcp/saas-custom-domains): SaaS Custom Domains is a paid MCP server for cloud and infrastructure.
- [Realtime Register MCP by usefulapi](https://ai-powered.com/mcp/realtime-register-mcp-by-usefulapi): Realtime Register MCP by usefulapi is a freemium MCP server for developer tools.
- [Mdn Search](https://ai-powered.com/mcp/mdn-search): Mdn Search is a freemium MCP server for developer tools.
- [Domain Intelligence](https://ai-powered.com/mcp/domain-intelligence): Domain Intelligence is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/public-suffix-list
