@hrarsha/evand-mcp 0.0.0-stage → 0.1.0

package/dist/server.js

@@ -0,0 +1,287 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { EvandClient, parseEventSlug } from "./evand.js";
+const SERVER_NAME = "evand-mcp";
+const SERVER_VERSION = "0.1.0";
+const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+function jsonResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+function errorResult(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ error: message }),
+            },
+        ],
+    };
+}
+async function safely(operation) {
+    try {
+        return jsonResult(await operation());
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+}
+const SERVER_INSTRUCTIONS = `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/<slug> 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.`;
+export function createServer(client = new EvandClient()) {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        instructions: SERVER_INSTRUCTIONS,
+        capabilities: { tools: {} },
+    });
+    server.registerTool("search_events", {
+        title: "Search Evand events",
+        description: "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.",
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Free-text search, e.g. 'هوش مصنوعی', 'برنامه نویسی', 'startup', 'DevOps'."),
+            city: z
+                .string()
+                .optional()
+                .describe("City name or slug, e.g. 'تهران', 'tehran', 'اصفهان'. Multiple cities can be comma-separated."),
+            category: z
+                .string()
+                .optional()
+                .describe("Category name or slug, e.g. 'تکنولوژی', 'technology', 'هوش مصنوعی', 'ai', 'فین-تک'."),
+            online: z
+                .boolean()
+                .optional()
+                .describe("true = only online/webinar events; false = only in-person events; omit = both."),
+            include_past: z
+                .boolean()
+                .optional()
+                .describe("Search archived (past) events instead of upcoming events. Default false."),
+            min_price: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Minimum ticket price in Iranian Toman (inclusive). 0 includes free events."),
+            max_price: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Maximum ticket price in Iranian Toman (inclusive)."),
+            start_date_from: z
+                .string()
+                .optional()
+                .describe("Earliest event start date, inclusive, as YYYY-MM-DD in Tehran time (Gregorian)."),
+            start_date_to: z
+                .string()
+                .optional()
+                .describe("Latest event start date, inclusive, as YYYY-MM-DD in Tehran time (Gregorian)."),
+            sort: z
+                .enum(["nearest", "trending", "bestsellers", "randomness", "start_date"])
+                .optional()
+                .describe("nearest = soonest first (default, same as Evand's 'زمان'); trending = most popular; bestsellers = most tickets sold; randomness = random; start_date = start date ascending."),
+            page: z.number().int().min(1).max(1000).optional().describe("Page number, starting at 1. Default 1."),
+            per_page: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Results per page, 1-50. Default 12 (Evand's page size)."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "Search Evand events",
+        },
+    }, async (args) => safely(() => client.searchEvents({
+        query: args.query,
+        city: args.city,
+        category: args.category,
+        online: args.online,
+        include_past: args.include_past,
+        min_price: args.min_price,
+        max_price: args.max_price,
+        start_date_from: args.start_date_from,
+        start_date_to: args.start_date_to,
+        sort: args.sort,
+        page: args.page,
+        per_page: args.per_page,
+    })));
+    server.registerTool("get_event", {
+        title: "Get Evand event details",
+        description: "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/<slug> URL. Use include_description=false for a smaller response.",
+        inputSchema: {
+            slug: z
+                .string()
+                .min(1)
+                .describe("Event slug (e.g. 'devops-w8') or full Evand event URL."),
+            include_description: z
+                .boolean()
+                .optional()
+                .describe("Include the long description (sections, speakers). Default true."),
+            max_description_chars: z
+                .number()
+                .int()
+                .min(0)
+                .max(40_000)
+                .optional()
+                .describe("Maximum characters of description text to return, 0-40000. Default 8000. Set 0 to skip."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "Get Evand event details",
+        },
+    }, async (args) => safely(async () => client.getEvent(parseEventSlug(args.slug), {
+        includeDescription: args.include_description,
+        maxDescriptionChars: args.max_description_chars,
+    })));
+    server.registerTool("get_similar_events", {
+        title: "Get similar Evand events",
+        description: "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.",
+        inputSchema: {
+            slug: z.string().min(1).describe("Event slug or full Evand event URL."),
+            limit: z.number().int().min(1).max(12).optional().describe("Number of similar events, 1-12. Default 6."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "Get similar Evand events",
+        },
+    }, async (args) => safely(async () => {
+        const slug = parseEventSlug(args.slug);
+        return { source_slug: slug, events: await client.getSimilarEvents(slug, args.limit ?? 6) };
+    }));
+    server.registerTool("list_cities", {
+        title: "List Evand cities",
+        description: "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.",
+        inputSchema: {
+            query: z.string().optional().describe("Optional case-insensitive filter on city/province name."),
+            limit: z.number().int().min(1).max(100).optional().describe("Maximum cities to return, 1-100. Default 30."),
+            include_empty: z
+                .boolean()
+                .optional()
+                .describe("Include cities with no currently listed events. Default false."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "List Evand cities",
+        },
+    }, async (args) => safely(() => client.listCities(args.query, args.limit ?? 30, args.include_empty ?? false)));
+    server.registerTool("list_categories", {
+        title: "List Evand categories",
+        description: "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.",
+        inputSchema: {
+            query: z.string().optional().describe("Optional case-insensitive filter on category title, slug or parent."),
+            limit: z.number().int().min(1).max(300).optional().describe("Maximum categories to return, 1-300. Default 100."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "List Evand categories",
+        },
+    }, async (args) => safely(() => client.listCategories(args.query, args.limit ?? 100)));
+    server.registerTool("search_organizations", {
+        title: "Search Evand organizers",
+        description: "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.",
+        inputSchema: {
+            query: z.string().optional().describe("Organization name search, e.g. 'ابرها' or 'CS50'."),
+            sort: z
+                .enum(["followers", "bestsellers", "partnerships"])
+                .optional()
+                .describe("followers = most followed (default); bestsellers = most ticket sales; partnerships = Evand partners."),
+            page: z.number().int().min(1).max(1000).optional().describe("Page number, default 1."),
+            per_page: z.number().int().min(1).max(50).optional().describe("Results per page, 1-50. Default 12."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "Search Evand organizers",
+        },
+    }, async (args) => safely(() => client.searchOrganizations(args)));
+    server.registerTool("get_organization", {
+        title: "Get Evand organizer",
+        description: "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/<slug> URL. Set include_past_events=true to list archived events instead.",
+        inputSchema: {
+            slug: z.string().min(1).describe("Organization slug or full Evand organization URL."),
+            include_events: z.boolean().optional().describe("Include the organization's events. Default true."),
+            events_limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(30)
+                .optional()
+                .describe("Maximum events to include, 1-30. Default 12."),
+            include_past_events: z
+                .boolean()
+                .optional()
+                .describe("Return archived/past events instead of upcoming events. Default false."),
+            max_description_chars: z
+                .number()
+                .int()
+                .min(0)
+                .max(20_000)
+                .optional()
+                .describe("Maximum characters of organizer bio to return, 0-20000. Default 4000."),
+        },
+        annotations: {
+            ...READ_ONLY_ANNOTATIONS,
+            title: "Get Evand organizer",
+        },
+    }, async (args) => safely(async () => client.getOrganization(parseOrganizationSlug(args.slug), {
+        includeEvents: args.include_events,
+        eventsLimit: args.events_limit,
+        includePastEvents: args.include_past_events,
+        maxDescriptionChars: args.max_description_chars,
+    })));
+    return server;
+}
+/** Accepts an org slug or a full https://evand.com/organizations/<slug> URL. */
+function parseOrganizationSlug(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error("An organization slug or URL is required.");
+    if (/^https?:\/\//i.test(trimmed)) {
+        let url;
+        try {
+            url = new URL(trimmed);
+        }
+        catch {
+            throw new Error(`"${input}" is not a valid URL.`);
+        }
+        const hostname = url.hostname.toLowerCase();
+        if (hostname !== "evand.com" && !hostname.endsWith(".evand.com")) {
+            throw new Error(`Expected a URL on evand.com, got ${url.hostname}.`);
+        }
+        const match = url.pathname.match(/^\/organizations\/([^/]+)\/?$/);
+        if (!match?.[1]) {
+            throw new Error(`The URL does not point to an Evand organization page: ${input}`);
+        }
+        return decodeURIComponent(match[1]);
+    }
+    return decodeURIComponent(trimmed
+        .replace(/^\/+/, "")
+        .replace(/^organizations\//i, "")
+        .replace(/\/+$/, ""));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@hrarsha/evand-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Read-only MCP server for discovering events, organizers, cities and categories on Evand (evand.com)",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "evand",
+    "events",
+    "iran"
+  ],
+  "homepage": "https://github.com/Hr-ArshA/evand-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/Hr-ArshA/evand-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hr-ArshA/evand-mcp.git"
+  },
+  "license": "MIT",
+  "author": "https://github.com/Hr-ArshA",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "evand-mcp": "dist/index.js"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "smoke": "tsx scripts/smoke.ts",
+    "check": "npm run typecheck && npm test",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.2",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.0",
+    "vitest": "^5.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  }
+}