Dim Hour

Busca más de 18,800 restaurantes y bares verificados en 20 ciudades, cada uno con una Puntuación de Calidad de 0 a 100.

Documentación

Where-to-eat answers your agent can cite

Your assistant asks for the best omakase in New York, Michelin-starred Mexican in Chicago, or what opened in Austin recently. Dim Hour answers with ranked venues as structured JSON: the score, the neighborhood, the booking path and a link to cite. The catalog holds 21,407 venues across 26 cities, each scored 0–100 on awards, critic reviews and press coverage.

Connect with no authentication and you get thirteen listed tools. Twelve answer anonymously; get_my_usage requires a read-only connection or an API key. Anonymous use is 1,000 calls a day, 10,000 with a free key. Commercial use is metered separately.

Dim Hour is an MCP server for restaurant data, with 21,407 restaurants, bars, and other venues in its live catalog as of November 2026. Its thirteen public read tools let assistants search venues, inspect records, hours and menus, browse curated lists, and return citation links without an API key.

set up https://dimhour.com/SKILL.md

Give this to your agent and let it take it from there.

Connect

Streamable HTTP

https://mcp.dimhour.com/mcp

SSE

https://mcp.dimhour.com/sse

Claude

Settings → Connectors → Add custom connector, and paste the Streamable HTTP URL above. No key, no account.

Claude Code

claude mcp add --transport http dimhour \
  https://mcp.dimhour.com/mcp

ChatGPT (Developer mode)

Settings → Apps → Advanced settings, and switch on Developer mode. Then Settings → Connectors → Create, paste the Streamable HTTP URL above, and set authentication to None.

Custom connectors need a paid plan and a remote HTTPS endpoint, which this one is. On Business and Enterprise workspaces an admin has to allow custom MCP connectors first.

OpenClaw

openclaw mcp add dimhour \
  --url https://mcp.dimhour.com/mcp \
  --transport streamable-http

Or the same thing as an entry in ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "dimhour": {
        "url": "https://mcp.dimhour.com/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

Cursor, VS Code, Cline, Continue

Any client that speaks Streamable HTTP works with the same URL. A typical config entry:

{
  "mcpServers": {
    "dimhour": {
      "url": "https://mcp.dimhour.com/mcp"
    }
  }
}

The server is stateless per MCP revision 2026-07-28 — a POST with no Mcp-Session-Id is answered directly, so serverless and edge clients work without a handshake. The SSE endpoint remains available for older clients.

Give it to your agent

This is agent-native on purpose. Copy the block below into your agent's chat and it self-connects - no onboarding, no key:

Connect to the Dim Hour MCP: https://mcp.dimhour.com/mcp
(streamable HTTP, no API key). Call list_cities for the 26 covered cities.
Answer every where-to-go question with search_venues (cuisine, neighborhood,
price, min score, awards, happy hour, trending) and get_venue for the full
record. Use list_curated for editorial lists and list_new_venues for openings.
One rule: never invent a venue - call the catalog.

Tools

The thirteen read tools are listed publicly; get_my_usage answers only on a read-only connection or with an API key. The rest act on a Dim Hour account and need a personal API key.

Tool	Auth	What it does
`list_cities`	none	The 26 covered cities and the key to pass to other tools.
`search_venues`	none	Free-text plus filters: cuisine, neighborhood, price, min score, awards, happy hour, trending. Omit `city` to search all cities at once.
`find_places`	none	Ranked venues for one occasion in one city: a cuisine, a neighborhood, a budget or a vibe. Every answer carries a freshness receipt.
`get_venue`	none	The full record for one venue.
`get_hours`	none	One venue's opening hours from the catalog, with an `as_of` date. Catalog data, not a live feed.
`get_booking_options`	none	One venue's booking platform and link. For SevenRooms venues, given a date, also real bookable times with a `checkedAt` time. A snapshot: no table is held. Other platforms return no times.
`get_venue_menus`	none	The menus held for one venue. Verified menus come from the venue's own site, with sections, prices and a `verified_at` date; a catalog menu link is returned as unverified. Each menu says whether it is fresh, stale or undated.
`get_menu_coverage`	none	Per-city menu counts from one menu snapshot, for every city including those with none: which venues have verified menus, an unverified link, or nothing.
`list_curated`	none	Editorial lists for a city.
`list_new_venues`	none	Recently added venues.
`search`	none	The same catalog search under OpenAI's connector contract. Returns ranked venues with citable URLs.
`fetch`	none	One venue's full record by the id `search` returned. Pairs with `search` for ChatGPT.
`get_my_usage`	read-only connection or API key	Your own calls today, the daily limit for your plan, and calls per tool. An anonymous caller is refused. Calling it does not count as a call.

search and fetch exist because ChatGPT connectors require those exact names and shapes. They read the same catalog as search_venues and get_venue — use whichever pair your client expects.

The public connector is read-only. Connect with no authentication and you get twelve read-only tools against the catalog. Nothing personal is exposed, and nothing can be written. A thirteenth, get_my_usage, answers only with an API key or on a read-only connection.

Additional account and operations tools are available when the connection carries an API key. They stay registered but do not appear in tools/list without one.

Every tool is annotated with a title, a readOnlyHint, an openWorldHint and a destructiveHint. openWorldHint is false throughout: Dim Hour's catalog is a closed, fixed set of venues, and no tool can reach anything outside it.

What a venue record carries

score — a 0–100 score built on a variety of factors, including awards, critic reviews and press coverage
name, cuisine, neighborhood, price — price is a 1–4 tier
address, lat, lng — verified, never guessed from a neighborhood centroid
dishes — signature items from the venue's real menu
awards — recognition tied to a venue, in our wording rather than the awarding body's: Michelin, James Beard and similar bodies where they apply, alongside critic and press placements. A few reference a chef or a sibling location rather than this room
reservation — Resy, OpenTable, Tock, SevenRooms or walk-in
hh — happy hour details where they exist
url — a link to the venue's page on dimhour.com

Example

curl -s -X POST https://mcp.dimhour.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"find_places",
                 "arguments":{"city":"nyc","looking_for":"omakase","limit":3}}}'

