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

get_todays_events: Returns all events happening today
get_upcoming_events: Returns events in the next N days (default: 7)
- Parameter: days (optional, number)
search_events: Searches events by name or description
- Parameter: query (required, string)
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:

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

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

Add your content in Markdown format
Rebuild the server:
```
npm run build
```
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