Developers · AI assistants · Free

Connect your AI assistant to WhatsMood

WhatsMood is a free discovery service that suggests concerts, live music, theatre, stand-up, festivals, sports, exhibitions and places based on how you feel, in Turkey and selected cities abroad. We open the same information to AI assistants and apps in two ways: a remote MCP server and WebMCP tools that run inside the page.

Instead of guessing, the assistant reads current events, ticket prices and nearby places from whatsmood.com and links each result to its WhatsMood page.

MCP server URLhttps://www.whatsmood.com/mcp

Who is it for?

MCP (Model Context Protocol) is an open protocol that lets AI assistants use tools of outside services in a standard way. WebMCP is a draft web standard that brings the same idea into the web page.

🎧

People looking for something to do

Ask your assistant "I'm tired but want some live music, what's on in Izmir tonight?" and get an answer from WhatsMood's current events.

🛠️

Developers and AI products

Add events, places and mood-based suggestions to your own assistant, agent or app with one URL; no key or account needed.

🧪

Anyone who wants to try

Use the commands below to test the server from a terminal or the browser in a few minutes.

How it works

Both paths reach the same data and both are read-only.

1The user asks"Anything romantic in Istanbul this weekend?"
2The assistant picks a toolsearch_events · mood, city, date
3WhatsMood answersThe MCP server (/mcp) or the WebMCP tool on the page returns current data.
4An answer with linksThe assistant shows events with whatsmood.com links; tickets are bought from the official seller.

Remote MCP server

https://www.whatsmood.com/mcp · Streamable HTTP · no authentication · 9 tools · 60 requests per minute per IP

WebMCP

On whatsmood.com pages · 8 tools · works in Chrome's WebMCP preview; if your browser does not support it, the site works as usual.

Tools

Each card shows the MCP server name and, where available, the WebMCP name. In WebMCP the location parameters are called lat / lng. All tools are read-only.

Read-only

search_events

WebMCP: searchEvents

Finds upcoming events by mood, city, date, category or free text (concerts, live music, theatre, opera, stand-up, festivals, sports, kids & family, exhibitions). Up to 20 events: title, local date/time, venue, city, category, lowest known ticket price and the whatsmood.com event page.

moodMood in English or Turkish (happy, sad, romantic / Mutlu, Üzgün). Optional.
cityCity (Istanbul, Ankara, Izmir, London...). Optional.
datetoday, tomorrow, weekend, this week, YYYY-MM-DD or YYYY-MM-DD..YYYY-MM-DD; default next 30 days.
placeNeighbourhood / district (e.g. Kadıköy, Beşiktaş); events within ~5 km. Optional.
queryArtist, band, show, team, venue or keyword (jazz, rock).
categoryconcert, theatre, comedy, sports, kids, exhibition
limit1-20 (default 10).
Example question: “I feel romantic, what can I do in Istanbul this weekend?”
search_events({ mood: "romantic", city: "Istanbul", date: "weekend" })
  • Eliott Tordo · Saturday 14 November 2026, 20:00 · HOP Sahne - Bakırköy · classical · event page
  • Film & Performans: Deliliğin Hizmetinde & Ha Za Vu Zu · Sunday 15 November 2026, 18:00 · Arter · event page
  • Plus the applied filters, a "times are local to the city" note, the city page link and the "Powered by WhatsMood" credit.
Read-only

get_event

WebMCP: getEventDetails

Details of one event: title, status, local start time, venue and address, city, coordinates, short description, lowest price, event page and calendar (.ics) link.

eventIdEvent id (from search_events or the number at the end of the event URL). In WebMCP it defaults to the event page you are on.
Example question: “Where and when is the Eliott Tordo concert?”
get_event({ eventId: 2904 })
  • 14 November 2026, 20:00, HOP Sahne - Bakırköy, Istanbul; venue address and coordinates.
  • Event page and add-to-calendar (.ics) link.
Read-only

compare_ticket_prices

WebMCP: compareTicketPrices

Compares an event's ticket prices across official sellers: price, currency, category, availability (in_stock, limited, sold_out), cheapest flag and a buy link. Tickets are bought on the seller's own site at their price.

