Network School Events MCP Server

A Model Context Protocol (MCP) server that provides access to Network School Luma calendar events through Claude Desktop.

Features

Tools

• get_todays_events: Fetch all events happening today

• get_upcoming_events: Get events in the next N days (default: 7)

• search_events: Search events by name or description

• register_for_event: Register for events directly with your name and email

Wiki Resources

• Access Network School wiki pages with information about:

  • Visas (Malaysia, Singapore, travel from different countries)

  • Internet (WiFi passwords, SIM cards)

  • Getting Started guide

  • And more - easily add new wiki pages as markdown files!

Installation

npm install

Build

npm run build

Development

Watch mode for development:

npm run dev

Testing

Test the API connection and event formatting:

npm test

This will fetch events from the Luma API and display them in the formatted output.

Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "network-school-events": {
      "command": "node",
      "args": ["/Users/akashkumar/Code/ns-mcp/build/index.js"]
    }
  }
}

You can also copy the configuration from claude_config_example.json in this project.

Usage in Claude Desktop

After configuration, restart Claude Desktop. The server will automatically connect when Claude starts.

You can then ask Claude questions like:

Viewing Events:

• "What events are happening today at Network School?"

• "Show me upcoming events in the next 14 days"

• "Show me events in the next 30 days"

• "Search for hackathon events"

• "Find events about AI or machine learning"

• "Are there any coding events coming up?"

Registering for Events:

• "Register me for the Vibecoding event with name John Doe and email john@example.com"

• "Sign me up for event evt-XXX with my name and email"

• After viewing events, you can say: "Register me for that AI Music Lab event"

Accessing Wiki Information:

• "How do I get a visa for Malaysia from India?"

• "What's the WiFi password?"

• "How do I get started at Network School?"

• "What are the visa requirements for Singapore?"

• Claude will automatically access the relevant wiki pages to answer your questions!

Available Tools

1. get_todays_events: Returns all events happening today

2. get_upcoming_events: Returns events in the next N days (default: 7)

   • Parameter: days (optional, number)

3. search_events: Searches events by name or description

   • Parameter: query (required, string)

4. register_for_event: Register for an event

   • Parameters:

     • event_id (required, string): Event API ID from the event listing

     • name (required, string): Your full name

     • email (required, string): Your email address

     • phone_number (optional, string): Your phone number

     • timezone (optional, string): Your timezone (default: Asia/Kuala_Lumpur)

API

This server fetches data from the public Network School Luma calendar API. No authentication is required.

Adding Wiki Content

To add or update wiki pages:

1. Create a new .md file in the wiki/ directory:

   echo "# My New Page" > wiki/my-new-page.md

2. Add your content in Markdown format

3. Rebuild the server:

   npm run build

4. Restart Claude Desktop

The new wiki page will automatically be available as a resource that Claude can access!

Tips:

• Use descriptive filenames (e.g., transportation.md, food-guide.md)

• Include headers with # for better organization

• Link to other resources or external URLs

• Keep information up-to-date

Tech Stack

• TypeScript

• Node.js

• @modelcontextprotocol/sdk

• axios for HTTP requests

• date-fns for date formatting

License

MIT