English Français العربية

The Septic Guide

Official registry Other

U.S. septic licensing by state, license-matched septic companies, and cited septic cost guides.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http the-septic-guide 'https://mcp.thesepticguide.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "the-septic-guide": {
            "type": "http",
            "url": "https://mcp.thesepticguide.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. The Septic Guide MCP server
  2. Tools
  3. Data
  4. Data & limits
  5. Use
  6. License

The Septic Guide MCP server

Read-only Model Context Protocol server for thesepticguide.com, a U.S. septic contractor directory built from published state license and certification records.

No API key. No writes. Every result carries a source_url on thesepticguide.com.

Tools

ToolWhat it returns
list_statesStates with a licensing page and/or company directory, with links
get_state_licensingstate (name or code): the agency that licenses septic work, its official lookup URL, page date, and the page's licensing Q&A
search_septic_companiesstate plus optional city, county, zip, service, licensed_only, limit: listings with license number(s), agency verify link, phone, website, profile link
get_cost_guideoptional topic (e.g. pumping, drain field): short answer, cost tables, and the third-party sources the page cites. No topic = list topics

Data

By default the server answers from a bundled snapshot in data/ (data/snapshot.json for the index, licensing and cost pages, plus one gzipped file per state in data/companies/). Every response includes data_mode and data_as_of (the snapshot date). Rebuild it with:

npm run snapshot   # crawls thesepticguide.com (sitemap, state + county pages) and rewrites data/

Set TSG_LIVE=1 to skip the snapshot and read thesepticguide.com live instead (6-hour in-memory cache). Live mode is also used automatically if data/ is missing.

Company counts

Each state page's meta description gives a headline number (e.g. Texas: "363 septic companies"). In some states the listings actually rendered on the state page plus its county pages come to fewer (Texas: 360). The server never pads results: search_septic_companies reports listed_on_pages (rendered listings it searched) and state_page_headline_count (the page's own number), with a count_note when they differ. Same-name listings with different services or license records are distinct state-list records and are kept.

Data & limits

  • Read-only. No writes, no API key, no user data collected.
  • Public data from thesepticguide.com. Every result carries a source_url on thesepticguide.com.
  • License data comes from published state agency license and certification lists, as matched by thesepticguide.com. Confirm any license with the agency verify_url before hiring.
  • Not affiliated with any state agency.
  • Snapshot data can lag the live site; check data_as_of.

Use

Remote (Streamable HTTP): https://mcp.thesepticguide.com/mcp

Local (stdio):

git clone https://github.com/archer-clawbot/thesepticguide-mcp && cd thesepticguide-mcp && npm install && npm run build
{ "mcpServers": { "thesepticguide": { "command": "node", "args": ["/path/to/thesepticguide-mcp/dist/stdio.js"] } } }

Docker: docker build -t thesepticguide-mcp . && docker run -i --rm thesepticguide-mcp

Develop:

npm install && npm run build
npm test                 # stdio smoke test with the MCP SDK client
npm test -- http         # same against MCP_URL (default http://localhost:3000/mcp)
npm run start:http       # http://localhost:3000/mcp

Deploy on Vercel: api/mcp.ts + vercel.json (rewrites /mcp to the function).

License

MIT. Copyright (c) 2026 Catalyst Digital Services LLC.

Frequently asked questions

What is The Septic Guide?

U.S. septic licensing by state, license-matched septic companies, and cited septic cost guides.

How do I install The Septic Guide?

It runs as a remote server. In Claude Code: claude mcp add --transport http the-septic-guide 'https://mcp.thesepticguide.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does The Septic Guide need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is The Septic Guide open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains The Septic Guide?

It is published by archer-clawbot. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.