eventIdEvent id.
Example question: “Where is the cheapest ticket for this concert?”
compare_ticket_prices({ eventId: 2904 })
  • Three seller offers for the event: two in stock, one cancelled; the cheapest in-stock offer is flagged.
  • A buy link for each offer.
Read-only

find_nearby_places

WebMCP: findNearbyPlaces

Finds the nearest places of a type around a neighbourhood / district (or an optional coordinate) (open map data): pharmacy, hospital, cafe, restaurant, hotel, ATM, bank, parking, gas station, EV charging, supermarket, mall, museum, park, playground, cinema and more. Name, address, distance, map and directions links. On-duty pharmacy status is not included.

placeNeighbourhood or district name (e.g. "Kadıköy Moda", "Beşiktaş", "Taksim"). Preferred; precise GPS location is not required.
cityCity (disambiguates the place; city alone uses the city centre). Optional.
latitude, longitude / lat, lngOptional coordinates; rounded on the server to about 1 km, not stored.
typePlace type: pharmacy, cafe, restaurant, atm, parking... Turkish names also work. Required.
radiusKm0.3-20 km (default 3).
limit1-15 (default 10).
Example question: “What is the nearest pharmacy to Taksim?”
find_nearby_places({ place: "Taksim", city: "Istanbul", type: "eczane" })
  • Pharmacies from nearest: name, address, distance in metres, map and directions links.
Read-only

list_campaigns

WebMCP: listCampaigns

Lists active campaigns that venues and brands publish on WhatsMood Business, by city, neighbourhood or mood: business name, offer, description, end date, distance. Every result is labelled as sponsored content (sponsored: true); call it only when the user asks for deals or discounts. Personal codes are claimed for free in the app.

cityCity. Optional.
placeNeighbourhood / district name. Optional.
latitude, longitude / lat, lngOptional coordinates (rounded to about 1 km).
moodMood to rank matching deals first. Optional.
Example question: “Are there any deals in Istanbul right now?”
list_campaigns({ city: "Istanbul" })
  • The active deals (or an empty list with a link to the business page).
Read-only

list_moods

WebMCP: listMoods

Lists the moods WhatsMood understands (Turkish name + English equivalent, e.g. Mutlu = happy, Üzgün = sad) and the event categories.

—No parameters.
Example question: “Which moods can I use?”
list_moods()
  • 30 moods, e.g. Romantik = romantic, Sakin = calm, Yorgun = tired, Enerjik = energetic. Categories: concert, theatre, comedy, sports, kids, exhibition.
Read-only

list_cities

WebMCP: none (MCP server only)

Lists cities that currently have upcoming events (most events first) with their city page link. MCP server only.

countryCountry code: TR, GB, DE or ALL (default all).
Example question: “Which cities does WhatsMood cover?”
list_cities({ country: "ALL" })
  • On 12 November 2026 the top entries were Paris, New York, Istanbul, London, Las Vegas, Ankara, each with its whatsmood.com city page.
Read-only

search_public_lists

WebMCP: searchPublicLists

Searches published curated lists by WhatsMood editors and the community, by city, mood or keyword: name, description, city, mood, item count, list URL. Owner names and personal notes are never returned.

cityCity. Optional.
moodMood. Optional.
queryKeyword. Optional.
limit1-10 (default 5).
Example question: “Is there a ready list for a rainy day in Ankara?”
search_public_lists({ city: "Ankara", query: "yağmur" })
  • Matching lists with their pages (or the all-lists page if none match).
Read-only

get_public_list

WebMCP: getPublicList

Returns the items (events, venues, films, music, places) of one published list, each with its page link.

listIdList id from search_public_lists. Required.
Example question: “What is in this list?”
get_public_list({ listId: 12 })
  • The list name, description and a whatsmood.com link for each item; "not found" if the list is not public.

Example answers are summarised from WhatsMood's live data on 12 November 2026; events and prices change over time.

How to connect

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced and turn on Developer mode.
  2. Click Create and name the connector WhatsMood.
  3. URL: https://www.whatsmood.com/mcp · Authentication: No authentication.
  4. Select the connector in a chat and ask: "Any jazz concerts in Ankara this weekend?"

