list_cities

List the 20 cities Dim Hour covers, with the city key to pass to the other tools.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_venues

Search Dim Hour's curated restaurant/bar/venue catalog. Pass `city` to search one city, or OMIT `city` to search all ~9,500 venues across every city at once (e.g. 'best ramen anywhere', 'michelin spots'). Returns ranked matches with score (0-100 quality), price tier, neighborhood, happy-hour info, and a dimhour.com link. Use free-text `query` for cuisine, dish, vibe, or name; combine with filters.

Parameters11

city	string	optional	City name or key, e.g. 'NYC', 'dallas'. OMIT to search ALL cities at once.
query	string	optional	Free text matched against name, cuisine, neighborhood, tags, dishes, description
neighborhood	string	optional	Filter to a neighborhood (substring match)
cuisine	string	optional	Filter to a cuisine (substring match)
max_price	integer	optional	Max price tier 1-4 ($-$$$$)
min_score	number	optional	Minimum quality score 0-100
happy_hour_only	boolean	optional	Only venues with happy hour info
awards_contains	string	optional	Only venues whose awards field matches, e.g. 'michelin', 'james beard', 'bib gourmand'
iconic_only	boolean	optional	Only 'Iconic 50' venues (NYC has these today)
trending_only	boolean	optional	Only trending venues
limit	integer	optional	Max results, default 10

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or key, e.g. 'NYC', 'dallas'. OMIT to search ALL cities at once."
    },
    "query": {
      "type": "string",
      "description": "Free text matched against name, cuisine, neighborhood, tags, dishes, description"
    },
    "neighborhood": {
      "type": "string",
      "description": "Filter to a neighborhood (substring match)"
    },
    "cuisine": {
      "type": "string",
      "description": "Filter to a cuisine (substring match)"
    },
    "max_price": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "Max price tier 1-4 ($-$$$$)"
    },
    "min_score": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Minimum quality score 0-100"
    },
    "happy_hour_only": {
      "type": "boolean",
      "description": "Only venues with happy hour info"
    },
    "awards_contains": {
      "type": "string",
      "description": "Only venues whose awards field matches, e.g. 'michelin', 'james beard', 'bib gourmand'"
    },
    "iconic_only": {
      "type": "boolean",
      "description": "Only 'Iconic 50' venues (NYC has these today)"
    },
    "trending_only": {
      "type": "boolean",
      "description": "Only trending venues"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Max results, default 10"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_new_venues

Venues recently added to the Dim Hour catalog — across all 20 cities or one city. Use for 'what's new on Dim Hour' / new-opening alerts / weekly digests. Dates earlier than 2026-06-06 are estimates reconstructed from history.

Parameters3

city	string	optional	Optional city name or key; omit for all cities
days	integer	optional	Look-back window in days, default 30 (max 90)
limit	integer	optional	Max results, default 25

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional city name or key; omit for all cities"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Look-back window in days, default 30 (max 90)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max results, default 25"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_venue

Get the full Dim Hour record for one venue: description, signature dishes, address, hours, phone, happy hour, reservation platform, awards, website, Instagram, and (for Iconic 50 venues) the long-form story.

Parameters3

city	string	required	City name or key
id	integer	optional	Venue id from search_venues
name	string	optional	Venue name (used if id not given)

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or key"
    },
    "id": {
      "type": "integer",
      "description": "Venue id from search_venues"
    },
    "name": {
      "type": "string",
      "description": "Venue name (used if id not given)"
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_curated

Dim Hour's hand-curated themed lists for a city (e.g. 'Unmarked Doors' speakeasies). Without list_id: returns all list titles. With list_id: returns that list's venues with editorial notes.

Parameters2

city	string	required	City name or key
list_id	string	optional	A list id from the no-arg call

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or key"
    },
    "list_id": {
      "type": "string",
      "description": "A list id from the no-arg call"
    }
  },
  "required": [
    "city"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

save_venue

Save a venue to the user's Dim Hour account: 'fav' (Favorites), 'want' (Want to try), or 'visited' (Been there). Requires the user's Dim Hour API key (generated in the app: Profile → Concierge API key). The save appears in the app after its next sync (app open or sign-in).

Parameters3

city	string	required	City name or key
id	integer	required	Venue id from search_venues / get_venue
kind	string	required	fav = Favorites, want = Want to try, visited = Been there

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or key"
    },
    "id": {
      "type": "integer",
      "description": "Venue id from search_venues / get_venue"
    },
    "kind": {
      "type": "string",
      "enum": [
        "fav",
        "want",
        "visited"
      ],
      "description": "fav = Favorites, want = Want to try, visited = Been there"
    }
  },
  "required": [
    "city",
    "id",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_to_trip

Add a venue to one of the user's Dim Hour trips (creates the trip if needed). Identify the trip by trip_code (from list_my_trips) or trip_name; with neither, a new trip is created for the venue's city. Requires the user's Dim Hour API key. Returns the trip's public share link (dimhour.com/trip.html?code=...).

Parameters6

city	string	required	City name or key of the venue
id	integer	required	Venue id from search_venues / get_venue
trip_code	string	optional	6-char trip code from list_my_trips
trip_name	string	optional	Trip name to match or create, e.g. 'NYC July'
date	string	optional	Reservation date YYYY-MM-DD
time	string	optional	Reservation time, e.g. '7:30 PM'

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or key of the venue"
    },
    "id": {
      "type": "integer",
      "description": "Venue id from search_venues / get_venue"
    },
    "trip_code": {
      "type": "string",
      "description": "6-char trip code from list_my_trips"
    },
    "trip_name": {
      "type": "string",
      "description": "Trip name to match or create, e.g. 'NYC July'"
    },
    "date": {
      "type": "string",
      "description": "Reservation date YYYY-MM-DD"
    },
    "time": {
      "type": "string",
      "description": "Reservation time, e.g. '7:30 PM'"
    }
  },
  "required": [
    "city",
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_my_trips

List the user's Dim Hour trips (code, name, city, item count, share link). Requires the user's Dim Hour API key. Use the code with add_to_trip.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

post_to_brain

Post a message or a proposed state-change into the Dim Hour Triangle brain (the shared room for Poke, Claude, and Clicky). Use this to drop an objective, a status note, or a proposed live_nodes patch. IMPORTANT: every post is recorded as 'asserted' and is NOT treated as true until Claude verifies it against the real repo/DB and lands it in THREAD.md / live_nodes.json. You cannot mark a post verified. Requires the user's Dim Hour API key.

Parameters3

kind	string	required	thread = a message for the room; node_update = a proposed JSON patch to live_nodes
body	string	required	The message text, or — for node_update — a JSON patch string, e.g. {"repo":{"catalog_venues":10200}}
ref	string	optional	Optional evidence: a git sha, PR url, or dashboard link

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "thread",
        "node_update"
      ],
      "description": "thread = a message for the room; node_update = a proposed JSON patch to live_nodes"
    },
    "body": {
      "type": "string",
      "maxLength": 4000,
      "description": "The message text, or — for node_update — a JSON patch string, e.g. {\"repo\":{\"catalog_venues\":10200}}"
    },
    "ref": {
      "type": "string",
      "description": "Optional evidence: a git sha, PR url, or dashboard link"
    }
  },
  "required": [
    "kind",
    "body"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_brain

Read the recent Dim Hour Triangle brain posts (the shared room) so you can see what's been proposed and what Claude has verified. Posts route sender_node -> target_node with a topic + payload; status is 'pending' (unverified), 'processing', 'completed' (confirmed by Claude against the repo/DB), or 'failed'. Requires the user's Dim Hour API key.

Parameters2

status	string	optional	Optional filter to one status; omit for all recent posts
limit	integer	optional	Max posts, default 20

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "processing",
        "completed",
        "failed"
      ],
      "description": "Optional filter to one status; omit for all recent posts"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max posts, default 20"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

com.dimhour/catalog

MCP Server: com.dimhour/catalog

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_cities

search_venues

list_new_venues

get_venue

list_curated

save_venue

add_to_trip

list_my_trips

post_to_brain

read_brain

Install

Remote endpoint