Search for events across all Philadelphia event sources (Do215, Visit Philly, Eventbrite).

This is the primary tool for discovering events happening in Philadelphia. It aggregates results from multiple sources, deduplicates them, and allows filtering by various criteria.

Args:

• query (string, optional): Text to search in event titles, descriptions, and locations

• categories (array, optional): Filter by categories like 'music', 'food_drink', 'arts_culture', 'sports', 'nightlife', 'comedy', 'outdoor', 'family', 'community', 'workshop', 'networking', 'film', 'theater', 'markets', 'festivals'

• neighborhoods (array, optional): Filter by Philly neighborhoods like 'Fishtown', 'Center City', 'Rittenhouse', 'Northern Liberties', 'Old City', etc.

• start_date (string, optional): Start date in YYYY-MM-DD format

• end_date (string, optional): End date in YYYY-MM-DD format

• is_free (boolean, optional): Only return free events

• max_price (number, optional): Maximum ticket price in USD

• limit (number): Max results to return (default: 20, max: 100)

• offset (number): Pagination offset (default: 0)

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: Aggregated event listings from all sources with deduplication.

Examples:

• "Find live music this weekend" → query="live music", categories=["music"]

• "Free outdoor events in Fishtown" → is_free=true, categories=["outdoor"], neighborhoods=["Fishtown"]

• "Comedy shows under $30" → categories=["comedy"], max_price=30

Search for events from a specific Philadelphia event source.

Use this when you want to search only one source (e.g., just Do215 or just Eventbrite) rather than aggregating from all sources.

Args:

• source (string): Event source to search - one of 'do215', 'visitphilly', 'eventbrite'

• query (string, optional): Search text

• limit (number): Max results (default: 20)

• response_format ('markdown' | 'json'): Output format

Available sources:

• do215: Local indie events, arts, music, nightlife

• visitphilly: Tourism-focused events, major attractions

• eventbrite: Ticketed events, workshops, professional events

Convert Philadelphia events to Google Calendar format for import.

This tool takes event IDs (from search results) and returns them in Google Calendar JSON format, ready for import via the Google Calendar API.

Args:

• event_ids (array): Array of event IDs to export (max 50)

• include_description (boolean): Include full description (default: true)

• include_source_link (boolean): Include link to original event (default: true)

Returns: Array of Google Calendar event objects ready for API import.

Example workflow:

1. Use philly_search_events to find events

2. Note the event IDs from results

3. Call this tool with those IDs to get calendar format

4. Import to Google Calendar via API

List all available event categories for filtering Philadelphia events.

Use this to discover what categories are available when searching for events.

List all recognized Philadelphia neighborhoods for filtering events.

Use this to discover what neighborhood filters are available.

Generate a curated weekly digest of Philadelphia events.

This tool searches for events happening in the next 7 days and formats them as a digestible newsletter-style summary, organized by category.

Args:

• categories (array, optional): Focus on specific categories

• neighborhoods (array, optional): Focus on specific neighborhoods

• include_free_only (boolean): Only include free events (default: false)

• max_events (number): Maximum events in digest (default: 20, max: 50)

• response_format ('markdown' | 'json'): Output format

Perfect for:

• Weekly event roundup emails

• Planning your weekend

• Discovering new things to do