irlevents-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IRLEvents
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# irlevents-mcp
+
+Model Context Protocol server for [IRLEvents](https://irlevents.io) — the
+token-gated event platform for the on-chain world.
+
+Plugs IRLEvents into **Claude Desktop**, **Claude Code**, **Cursor**, **Cline**,
+and any other MCP-compatible client. Once configured, the model can list events,
+check whether you qualify for a token gate, RSVP, sync your on-chain assets,
+and more — all on your behalf, using a long-lived `api_*` key you control.
+
+## Tools exposed
+
+| Tool | What it does |
+|---|---|
+| `list_events` | List public events with filters (category, city, chainId, date range) |
+| `trending_events` | Most RSVPed events in the last 14 days |
+| `get_event` | Single event by short id (title, dates, location, gates) |
+| `top_creators` | Leaderboard of top creators |
+| `platform_stats` | Cached platform-wide counts |
+| `get_my_profile` | Read your own profile, wallets, cached assets |
+| `sync_my_assets` | Force-refresh NFT/token holdings across chains (slow, don't poll) |
+| `check_eligibility` | Will I pass this event's token gate? |
+| `rsvp_status` | My RSVP state for this event |
+| `rsvp_event` | RSVP on my behalf (locks the qualifying token) |
+| `cancel_rsvp` | Cancel my RSVP, free the locked token |
+| `my_eligible_events` | Every public event a wallet currently qualifies for |
+
+Sensitive actions (key management, billing, 2FA, OAuth unlink, account delete)
+are **not** exposed — those still require a browser session at irlevents.io.
+
+## Setup
+
+### 1. Mint an API key
+
+Sign in at https://irlevents.io, open **Profile → API Keys**, click **Create
+key**, and copy the `api_<64 hex>` value. It's only shown once.
+
+### 2. Add to your MCP client config
+
+#### Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows)
+
+```json
+{
+  "mcpServers": {
+    "irlevents": {
+      "command": "npx",
+      "args": ["-y", "irlevents-mcp"],
+      "env": {
+        "IRLEVENTS_API_KEY": "api_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The IRLEvents tools will appear in the tools panel.
+
+#### Claude Code (project-scoped, `.mcp.json` at the repo root)
+
+```json
+{
+  "mcpServers": {
+    "irlevents": {
+      "command": "npx",
+      "args": ["-y", "irlevents-mcp"],
+      "env": { "IRLEVENTS_API_KEY": "api_your_key_here" }
+    }
+  }
+}
+```
+
+Or via CLI: `claude mcp add irlevents npx -y irlevents-mcp -e IRLEVENTS_API_KEY=api_...`
+
+#### Cursor (`~/.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "irlevents": {
+      "command": "npx",
+      "args": ["-y", "irlevents-mcp"],
+      "env": { "IRLEVENTS_API_KEY": "api_your_key_here" }
+    }
+  }
+}
+```
+
+#### Cline (VS Code MCP settings)
+
+Same config shape — add under `cline.mcpServers`.
+
+### 3. Try it
+
+Ask the model:
+
+- *"What events are trending on IRLEvents right now?"*
+- *"List events in Las Vegas this month."*
+- *"Check if I'm eligible for event 7s5TZhMQqrCs."*
+- *"RSVP me to that event if I qualify."*
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `IRLEVENTS_API_KEY` | *(required)* | Your `api_*` key |
+| `IRLEVENTS_API_BASE` | `https://irlevents.io` | Override for staging or self-hosted |
+
+## Local development
+
+```bash
+git clone <this repo>
+cd irlevents-mcp
+npm install
+npm run build
+IRLEVENTS_API_KEY=api_... node dist/index.js
+```
+
+To smoke-test the wire format without a live MCP client:
+
+```bash
+printf '%s\n%s\n%s\n' \
+  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"0.0.1"}}}' \
+  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
+  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
+  | IRLEVENTS_API_KEY=api_... node dist/index.js
+```
+
+## Etiquette
+
+- **Don't poll `sync_my_assets`.** It hits external NFT providers (Alchemy,
+  Helius, Hiro). Once per session is plenty.
+- **Always `check_eligibility` before `rsvp_event`.** The API rejects ineligible
+  users with 403 — you'll waste a tool call otherwise.
+- **Respect rate limits.** Each api key gets 1000 req/hr by default. The IRLEvents
+  API returns `X-RateLimit-Remaining` headers; this MCP server surfaces 429
+  errors back to the model so it can back off.
+
+## See also
+
+- [IRLEvents agent guide](https://irlevents.io/api/guides/agent-guide)
+- [Full agent docs (one-shot LLM ingest)](https://irlevents.io/llms-full.txt)
+- [OpenAPI spec](https://irlevents.io/api/openapi.json)
+- [Webhook integration guide](https://irlevents.io/api/guides/webhook-guide) — push instead of pull
+
+## Releasing (maintainers)
+
+CI auto-publishes to npm when a `v*.*.*` tag is pushed. Steps:
+
+```bash
+# 1. Bump version in package.json (e.g. 0.1.0 → 0.1.1)
+# 2. Commit
+git commit -am "Release v0.1.1"
+
+# 3. Tag and push
+git tag v0.1.1
+git push && git push --tags
+```
+
+The GitHub Actions workflow (`.github/workflows/publish.yml`) will:
+
+1. Verify the tag matches `package.json` version
+2. Build with `tsc`
+3. Smoke-test the MCP handshake (asserts all 12 tools register)
+4. Publish to npm with provenance attestation
+
+Required GitHub repo secret: **`NPM_TOKEN`** — an npm "Automation" or
+"Publish" token. Generate at <https://www.npmjs.com/settings/_/tokens>,
+then add at *Settings → Secrets and variables → Actions*.
+
+## License
+
+MIT

package/dist/client.js

@@ -0,0 +1,68 @@
+// Thin fetch wrapper around the IRLEvents API.
+// Used by every tool handler in src/index.ts. Centralizes auth, base URL,
+// and error shape normalization so individual tools stay one-liners.
+const DEFAULT_BASE = "https://irlevents.io";
+export class IRLApiError extends Error {
+    status;
+    code;
+    body;
+    constructor(status, code, message, body) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.body = body;
+        this.name = "IRLApiError";
+    }
+}
+export function createClient(opts) {
+    const base = (opts.base ?? DEFAULT_BASE).replace(/\/+$/, "");
+    if (!opts.apiKey) {
+        throw new Error("IRLEVENTS_API_KEY is required");
+    }
+    if (!opts.apiKey.startsWith("api_")) {
+        throw new Error('IRLEVENTS_API_KEY must start with "api_"');
+    }
+    async function request(path, init = {}) {
+        const url = new URL(base + (path.startsWith("/") ? path : "/" + path));
+        const { query, ...rest } = init;
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== null && v !== "")
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        const headers = new Headers(rest.headers);
+        headers.set("Authorization", `Bearer ${opts.apiKey}`);
+        headers.set("Accept", "application/json");
+        if (rest.body && !headers.has("Content-Type")) {
+            headers.set("Content-Type", "application/json");
+        }
+        headers.set("User-Agent", "irlevents-mcp/0.1.0");
+        const res = await fetch(url, { ...rest, headers });
+        const text = await res.text();
+        let parsed = text;
+        if (text && (res.headers.get("content-type") || "").includes("json")) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // leave as text
+            }
+        }
+        if (!res.ok) {
+            const body = parsed;
+            const code = typeof body === "object" && body !== null
+                ? body.code ?? body.error ?? null
+                : null;
+            const msg = (typeof body === "object" && body !== null
+                ? body.message
+                : undefined) ??
+                (typeof body === "string" ? body : null) ??
+                `HTTP ${res.status}`;
+            throw new IRLApiError(res.status, code, msg, parsed);
+        }
+        return parsed;
+    }
+    return { base, request };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+// IRLEvents MCP Server
+//
+// Exposes the IRLEvents agent-callable API as Model Context Protocol tools so
+// Claude Desktop, Claude Code, Cursor, Cline, and other MCP-compatible clients
+// can read and act on a user's behalf with their api_* key.
+//
+// Configure in claude_desktop_config.json:
+//   {
+//     "mcpServers": {
+//       "irlevents": {
+//         "command": "npx",
+//         "args": ["-y", "irlevents-mcp"],
+//         "env": { "IRLEVENTS_API_KEY": "api_..." }
+//       }
+//     }
+//   }
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createClient, IRLApiError } from "./client.js";
+const apiKey = process.env.IRLEVENTS_API_KEY;
+if (!apiKey) {
+    console.error("irlevents-mcp: IRLEVENTS_API_KEY env var is required.\n" +
+        "Mint a key at https://irlevents.io/profile (API Keys tab) and pass it as:\n" +
+        '  { "env": { "IRLEVENTS_API_KEY": "api_..." } }\n' +
+        "in your MCP client config.");
+    process.exit(1);
+}
+const client = createClient({
+    apiKey,
+    base: process.env.IRLEVENTS_API_BASE,
+});
+const server = new McpServer({ name: "irlevents-mcp", version: "0.1.0" }, {
+    capabilities: { tools: {} },
+    instructions: "Tools for the IRLEvents token-gated event platform. Use list_events / " +
+        "trending_events / get_event to discover; check_eligibility before any " +
+        "rsvp_event call (the API will reject ineligible users). Use sync_my_assets " +
+        "sparingly — it hits external NFT providers and is slow.",
+});
+// ----- Helpers ----------------------------------------------------------
+function ok(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof data === "string" ? data : JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function err(e) {
+    if (e instanceof IRLApiError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `IRLEvents API error ${e.status}${e.code ? ` (${e.code})` : ""}: ${e.message}`,
+                },
+            ],
+        };
+    }
+    const msg = e instanceof Error ? e.message : String(e);
+    return {
+        isError: true,
+        content: [{ type: "text", text: `Error: ${msg}` }],
+    };
+}
+async function handle(fn) {
+    try {
+        return ok(await fn());
+    }
+    catch (e) {
+        return err(e);
+    }
+}
+// ----- Discovery tools (no user-context needed) -------------------------
+server.registerTool("list_events", {
+    title: "List events",
+    description: "List public IRLEvents events. Filter by category, city, chain, or date range. " +
+        "Returns a paginated list of event summaries.",
+    inputSchema: {
+        category: z.string().optional().describe("e.g. 'conference', 'meetup', 'workshop'"),
+        city: z.string().optional().describe("City name, e.g. 'Las Vegas'"),
+        chainId: z.number().int().optional().describe("EVM chain id, e.g. 1, 137, 8453"),
+        from: z.string().optional().describe("ISO 8601 date — events starting on/after this"),
+        to: z.string().optional().describe("ISO 8601 date — events starting on/before this"),
+        limit: z.number().int().min(1).max(100).optional().default(20),
+        offset: z.number().int().min(0).optional().default(0),
+    },
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async (args) => handle(() => client.request("/api/events", { query: args })));
+server.registerTool("trending_events", {
+    title: "Trending events",
+    description: "Most RSVPed events in the last 14 days. Fast, public, cached. Good first call " +
+        "to surface what's happening right now.",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async () => handle(() => client.request("/api/events/trending")));
+server.registerTool("get_event", {
+    title: "Get event details",
+    description: "Fetch a single event by its short id (e.g. '7s5TZhMQqrCs'). Returns title, " +
+        "description, dates, location, capacity, host, and the full gates config.",
+    inputSchema: {
+        eventId: z.string().describe("Public event short id"),
+    },
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ eventId }) => handle(() => client.request(`/api/events/${encodeURIComponent(eventId)}`)));
+server.registerTool("top_creators", {
+    title: "Top creators leaderboard",
+    description: "Top creators on IRLEvents ranked by RSVPs and events hosted.",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async () => handle(() => client.request("/api/creators/leaderboard")));
+server.registerTool("platform_stats", {
+    title: "Platform stats",
+    description: "Cached platform-wide counts: events, RSVPs, creators, chains active.",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async () => handle(() => client.request("/api/stats/public")));
+// ----- User-context tools (act on the api key owner) --------------------
+server.registerTool("get_my_profile", {
+    title: "Get my profile",
+    description: "Read the api-key owner's IRLEvents profile: display name, bio, wallets across " +
+        "every connected chain, and the cached on-chain assets snapshot. " +
+        "If `assetsUpdatedAt` is stale, call sync_my_assets.",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, openWorldHint: false },
+}, async () => handle(() => client.request("/api/profile")));
+server.registerTool("sync_my_assets", {
+    title: "Sync my on-chain assets",
+    description: "Force-refresh the user's NFT/token holdings across every connected chain. " +
+        "SLOW (5–30s) and resource-heavy — hits Alchemy / Helius / Hiro. " +
+        "Don't poll. Once per session is fine; rely on cached `Profile.assets` otherwise.",
+    inputSchema: {},
+    annotations: { readOnlyHint: false, openWorldHint: false, idempotentHint: true },
+}, async () => handle(() => client.request("/api/profile/assets/sync", { method: "POST" })));
+server.registerTool("check_eligibility", {
+    title: "Check event eligibility",
+    description: "Check whether the api-key owner satisfies any gate group on the given event. " +
+        "Always call this before rsvp_event — the API will reject ineligible users with 403. " +
+        "Returns { eligible, reason, matchedGroupId }.",
+    inputSchema: {
+        eventId: z.string().describe("Public event short id"),
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+}, async ({ eventId }) => handle(() => client.request(`/api/events/${encodeURIComponent(eventId)}/eligibility`)));
+server.registerTool("rsvp_status", {
+    title: "Get my RSVP status for an event",
+    description: "Returns whether the user has RSVPed to this event, plus check-in status and " +
+        "which gate group they qualified through.",
+    inputSchema: {
+        eventId: z.string().describe("Public event short id"),
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+}, async ({ eventId }) => handle(() => client.request(`/api/events/${encodeURIComponent(eventId)}/rsvp/status`)));
+server.registerTool("rsvp_event", {
+    title: "RSVP to an event",
+    description: "Create an RSVP for the api-key owner. Re-checks eligibility, locks the qualifying " +
+        "token in Redis (5-min TTL), and returns a check-in token. Failure modes: " +
+        "NOT_ELIGIBLE (403), TOKEN_LOCKED (409, qualifying NFT used elsewhere), " +
+        "ALREADY_RSVPED (409), EVENT_FULL (410), EVENT_PAST (410). " +
+        "Always call check_eligibility first.",
+    inputSchema: {
+        eventId: z.string().describe("Public event short id"),
+    },
+    annotations: { readOnlyHint: false, openWorldHint: false, destructiveHint: false },
+}, async ({ eventId }) => handle(() => client.request(`/api/events/${encodeURIComponent(eventId)}/rsvp`, {
+    method: "POST",
+    body: JSON.stringify({}),
+})));
+server.registerTool("cancel_rsvp", {
+    title: "Cancel an RSVP",
+    description: "Cancel the api-key owner's RSVP for this event. Frees the locked token so it " +
+        "can be reused for another event in the same window.",
+    inputSchema: {
+        eventId: z.string().describe("Public event short id"),
+    },
+    annotations: { readOnlyHint: false, openWorldHint: false, destructiveHint: true },
+}, async ({ eventId }) => handle(() => client.request(`/api/events/${encodeURIComponent(eventId)}/rsvp`, {
+    method: "DELETE",
+})));
+server.registerTool("my_eligible_events", {
+    title: "My eligible events",
+    description: "List every public event the given wallet currently qualifies for, based on its " +
+        "cached on-chain assets. Pass the user's primary wallet address (lowercased EVM, " +
+        "or chain-native for non-EVM).",
+    inputSchema: {
+        wallet: z.string().describe("Wallet address (EVM lowercased, or Solana/BTC native)"),
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+}, async ({ wallet }) => handle(() => client.request(`/api/users/${encodeURIComponent(wallet)}/events/eligible`)));
+// ----- Boot -------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`irlevents-mcp v0.1.0 ready (base: ${client.base}). Awaiting MCP requests on stdio.`);
+}
+main().catch((e) => {
+    console.error("irlevents-mcp fatal:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "irlevents-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for IRLEvents — token-gated event platform tools for Claude Desktop, Claude Code, Cursor, Cline, and other MCP-compatible clients.",
+  "type": "module",
+  "bin": {
+    "irlevents-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "irlevents",
+    "events",
+    "web3",
+    "nft",
+    "token-gating"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Web3EK/irlevents-mcp.git"
+  },
+  "homepage": "https://github.com/Web3EK/irlevents-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/Web3EK/irlevents-mcp/issues"
+  },
+  "author": "IRLEvents (https://irlevents.io)",
+  "dependencies": {
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}