Skip to content
MCP server

Public Suffix List

Splits domains into subdomain, registrable domain and public suffix via Mozilla's list

Install
Pricing
Open source
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Public Suffix List

Public Suffix List is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/public-suffix-list/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "public-suffix-list": {
      "url": "https://gateway.pipeworx.io/public-suffix-list/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT-licensed npm bridge; hosted gateway uses metered Pipeworx credits and daily call caps.

Prices change. Check pipeworx.io before you buy.

Public Suffix List 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.

How AIPoweredBot checks servers