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
- Install dependencies:
npm install- Create a
.envfile with your Spond credentials:
SPOND_USERNAME=your_email@example.com
SPOND_PASSWORD=your_password- Build the project:
npm run build- Run locally with Firebase emulator:
npm run serveFirebase Deployment
Prerequisites
- Install Firebase CLI (if not already installed):
npm install -g firebase-tools- Login to Firebase:
firebase loginInitial Setup
- Create a new Firebase project (or use existing):
firebase projects:create spond-mcp-server- Initialize Firebase in the project:
firebase use spond-mcp-serverSet Environment Variables (Secrets)
firebase functions:secrets:set SPOND_USERNAME
# Enter: your_email@example.com
firebase functions:secrets:set SPOND_PASSWORD
# Enter: your_passwordDeploy
npm run deployYour 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.
