Charlotteonthecheap Mcp

io.github.chrischall由 GitHub 帳號 chrischall 發布v0.1.1更新於 Oct 24, 2026

Charlotte On The Cheap MCP — free and cheap Charlotte events, deals and local guides

已驗證STDIO僅桌面位置與生活網頁搜尋與抓取

概覽

AI 產生的概覽

讀取 On the Cheap 網路中 14 個美國城市網站的免費與低價在地活動、優惠和指南。

可以做什麼
提供針對 On the Cheap 在地網站網路的唯讀工具。otc_list_events 回傳某天的活動，包含時間、價格和場地，並可篩選免費項目；otc_events_month_overview 提供某月逐日活動數量；otc_search_posts 依文字、分類、地點和日期範圍搜尋文章；otc_get_post 回傳單篇文章全文；otc_list_categories、otc_list_locations 和 otc_list_sites 列出篩選條件與城市；otc_healthcheck 檢查網站是否可連線。除 otc_list_sites 外，每個工具都需要必填的 site 參數指定城市。
適用情境
適合需要取得所涵蓋都會區目前在地活動行程、免費或低價活動，以及過往優惠和指南的情境。可用於行程規劃、週末活動建議和城市間比較，而非一般網頁搜尋。
執行需求
以 npm 套件形式透過 stdio 在本機執行，通常以 npx 啟動，因此需要 Node.js。不需要憑證或帳號，網站公開並透過 HTTPS 讀取。選用環境變數 COTC_BASE_URL 可覆寫基礎網址。僅支援桌面端。
安裝前請注意
所有工具皆為唯讀，不會寫入、傳送或刪除資料。專案聲明由 AI 開發與維護，並提醒自行斟酌使用。活動與月度資料可能是預覽而非完整清單，且分類與地點 id 因網站而異，必須針對同一個網站解析 id。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Charlotteonthecheap Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

onthecheap-mcp

MCP server for the On the Cheap network — local guides to free and cheap things to do across 14 US cities. Daily event listings with times, prices and venues, plus a searchable archive of deals and guides.

Developed and maintained by AI (Claude Code). Use at your own discretion.

No credentials required. Every site is public, so the server reads them server-side over plain HTTPS. There is nothing to configure beyond which city you want, and no browser extension involved.

Install

bash
npx onthecheap-mcp

Or as a Claude Code plugin:

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

Choosing a city

One server reads the whole network. Every tool takes a site argument naming the city to read — there is no default and no configuration step:

KeySiteArea
charlotteCharlotte On The CheapCharlotte, NC
denverMile High on the CheapDenver, CO
atlantaAtlanta on the CheapAtlanta, GA
chicagoChicago on the CheapChicago, IL
columbusColumbus on the CheapColumbus, OH
seattleGreater Seattle on the CheapSeattle–Tacoma
kansascityKansas City on the CheapKansas City
miamiSouth Florida on the CheapMiami / Broward / Palm Beach
orlandoOrlando on the CheapOrlando, FL
portlandPortland Living on the CheapPortland, OR
richmondRVA on the CheapRichmond, VA
southernmaineSouthern Maine on the CheapSouthern Maine
triangleTriangle on the CheapRaleigh / Durham / Chapel Hill
nationalLiving On The CheapUS-wide deals (no local events calendar)

Common aliases work too — milehigh, raleigh, rva, kc, southflorida. otc_list_sites reports the same list.

site is required rather than defaulted on purpose: a server that quietly fell back to one city would answer a question about Denver with Charlotte's data and give no sign anything was wrong. An unknown key is refused with the valid ones listed.

Tools

All tools are read-only. Every tool except otc_list_sites takes a required site argument. The two event tools reject national, which has no local events calendar — it is still searchable via the other tools.

ToolWhat it does
otc_list_eventsEverything on a given day — time, price, venue. free_only filters to no-cost listings. Defaults to today.
otc_events_month_overviewDay-by-day counts for a month, to find the busiest days. Each day's list is a preview; total is the real count.
otc_search_postsSearch articles by text, category, location and date range. Returns slim summaries by default.
otc_get_postOne article in full, as readable text or raw HTML. Accepts an id, slug, or URL.
otc_list_categoriesCategory ids and post counts, for filtering searches by topic.
otc_list_locationsLocal area ids and post counts, for filtering geographically.
otc_list_sitesThe cities in the network and their site keys. Takes no arguments.
otc_healthcheckConfirm one site is reachable; on failure error.kind is edge_blocked, http, timeout or transport.

Examples

What's free in Charlotte this Saturday?

Find kids' events in Lake Norman in August

Compare free things to do in Denver and Portland next weekend

Two things worth knowing

Retired deals are excluded by default. Each site parks expired offers in an expired category, so searches skip them and you don't get deals that no longer exist. Pass include_expired: true to search the archive. The category's id differs on every site, so it's resolved by slug at request time — a hardcoded id silently disables the filter elsewhere.

Category and location ids are per-site. Each site is a separate WordPress install, so id 13 is a different category on every one of them. Resolve ids against the same site you then search — an id borrowed from another city will filter to something unrelated rather than error.

Month overviews are previews, with honest counts. The calendar shows at most four listings per day. otc_events_month_overview reports each day's true total alongside the preview — call otc_list_events with a date for the complete schedule.

Configuration

None. The city is a per-call site argument, not an environment variable, so there is nothing to set up before use.

Development

bash
npm installnpm testnpm run build

See docs/OTC-API.md for the verified data surface, including the events calendar's US M-D-YYYY date routing (an ISO date is silently parsed as 1970), the month-view truncation, and why term ids are never hardcoded.

License

MIT

來源：README.md，提交 bb0c94a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分