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 分