evand-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EVAND_MCP_DEBUG | No | Set to `1` to log retries and description failures to stderr. Unset by default. | |
| EVAND_TIMEOUT_MS | No | Per-request timeout in milliseconds (clamped to 1000–60000). | 20000 |
| EVAND_API_BASE_URL | No | Evand API base URL (useful for a proxy/mock). | https://api.evand.com |
| EVAND_WEB_BASE_URL | No | Base URL used to build human-facing event/org/city links. | https://evand.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Evand (evand.com) is an Iranian event discovery and ticketing platform. Use this server to find public events, read event details, prices, tickets, organizers, cities and categories.
Guidance:
Start with search_events. Persian and English search terms both work, but Evand content is mostly Persian, so Persian queries usually return better results.
Filter by city/category with names or slugs. Unsure of a name? Call list_cities or list_categories first; common English aliases (Tehran, Isfahan, technology, AI, ...) are resolved automatically.
Event slugs come from search results or from evand.com/events/ URLs. get_event accepts either.
Dates and times are in Asia/Tehran. Prices are in Iranian Toman. "Free" means no ticket price.
Ticket purchase, login and registration are not supported by this server. Give the user the event URL / registration_url and let them complete the purchase on evand.com.
This server is read-only and uses Evand's public website API, which is undocumented and may change.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_eventsA | Search upcoming public events on Evand (evand.com) by Persian/English keyword, city, category, online status, price and start date. Returns compact event cards with slugs and URLs plus pagination. Set include_past=true to search Evand's archive of past events. If a city or category is rejected, call list_cities or list_categories to discover the accepted names/slugs. |
| get_eventA | Get full public details for a single Evand event: description, speakers/organizers, schedule/showtimes, tickets and remaining capacity, price, venue/location, organizer, categories, tags and refund policy. Accepts an event slug (from search_events) or a full https://evand.com/events/ URL. Use include_description=false for a smaller response. |
| get_similar_eventsA | Get Evand's recommendations for events similar to a given event. Useful for 'what else is like this?' follow-ups. Accepts a slug or full Evand event URL. |
| list_citiesA | List Iranian cities that have events on Evand, with event counts and the slug to pass to search_events. Results are sorted by event count. Use this when a city filter is ambiguous or you need the exact spelling. |
| list_categoriesA | List Evand event categories and subcategories with their slugs, parent categories and event counts. Use the slug or title as the category filter in search_events. |
| search_organizationsA | Search organizations that host events on Evand, by name. Returns follower/event counts and the organization slug. Sort by followers (default), bestsellers, or partnerships. Use get_organization for full details and their events. |
| get_organizationA | Get an Evand organization's profile (bio, logo, social links, followers, event counts) and, by default, its current/upcoming events. Accepts an organization slug or full https://evand.com/organizations/ URL. Set include_past_events=true to list archived events instead. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool maps to a distinct resource+action: single-event lookup, similar-event recommendation, event search, organization get/search, and city/category enumeration. The only mild overlap is that get_organization returns events by default, which partially overlaps with event search results, but the descriptions make the intended usage clear.
All names are snake_case verb_noun with a predictable semantic split: get_* for single-resource fetch, search_* for filtered queries, list_* for enumerations. No style mixing or vague verbs.
Seven tools is well-scoped for a read-only public events API, with no filler tools. Each tool covers a necessary part of the discovery flow (find -> inspect -> expand -> disambiguate filters).
The discovery lifecycle is well covered: search, detail, similar events, organizations, and filter lookups for cities/categories. Minor gaps exist for first-class entity lookups such as venues/speakers or a direct category/city detail tool, but these are largely inlined in get_event or reachable via list_* tools.