io.github.itsryanarmani/septics is an MCP server published by io.github.itsryanarmani, hosted at septics.fyi. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including search_listings, get_listing, list_places, list_categories, get_stats.
Find septic service. Check the source.
121 connections through 5 shared values. Tap any node.
Search published septic service companies by text, place and category.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search text, with at least one letter or digit. Matches name, categories, attributes, description and place. Typos fall back to close matches. |
| city | string | City slug, from /places. |
| sort | string | `relevance` needs `q` and is the default with it. `name` is the default without `q`. `recent` is newest first. |
| limit | integer | Items per page. |
| cursor | string | `page.nextCursor` from the previous response. Opaque. Send the same filters and `limit`. |
| region |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| string |
| Region slug, from /places. |
| country | string | ISO 3166-1 alpha-2 country code, any case. A country the directory does not cover, as listed in /places, gives 400. |
| category | string | Category slug, from /categories. A parent slug also matches its children. |
{
"name": "search_listings",
"title": "Search Listings",
"description": "Search published septic service companies by text, place and category.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Search text, with at least one letter or digit. Matches name, categories, attributes, description and place. Typos fall back to close matches."
},
"city": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "City slug, from /places."
},
"sort": {
"enum": [
"relevance",
"name",
"recent"
],
"type": "string",
"description": "`relevance` needs `q` and is the default with it. `name` is the default without `q`. `recent` is newest first."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Items per page."
},
"cursor": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "`page.nextCursor` from the previous response. Opaque. Send the same filters and `limit`."
},
"region": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "Region slug, from /places."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, any case. A country the directory does not cover, as listed in /places, gives 400."
},
"category": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "Category slug, from /categories. A parent slug also matches its children."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one published septic service company by its slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The listing slug. |
{
"name": "get_listing",
"title": "Get Listing",
"description": "Get one published septic service company by its slug.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The listing slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List countries, regions and cities that have septic service companies.
No parameters.
{
"name": "list_places",
"title": "List Places",
"description": "List countries, regions and cities that have septic service companies.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List categories with their septic service company counts.
No parameters.
{
"name": "list_categories",
"title": "List Categories",
"description": "List categories with their septic service company counts.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the number of published septic service companies, places and categories, and when the data last changed.
No parameters.
{
"name": "get_stats",
"title": "Get Stats",
"description": "Get the number of published septic service companies, places and categories, and when the data last changed.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List where the septic service company data comes from, with the license and refresh of each source.
No parameters.
{
"name": "list_sources",
"title": "List Sources",
"description": "List where the septic service company data comes from, with the license and refresh of each source.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the products, with the price each had on the day it was checked. Filter by product category.
| Parameter | Type | Description |
|---|---|---|
| category | string | A product category slug. |
{
"name": "list_products",
"title": "List Products",
"description": "List the products, with the price each had on the day it was checked. Filter by product category.",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "A product category slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one product by its slug, with its page and outbound link.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The product slug. |
{
"name": "get_product",
"title": "Get Product",
"description": "Get one product by its slug, with its page and outbound link.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The product slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the product categories with their product counts.
No parameters.
{
"name": "list_product_categories",
"title": "List Product Categories",
"description": "List the product categories with their product counts.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the published academy courses with their level, length, pass mark and certificate validity.
| Parameter | Type | Description |
|---|---|---|
| level | string | Only courses of this level. |
| limit | integer | Most courses to return. |
{
"name": "list_courses",
"title": "List Courses",
"description": "List the published academy courses with their level, length, pass mark and certificate validity.",
"inputSchema": {
"type": "object",
"properties": {
"level": {
"enum": [
"foundations",
"practitioner",
"specialist"
],
"type": "string",
"description": "Only courses of this level."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 50,
"minimum": 1,
"description": "Most courses to return."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one published academy course by its slug, with its objectives, lessons and FAQ. Exam questions and answers are never returned.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The course slug. |
{
"name": "get_course",
"title": "Get Course",
"description": "Get one published academy course by its slug, with its objectives, lessons and FAQ. Exam questions and answers are never returned.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The course slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Septics lists septic service companies. Privacy policy: https://septics.fyi/privacy. Call list_places and list_categories first to learn the place and category slugs. Then call search_listings, and get_listing for one record. Every result has meta.attribution and meta.sources. Show the credit line, and keep the license of each source. A septic service company is a record, not an endorsement. list_product_categories, list_products and get_product read the products. A price is the one seen on price_as_of, not a live price; buy_url carries no affiliate code and earns us no commission. list_courses and get_course read the published academy courses. Exam questions and answers are never returned. With a service token in the Authorization header, tools/list also offers the write tools that the token's scopes allow.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.