touch-grass-mcp

Preference-aware events discovery MCP server. Surfaces what you'd actually want to do — not what's loudest.

touch-grass-mcp is a Model Context Protocol server that aggregates events, restaurants, museums, music, and trending venues across multiple sources, then re-ranks results against your taste profile so you stop scrolling generic event listings and start finding things you'd actually go to.

Self-hosted by design. Zero telemetry. All data stays on your machine.

What you get

Core (works in any US city):

• Concerts (Ticketmaster, Resident Advisor, Dice)
• Restaurants + bars (Yelp)
• Local groups + meetups (Meetup, Eventbrite)
• Theater (TodayTix)
• Breweries (Open Brewery DB)
• Weather (NWS)
• Editorial picks (Eater, Gothamist, Time Out, Hyperallergic, Artforum)

NYC pack (activates when your profile city is New York):

• Public libraries (NYPL, BPL, QPL)
• Museums (MoMA, Met, Whitney, Frick, Carnegie Hall, 92Y, Park Avenue Armory, MoMA PS1)
• Venues (Lincoln Center, Brooklyn Steel, Metrograph, Village Vanguard, Village Jazz)
• NYC Open Data (city-permitted events)
• Audubon (birding walks)
• Curated community calendars

The taste engine — what makes this different from a flat aggregator:

• Profile-driven scoring: your interests, dislikes, vibe preferences, neighborhoods
• City pulse: live trend tracker (Reddit + Google Trends + RSS) that surfaces what's rising

Install

pip install touch-grass-mcp
# or with optional pulse + NLP support:
pip install "touch-grass-mcp[pulse,nlp]"

First-run setup

# One unified onboarding wizard: profile + city pack + API keys
touch-grass setup

# Fast launch for a known city (auto-fills state + pulse defaults):
touch-grass setup --city "san francisco"

# See available city starter packs:
touch-grass list-cities

# Already configured profile? Just (re)do API keys:
touch-grass setup --keys-only

# Sanity check:
touch-grass doctor

City starter packs auto-fill subreddits, RSS feeds, and Google Trends geo when your profile city matches. Currently bundled: NYC (deep coverage), SF, LA, Chicago, Austin, Boston, Seattle, DC. PRs welcome to add more.

Wire it into Claude Desktop / Claude Code

Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json or ~/.claude.json):

{
  "mcpServers": {
    "touch-grass": {
      "command": "touch-grass",
      "args": ["serve"]
    }
  }
}

Tools exposed

23 MCP tools across 5 categories:

Event search: search_events, search_concerts, discover_niche_events, trending_events, get_event_details, search_community_calendars, search_ra_events, get_ra_event_details

Dining + venues: search_restaurants, search_breweries, get_restaurant_details

Arts + culture: search_broadway_shows, get_broadway_showtimes, get_museum_exhibitions, search_met_collection, get_editorial_picks, get_editorial_feed

Profile + recommendation: get_user_profile, update_user_preferences, get_recommendation_keywords

Calibration + utility: weekend_weather, log_flag_feedback, get_calibration_stats

Configuration

• Profile: ~/.config/touch-grass/config.json (run touch-grass init to bootstrap)
• API keys: ~/.config/touch-grass/.env (or shell env)
• Cache + state: ~/.local/share/touch-grass/ (XDG paths)

See CONFIG.md for the full profile schema.

Privacy

Read PRIVACY.md before installing. Short version: zero telemetry, no analytics, no phone-home, all data local.

Architecture

• taste/ — pure-Python preference engine: load profile, score events, rank by relevance. Zero MCP dependencies; importable from any context.
• pulse/ — cultural trend tracker that re-ranks against current Reddit / Trends / RSS signal.
• packs.py — city-pack registry. NYC pack bundled. Adding a new city is a documented contribution.
• server.py — FastMCP server that wires it all together.

Cities other than NYC

The core pack works anywhere in the US. NYC is the bundled deep-coverage city. Adding a new city = drop scrapers in clients/<city>/, register a CityPack in packs.py, supply pulse defaults. PRs welcome.

License

MIT.

Status

v0.1 — alpha. Stable enough for personal use; expect breakage in fragile scrapers (museums, RSS).