Claude

  1. Go to Settings → Connectors → Add custom connector.
  2. Name: WhatsMood · URL: https://www.whatsmood.com/mcp
  3. Save, enable the connector in a chat and ask.

Other MCP clients and your own app

Add https://www.whatsmood.com/mcp without authentication to any MCP client that supports Streamable HTTP. The server is stateless; no session is required.

Menu names may change between app versions.

Test it yourself

Try the MCP server in a terminal (curl) and the WebMCP tools in the browser.

1. Is the server up? (initialize)

curl -s https://www.whatsmood.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

2. List the tools

curl -s https://www.whatsmood.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. Call a tool

curl -s https://www.whatsmood.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_events","arguments":{"mood":"romantic","city":"Istanbul","date":"weekend","limit":5}}}'

4. See the same data in the browser (JSON)

https://www.whatsmood.com/api/ai/events?city=Istanbul&mood=romantic&date=weekend&limit=5
https://www.whatsmood.com/api/ai/moods

5. WebMCP (DevTools → Console on a whatsmood.com page)

typeof document.modelContext   // "undefined" means your browser has no WebMCP support
const araclar = await document.modelContext.getTools();
araclar.map(t => t.name);
const t = araclar.find(a => a.name === 'searchEvents');
await document.modelContext.executeTool(t, { mood: 'romantic', city: 'Istanbul', date: 'weekend' });

On Windows PowerShell type curl.exe instead of curl and prefer passing the JSON from a file (-d @request.json).

Privacy & security

  • Read-only: every tool only reads; nothing is created, changed or deleted. There is no tool for buying tickets, booking or sending messages.
  • No personal data: no user accounts, location history, chats, list owner names or personal notes are returned. Only public event, place, deal and list information.
  • No login: the MCP server and WebMCP tools need no account, key or cookie; WebMCP requests are sent without cookies.
  • Rate limit: 60 requests per minute per IP address; result counts are capped (e.g. at most 20 events).
  • Usage statistics: only the tool name, client name, duration, result count and filters such as city/mood are recorded; IP addresses, search text and coordinates are not written to this log. Details: privacy policy.
  • Location: a neighbourhood or district name is enough (e.g. place: "Kadıköy Moda"); precise GPS location is not required. If coordinates are sent they are rounded on the server to about 1 km and are not stored.
  • Campaigns are sponsored: list_campaigns results carry sponsored: true and the label "Business campaign (sponsored)"; call it only when the user asks for deals or discounts.
  • Never breaks the site: if the browser has no WebMCP support the script does nothing and the page works as usual.

Frequently asked questions

What is the WhatsMood MCP server?

It is a remote server at https://www.whatsmood.com/mcp that speaks the Model Context Protocol (MCP). AI assistants and apps that support MCP connect to it and query WhatsMood events, concerts, theatre, places, deals and curated lists through tools. It needs no login and is read-only.

What is the difference between WebMCP and the MCP server?

The MCP server is reachable over the internet by any MCP client. WebMCP offers the same kind of tools from the whatsmood.com page itself to the AI assistant in your browser while the page is open; it works in Chrome's WebMCP preview, and if your browser does not support it the site works as usual.

Do I need an account or an API key?

No. The tools work without login; choose "no authentication" when connecting. To prevent abuse there is a limit of 60 requests per minute per IP address.

Does it access my personal data?

No. The tools only return public event, place, deal and list information; no user accounts, location history, chats, list owner names or personal notes are returned. For usage statistics only the tool name, client name, duration, result count and filters such as city/mood are recorded.

Can the assistant buy tickets for me?

No. All tools are read-only. The assistant gives you the event page and the official seller's buy link; you buy the ticket on the seller's site at their price.

Which cities are covered?

Istanbul, Ankara, Izmir, Antalya and many more cities in Turkey, plus selected cities abroad. Use the list_cities tool for the current list.

Which time zone are the times in?

Event times are local to the city where the event takes place; the tool response states this as well.

Why do results include WhatsMood links?

Every event, list and city comes with a whatsmood.com page link and a "Powered by WhatsMood" credit, and assistants are asked to show these links. That way the user can reach details, the map and ticket options.

Contact

For questions, bug reports or partnerships about the tools: destek@whatsmood.com