irlevents-mcp 0.4.0 → 0.4.1

package/README.md

@@ -1,12 +1,23 @@
 # irlevents-mcp
 
+[![npm version](https://img.shields.io/npm/v/irlevents-mcp.svg)](https://www.npmjs.com/package/irlevents-mcp)
+[![license](https://img.shields.io/npm/l/irlevents-mcp.svg)](https://github.com/Web3EK/irlevents-mcp/blob/main/LICENSE)
+
 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.
+host events, and more — all on your behalf, using a long-lived `api_*` key you control.
+
+## Why use this?
+
+- **Skip the API integration entirely.** Six-line config block. No HTTP client, no auth flow, no SDK to learn.
+- **24 tools across attendee + host + rewards surfaces.** Discover events, check token-gate eligibility, RSVP, create events, check attendees in, claim rewards — all from natural-language prompts.
+- **Multi-chain by default.** Works against 16+ chains (Ethereum, Base, Polygon, Solana, Bitcoin Ordinals, Cardano, XRP, Sui, TON, Aptos, Tezos, Flow, Cosmos, POAP, Snapshot DAO). Your agent doesn't need to know the difference.
+- **Scoped API keys, audit logs.** Same security posture as Stripe / GitHub / Linear. You stay in control of what the agent can do.
+- **Built for agents from the ground up.** OpenAPI 3.0 spec, OAuth 2.0 for multi-tenant apps, llms-full.txt for one-shot LLM ingest, webhook delivery for push integrations. Not a retrofitted REST API.
 
 ## Tools exposed
 
@@ -180,12 +191,20 @@ printf '%s\n%s\n%s\n' \
   API returns `X-RateLimit-Remaining` headers; this MCP server surfaces 429
   errors back to the model so it can back off.
 
+## Building your own agent
+
+If you want to build an agent that uses IRLEvents directly (no MCP), check
+out [`examples/openapi-client/`](./examples/openapi-client) — a self-contained
+TypeScript script that uses the OpenAPI to discover events, check eligibility,
+and RSVP. ~80 lines, runnable in 30 seconds.
+
 ## 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
+- [DISTRIBUTION.md](./DISTRIBUTION.md) — registry submission checklist (for maintainers)
 
 ## Releasing (maintainers)
 
@@ -205,7 +224,7 @@ 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)
+3. Smoke-test the MCP handshake (asserts all tools register)
 4. Publish to npm with provenance attestation
 
 Required GitHub repo secret: **`NPM_TOKEN`** — an npm "Automation" or

package/dist/index.js

@@ -31,7 +31,7 @@ const client = createClient({
     apiKey,
     base: process.env.IRLEVENTS_API_BASE,
 });
-const server = new McpServer({ name: "irlevents-mcp", version: "0.4.0" }, {
+const server = new McpServer({ name: "irlevents-mcp", version: "0.4.1" }, {
     capabilities: { tools: {}, resources: {}, prompts: {} },
     instructions: "Tools, resources, and prompts for the IRLEvents token-gated event platform. " +
         "Use list_events / trending_events / get_event to discover; check_eligibility " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "irlevents-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "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": {