onthecheap-mcp

onthecheap-mcp

On the Cheap ネットワーク向けの MCP サーバーです。全米14都市で、無料や格安で楽しめるアクティビティを紹介する地域ガイドを提供します。時刻、料金、会場情報付きの毎日のイベント一覧に加え、お得情報やガイドを検索できるアーカイブも利用できます。

AI（Claude Code）が開発・保守しています。ご自身の判断でご利用ください。

認証情報は不要です。 すべてのサイトは公開されているため、サーバー側で通常の HTTPS を使って読み込みます。設定が必要なのは利用したい都市だけで、ブラウザー拡張機能も不要です。

インストール

npx onthecheap-mcp

Claude Code プラグインとしても利用できます。

/plugin marketplace add chrischall/onthecheap-mcp
/plugin install onthecheap-mcp

都市の選択

1つのサーバーでネットワーク全体を利用できます。すべてのツールで読み込み先の都市を指定する site 引数が必要です。デフォルト値はなく、設定手順もありません。

キー	サイト	地域
charlotte	Charlotte On The Cheap	Charlotte, NC
denver	Mile High on the Cheap	Denver, CO
atlanta	Atlanta on the Cheap	Atlanta, GA
chicago	Chicago on the Cheap	Chicago, IL
columbus	Columbus on the Cheap	Columbus, OH
seattle	Greater Seattle on the Cheap	Seattle–Tacoma
kansascity	Kansas City on the Cheap	Kansas City
miami	South Florida on the Cheap	Miami / Broward / Palm Beach
orlando	Orlando on the Cheap	Orlando, FL
portland	Portland Living on the Cheap	Portland, OR
richmond	RVA on the Cheap	Richmond, VA
southernmaine	Southern Maine on the Cheap	Southern Maine
triangle	Triangle on the Cheap	Raleigh / Durham / Chapel Hill
national	Living On The Cheap	全米のお得情報（地域イベントカレンダーなし）

milehigh、raleigh、rva、kc、southflorida などの一般的な別名も使えます。 otc_list_sites で同じ一覧を確認できます。

意図的に site を必須にしており、デフォルト値はありません。サーバーがひそかに別の都市へ切り替わると、デンバーについての質問にシャーロットのデータで回答し、誤りに気づけないおそれがあるためです。無効なキーを指定すると、利用可能なキーを示して拒否されます。

ツール

すべてのツールは読み取り専用です。otc_list_sites 以外のすべてのツールで、site 引数が必須です。イベント関連の2つのツールでは、地域イベントカレンダーがない national は拒否されます。ただし、その他のツールでは引き続き検索できます。

ツール	説明
otc_list_events	指定した日のイベントをすべて表示します。時刻、料金、会場を確認できます。free_only を指定すると、無料の掲載情報に絞り込めます。デフォルトは今日です。
otc_events_month_overview	月の日ごとの件数を表示し、最もにぎわう日を探せます。各日の一覧はプレビューであり、実際の件数は total に表示されます。
otc_search_posts	テキスト、カテゴリー、場所、期間を指定して記事を検索します。デフォルトでは概要を簡潔に表示します。
otc_get_post	記事を1件、読みやすいテキストまたは生の HTML で取得します。ID、スラッグ、URLを指定できます。
otc_list_categories	カテゴリー ID と投稿件数を表示します。トピックで検索を絞り込むときに使えます。
otc_list_locations	地域 ID と投稿件数を表示します。地理的な条件で検索を絞り込むときに使えます。
otc_list_sites	ネットワーク内の都市と、それぞれの site キーを表示します。引数は不要です。
otc_healthcheck	サイトへの接続を確認します。失敗時、error.kind は edge_blocked、http、timeout、transport のいずれかになります。

使用例

今週土曜日にシャーロットで無料のイベントはありますか？

8月にレイク・ノーマンで開催される子ども向けイベントを探して

来週末にデンバーとポートランドで楽しめる無料のアクティビティを比較して

知っておくべきことが2つあります

終了したセールはデフォルトで除外されます。 各サイトでは期限切れのオファーを expired カテゴリに分類しているため、検索ではスキップされ、すでに存在しないセールは表示されません。アーカイブを検索するには、include_expired: true を渡してください。カテゴリの ID はサイトごとに異なるため、リクエスト時にスラッグから解決します。ID をハードコードすると、ほかのサイトではフィルターがひそかに無効になります。

カテゴリ ID と地域 ID はサイトごとに異なります。 各サイトは個別の WordPress インストールなので、ID 13 はサイトごとに異なるカテゴリを指します。ID は、検索対象と同じ site に対して解決してください。別の都市の ID を使うと、エラーになるのではなく、無関係な項目で絞り込まれます。

月間概要はプレビューであり、件数は正確です。 カレンダーには、1日あたり最大4件のリスティングが表示されます。otc_events_month_overview はプレビューとともに、各日の正確な合計件数を報告します。全スケジュールを確認するには、日付を指定して otc_list_events を呼び出してください。

設定

ありません。都市は環境変数ではなく、呼び出しごとに指定する site 引数です。そのため、使用前に設定することはありません。

開発

npm install
npm test
npm run build

検証済みのデータ範囲については、docs/OTC-API.md を参照してください。これには、イベントカレンダーの日付を米国形式の M-D-YYYY でルーティングする仕組み（ISO 日付はひそかに1970年として解析されます）、月間ビューの省略、用語 ID をハードコードしない理由が含まれています。

ライセンス

MIT