Spond MCP Server

An MCP (Model Context Protocol) server for fetching London Desperados CC events from Spond. Built with TypeScript and deployable to Firebase Cloud Functions.

Features

• get_desperados_events: Fetch all upcoming events for London Desperados CC for the next year

Project Structure

spond-mcp-server/
├── src/
│   ├── index.ts      # Main MCP server with Firebase function export
│   └── spond.ts      # Spond API client
├── lib/              # Compiled JavaScript (generated)
├── firebase.json     # Firebase configuration
├── package.json
├── tsconfig.json
└── .env              # Environment variables (local only)

Local Development

1. Install dependencies:

npm install

2. Create a .env file with your Spond credentials:

SPOND_USERNAME=your_email@example.com
SPOND_PASSWORD=your_password

3. Build the project:

npm run build

4. Run locally with Firebase emulator:

npm run serve

Firebase Deployment

Prerequisites

1. Install Firebase CLI (if not already installed):

npm install -g firebase-tools

2. Login to Firebase:

firebase login

Initial Setup

1. Create a new Firebase project (or use existing):

firebase projects:create spond-mcp-server

2. Initialize Firebase in the project:

firebase use spond-mcp-server

Set Environment Variables (Secrets)

firebase functions:secrets:set SPOND_USERNAME
# Enter: your_email@example.com

firebase functions:secrets:set SPOND_PASSWORD
# Enter: your_password

Deploy

npm run deploy

Your MCP server will be available at:

https://<region>-<project-id>.cloudfunctions.net/mcp

Endpoints

• /mcp/mcp - Streamable HTTP MCP endpoint (POST for requests)
• /mcp/health - Health check endpoint

MCP Client Configuration

Claude Desktop (Remote - Streamable HTTP)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "spond-events": {
      "url": "https://us-central1-spond-mcp-server.cloudfunctions.net/mcp/mcp"
    }
  }
}

Available Tools

get_desperados_events

Fetches all upcoming events for London Desperados CC from Spond.

No parameters required - automatically fetches events for the next year.