Frequently Asked Questions (FAQ) about Event Planner MCP

Q: What is Event Planner MCP?

A: Event Planner MCP is an AI Agent designed to provide event recommendations based on city and date, using the Ticketmaster API. It is integrated within the UBOS platform.

Q: What is UBOS?

A: UBOS is a full-stack AI Agent Development Platform that allows you to orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems.

Q: How does Event Planner MCP work?

A: It uses the Ticketmaster API to search for events based on the city and date provided in the request. It then returns a list of events with details like title, date, time, location, and price.

Q: What is MCP (Model Context Protocol)?

A: MCP is an open protocol that standardizes how applications provide context to LLMs. It allows AI models to access external data sources, like the Ticketmaster API in this case.

Q: How do I install Event Planner MCP?

A: You can install it by cloning the repository, installing the dependencies using pip install -r requirements.txt, or by building and running the Docker image.

Q: Do I need a Ticketmaster API key?

A: The API key is included in the code, but you can optionally override it by setting the TICKETMASTER_API_KEY environment variable in a .env file.

Q: How do I use the API?

A: Send a POST request to the /events endpoint with a JSON payload containing the city and date. For example: {"city": "İstanbul", "date": "2024-12-25"}.

Q: What format does the API return?

A: The API returns a JSON response containing a list of events, each with details like title, date, time, location, city, type, price, URL, and description.

Q: What happens if the Ticketmaster API returns an error?

A: The API will return example data in case of an error to prevent disruption.

Q: Is there Docker support?

A: Yes, Event Planner MCP supports Docker. You can build and run the Docker image using the provided Dockerfile.

Q: Is there support for environment variables?

A: Yes, you can use environment variables to configure the API key.

Q: Are there any limitations?

A: Yes, it is currently limited to events in Turkey (TR) and returns a maximum of 20 events.

Q: Can I use this for commercial purposes?

A: Please refer to the Ticketmaster API terms of service for commercial usage rights.

Q: Where can I find more information about UBOS?

A: Visit the UBOS website at https://ubos.tech for more information about the platform and its capabilities.