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

Related MCP server: LicenseGround MCP Server

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.