# 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:
```bash
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:
```bash
npm run build
```

4. Run locally with Firebase emulator:
```bash
npm run serve
```

## Firebase Deployment

### Prerequisites

1. Install Firebase CLI (if not already installed):
```bash
npm install -g firebase-tools
```

2. Login to Firebase:
```bash
firebase login
```

### Initial Setup

1. Create a new Firebase project (or use existing):
```bash
firebase projects:create spond-mcp-server
```

2. Initialize Firebase in the project:
```bash
firebase use spond-mcp-server
```

### Set Environment Variables (Secrets)

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

firebase functions:secrets:set SPOND_PASSWORD
# Enter: your_password
```

### Deploy

```bash
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`):

```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.