# Onthecheap MCP

> Onthecheap MCP is an open-source MCP server for events and entertainment. MCP server for free and cheap events, deals and local guides in 14 US city sites. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/chrischall/onthecheap-mcp
- **MCP Registry name:** io.github.chrischall/onthecheap-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment), [local services](https://ai-powered.com/categories/local-services)
- **Listing updated:** 2026-11-18

## About

One server covers the whole On the Cheap network of local guides, from Charlotte and Denver to Seattle, Miami and Southern Maine, plus a national site for US-wide deals. Each call names a site, with no default, so a Denver question can never silently return Charlotte data.

The event tools list a day's listings with time, price and venue, optionally free only, and give month overviews with true counts beside a preview of up to four listings per day. Search tools cover articles by text, category, location and date. Expired deals are excluded unless include_expired is set.

It needs no credentials and reads the public sites over HTTPS. The README notes each site is a separate WordPress install, so category and location ids differ per city, and the national site has no events calendar.

## Features

- **Daily event listings:** Time, price and venue for any day, with a free-only filter.
- **Month overview:** Day-by-day counts to find busy days.
- **Article search:** Search by text, category, location and date range.
- **Full articles:** Return text, Markdown or raw HTML.
- **Expired deals hidden:** Retired offers are skipped unless requested.
- **Required city argument:** Avoids answering for the wrong city.

## Good for

- Find free things to do in Charlotte this Saturday
- Look for kids' events in a specific area
- Compare free activities across two cities
- Search the archive for deals and guides

## Install

### Claude Code (Terminal)

```sh
claude mcp add onthecheap-mcp -- npx -y onthecheap-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "onthecheap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onthecheap-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onthecheap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onthecheap-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onthecheap-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onthecheap-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onthecheap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onthecheap-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onthecheap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onthecheap-mcp"
      ]
    }
  }
}
```

## Tools

- `otc_list_events`: Everything on a given day with time, price and venue.
- `otc_events_month_overview`: Day-by-day counts for a month.
- `otc_search_posts`: Search articles by text, category, location and date.
- `otc_get_post`: One article in full.
- `otc_list_categories`: Category ids and post counts.
- `otc_list_locations`: Local area ids and post counts.
- `otc_list_sites`: Cities in the network and their site keys.
- `otc_healthcheck`: Checks one site is reachable.

## FAQ

### Which cities are covered?

Fourteen sites including Charlotte, Denver, Atlanta, Chicago, Columbus, Seattle, Kansas City, Miami, Orlando, Portland, Richmond, Southern Maine, the Triangle and a national site.

### Do I need an API key?

No credentials are required.

### Why must I pass a site?

So the answer is never silently drawn from a default city.

### What is the licence?

MIT.

### Is Onthecheap MCP free?

Yes. Onthecheap MCP is open source, so you can use and self-host it for free.

### How do I add Onthecheap MCP to Claude Code?

Run this command in your terminal: claude mcp add onthecheap-mcp -- npx -y onthecheap-mcp

### What are the best alternatives to Onthecheap MCP?

The closest alternatives to Onthecheap MCP are Dostuff, Eventbrite, Sf Recpark, Edmtrain and Nyc Parks.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium MCP server for events and entertainment.
- [Sf Recpark](https://ai-powered.com/mcp/sf-recpark): Sf Recpark is a freemium MCP server for events and entertainment.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Nyc Parks](https://ai-powered.com/mcp/nyc-parks): Nyc Parks is a freemium MCP server for events and entertainment.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source MCP server for events and entertainment.
- [Zovo Place Card Maker](https://ai-powered.com/mcp/zovo-place-card-maker): Zovo Place Card Maker is an MCP server for events and entertainment.
- [Ticketmaster](https://ai-powered.com/mcp/ticketmaster): Ticketmaster is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/onthecheap-mcp
