Mogean US points-of-interest catalog: search and count locations by brand, category and state.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch one catalog product by the id that search returned: what it contains, coverage, fill rates, freshness, provenance and published prices per licence tier.
A product id from search, such as brand:<slug>, or a product sku.
concise (default) returns a short summary; detailed adds the full structured result as text.
Fetch one catalog product by the id that search returned: what it contains, coverage, fill rates, freshness, provenance and published prices per licence tier.
| Argument | Type | Description |
|---|---|---|
| id* | string | A product id from search, such as brand:<slug>, or a product sku. |
| response_format | string | concise (default) returns a short summary; detailed adds the full structured result as text. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A product id from search, such as brand:<slug>, or a product sku."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}Describe the catalog: the current data release and how fresh it is, sellable totals, the provenance tiers, what each kind of product contains, and the limits and tools that apply to this connection.
| Argument | Type | Description |
|---|---|---|
| response_format | string | concise (default) returns a short summary; detailed adds the full structured result as text. |
{
"type": "object",
"properties": {
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}Count sellable US locations, exactly, from the current data release. Use fact for one brand, category, leaf category or government source, optionally in a state; for a brand in a state, a city works when it is one of the top cities listed on that brand's page for that state. Use cut for any combination of brands, categories, leaf categories, states, government sources and tiers. Ids from search are accepted as they are. Returns a link to the page a person can check, and the cut and full_cut_hash that identify what was counted.
| Argument | Type | Description |
|---|---|---|
| cut | object | A custom cut: every non-empty list narrows the selection. |
| fact | object | A fact question: one of brand, category, leaf or gov; optionally a state; for a brand inside a state, optionally a city. |
| response_format | string | concise (default) returns a short summary; detailed adds the full structured result as text. |
{
"type": "object",
"properties": {
"cut": {
"type": "object",
"properties": {
"tiers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 6,
"description": "Provenance tier groups: pipeline, government, fsq, overture. PIPELINE_AUTHORITATIVE, GOVERNMENT_AUTHORITATIVE and OVERTURE_SUPPLEMENT (as by_tier names them) select their group; the three FSQ_ tiers are selected together as fsq."
},
"brands": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "Brands: ids from search (brand:<slug>) or bare slugs (fetch metadata.key)."
},
"format": {
"enum": [
"csv_parquet",
"csv",
"parquet",
"geojson"
],
"type": "string",
"description": "Delivery format."
},
"states": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "States: two-letter US codes, or ids from search (state:TX)."
},
"columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "Column names to deliver; empty means every column."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "Categories: ids from search (category:<slug>) or bare slugs (fetch metadata.key)."
},
"gov_sources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "Government sources: ids from search (gov:<slug>) or bare slugs (fetch metadata.key)."
},
"leaf_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 200,
"description": "Leaf categories: slugs from fetch (metadata.category.leaf_slug), or a leaf name fetch shows when it names one leaf."
},
"include_geometry": {
"type": "boolean",
"description": "Add the building-geometry file."
}
},
"description": "A custom cut: every non-empty list narrows the selection.",
"additionalProperties": false
},
"fact": {
"type": "object",
"properties": {
"gov": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A government source: the id search returned (gov:<slug>) or the bare slug from fetch's metadata.key."
},
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "City name; needs brand and state. Only the top cities listed on that brand's page for that state have a count; any other city returns needs_serving_layer."
},
"leaf": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A leaf category: fetch's metadata.category.leaf_slug, or the leaf name fetch shows (metadata.category.leaf) when it names one leaf."
},
"brand": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A brand: the id search returned (brand:<slug>) or the bare slug from fetch's metadata.key."
},
"state": {
"type": "string",
"maxLength": 8,
"minLength": 2,
"description": "A two-letter US state code, or the id search returned for a state (state:TX)."
},
"county": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "County counts are not published yet: a county question returns needs_serving_layer with the state's page."
},
"category": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A category: the id search returned (category:<slug>) or the bare slug from fetch's metadata.key."
}
},
"description": "A fact question: one of brand, category, leaf or gov; optionally a state; for a brand inside a state, optionally a city.",
"additionalProperties": false
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}Show up to 10 sample rows from one brand's dataset, with the sources and licences they come from. The timezone column is withheld.
| Argument | Type | Description |
|---|---|---|
| slug* | string | A brand: the id search returned (brand:<slug>) or the bare slug from fetch's metadata.key. |
| response_format | string | concise (default) returns a short summary; detailed adds the full structured result as text. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A brand: the id search returned (brand:<slug>) or the bare slug from fetch's metadata.key."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}Search Mogean's catalog of US point-of-interest datasets: brands, categories, states, government sources and flagship datasets. Returns matching products with an id, title, URL and short text; pass an id to fetch for the full product card.
| Argument | Type | Description |
|---|---|---|
| kinds | array | Limit results to these product kinds. |
| limit | integer | Results per page (default 10, at most 50). |
| query* | string | What to look for, e.g. a brand, category, state or registry name. |
| cursor | string | next_cursor from a previous page of the same search. |
| response_format | string | concise (default) returns a short summary; detailed adds the full structured result as text. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"kinds": {
"type": "array",
"items": {
"enum": [
"brand",
"category",
"state",
"gov",
"flagship"
],
"type": "string"
},
"maxItems": 5,
"description": "Limit results to these product kinds."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Results per page (default 10, at most 50)."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "What to look for, e.g. a brand, category, state or registry name."
},
"cursor": {
"type": "string",
"maxLength": 200,
"description": "next_cursor from a previous page of the same search."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise",
"description": "concise (default) returns a short summary; detailed adds the full structured result as text."
}
},
"additionalProperties": false
}