MCP Server

EventWave

io.github.jgaethle10/eventwave
Commerce & Retail Marketing & Advertising Public & reachable MCP 2025-11-25

What this MCP does

Searches public events and supports human-reviewed promotion workflows, including promotion offers, checkout preparation, payment verification, and placement status.

get_eventwave_capabilities
Get EventWave agent capabilities
Describe EventWave machine-facing discovery, promotion, evidence, and payment boundaries.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_eventwave_promotion_offers
Get EventWave promotion offers
List current EventWave paid promotion packages and their evidence/payment boundaries. Read-only; creates no checkout, invoice, charge, or payment obligation.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_eventwave_promotion_status
Get EventWave promotion payment and placement status
Read promotion order state and independently verify payment when a checkout session exists. Read-only from the agent perspective; may advance internal verified payment state.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string', 'maxLength': 120, 'minLength': 8}}}
prepare_event_promotion_checkout
Prepare a human-confirmed EventWave promotion checkout
After the human explicitly agrees to pay for a selected EventWave promotion package, prepare the secure checkout. Checkout creation is not payment proof and source review still controls public placement.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['user_confirmed_payment', 'offer_key', 'contact_email'], 'properties': {'city': {'type': 'string', 'maxLength': 160}, 'offer_key': {'enum': ['event_boost_49', 'venue_pack_149'], 'type': 'string'}, 'buyer_note': {'type': 'string', 'maxLength': 1200}, 'target_url': {'type': 'string', 'maxLength': 1000}, 'venue_name': {'type': 'string', 'maxLength': 220}, 'event_title': {'type': 'string', 'maxLength': 240}, 'contact_email': {'type': 'string', 'format': 'email', 'pattern': "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'maxLength': 254}, 'organizer_name': {'type': 'string', 'maxLength': 160}, 'target_event_id': {'type': 'string', 'maxLength': 120}, 'user_confirmed_payment': {'type': 'boolean', 'const': True}}}
prepare_event_promotion_handoff
Prepare an EventWave human promotion review link
Prepare a review URL for a selected EventWave promotion package. This does not create checkout, invoice, charge, entitlement, or payment obligation. The human must review the page and explicitly start checkout there.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offer_key'], 'properties': {'source': {'type': 'string', 'maxLength': 60}, 'event_id': {'type': 'string', 'maxLength': 120}, 'offer_key': {'enum': ['event_boost_49', 'venue_pack_149'], 'type': 'string'}, 'event_title': {'type': 'string', 'maxLength': 240}}}
search_events
Search EventWave events
Search upcoming EventWave public event records by city, category, date window, and keyword. Returns evidence state and original source URLs. Read-only.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'maxLength': 120}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 160}, 'category': {'enum': ['Music', 'Sports', 'Food', 'Arts', 'Community', 'Comedy', 'Theater', 'Conference', 'Festival', 'Nightlife', 'Other'], 'type': 'string'}, 'days_ahead': {'type': 'integer', 'maximum': 90, 'minimum': 1}}}
Added
get_eventwave_capabilities
Sept. 25, 2026, 2:40 a.m.
Added
get_eventwave_promotion_status
Sept. 25, 2026, 2:40 a.m.
Added
prepare_event_promotion_checkout
Sept. 25, 2026, 2:40 a.m.
Added
prepare_event_promotion_handoff
Sept. 25, 2026, 2:40 a.m.
Added
get_eventwave_promotion_offers
Sept. 25, 2026, 2:40 a.m.
Added
search_events
Sept. 25, 2026, 2:40 a.m.