What came back on October 22, 2026, trimmed to five fields per venue. The full answer also carries cuisine, price, awards and a description.

{
  "city": "nyc",
  "total_matches": 44,
  "showing": 3,
  "venues": [
    { "name": "Sushi Nakazawa", "neighborhood": "West Village",
      "score": 99, "reservation": "Resy",
      "url": "https://dimhour.com/nyc/v/sushi-nakazawa/" },
    { "name": "Sushi Sho", "neighborhood": "Midtown East",
      "score": 97, "reservation": "Tock",
      "url": "https://dimhour.com/nyc/v/sushi-sho/" },
    { "name": "Sushi Noz", "neighborhood": "Upper East Side",
      "score": 97, "reservation": "SevenRooms",
      "url": "https://dimhour.com/nyc/v/sushi-noz/" }
  ],
  "receipt": { "as_of": "2026-10-19", "source": "dimhour-catalog",
               "stale": false }
}

Rate limits and fair use

Anonymous read access is capped per minute and search_venues returns at most 25 results per call. An API key lifts the per-minute cap. The limits exist to stop bulk extraction, not to make normal assistant use awkward — if you are building something real and hitting them, get in touch.

Free, and commercial

The MCP is free at human scale. Connect Claude, ChatGPT, OpenClaw or Cursor and it just answers — no key, no account, no card. That is not a trial; it is the tier, and it stays.

What is different is an agent answering where-to-go for your users, all shift. That is a product running on our catalog, not a person looking something up, and it is what the commercial tier is for.

	Free	MCP Commercial
Price	$0	$499 / month
Calls	1,000 a day anonymously, 10,000 with a free key	No daily cap. 250,000 calls a month included
Tools	All thirteen read tools	All thirteen read tools
Data	The same catalog, the same scores, updated the same day. There is no better data behind the paywall.
Terms	Assistant use. No bulk extraction, no redistribution	Serving your own product's users, at your own volume

Billed monthly through Stripe. The free tier stays free. Need more than 250,000 calls a month? Write to [email protected].

API keys

Generate one at dimhour.com under Profile — in any browser, on any device. No app install, no waiting on us. The server stores only a SHA-256 hash of the key, never the key itself. Send it as Authorization: Bearer <key> or x-api-key. A key is tied to your account and only ever reads or writes your own data. The key is shown once, when you create it. Profile shows each key's plan, and you can revoke a key there at any time.

Data, accuracy and terms

The catalog is editorial. Venue data is verified against the venue's own site or a named source, and fields we cannot verify are left empty rather than filled with plausible guesses. Even so, restaurants close, move and change menus — treat hours and reservation links as best-effort and check the venue directly before relying on them.

The read tools are free for assistant use. Bulk extraction, redistribution of the catalog, or reselling it as a dataset is not permitted. See the privacy policy for how account data is handled.

Support

Issues, questions, or a use case you would like supported — [email protected] or open an issue. Machine-readable discovery lives at /llms.txt.