Sola MCP Server

A stateless, streamable HTTP server implementing the Model Context Protocol (MCP) for the Social Layer platform. This server exposes a set of tools for interacting with events, groups, profiles, and venues via HTTP endpoints.

Features

• MCP server for Social Layer integrations

• Exposes tools for:

  • Event retrieval (event/get)

  • Event listing and search (event/list, event/search)

  • Group info (group/get)

  • Profile info (profile/get)

  • Venue info (venue/get)

• Stateless, session-based HTTP transport

• Ready for deployment on Fly.io

Related MCP server: MCP REST API Server

Getting Started

Prerequisites

• Bun (for running and installing dependencies)

• Node.js (for compatibility with some dependencies)

• Fly.io account (for deployment, optional)

Installation

Running the Server

The server will start on port 3000 by default.

Inspecting the MCP Server

You can inspect the running server using the MCP Inspector:

API Endpoints

• POST /mcp/public — Main endpoint for MCP client-to-server communication

• GET /mcp/public — Server-to-client notifications via SSE

• DELETE /mcp/public — Session termination

All endpoints expect and return JSON-RPC 2.0 payloads.

Tooling

The following tools are available via the MCP protocol:

• event/get: Get event details by ID

• event/list: List events for a group and date range

• event/search: Search events by keyword

• group/get: Get group details

• profile/get: Get profile details

• venue/get: Get venue details

Deployment

This project is ready to deploy on Fly.io:

1. Install the Fly CLI

2. Authenticate: fly auth login

3. Launch: fly launch

4. Deploy: fly deploy

The fly.toml is preconfigured for deployment.

Development

• Format code: bun run format

• Check formatting: bun run format:check

License

MIT

Author

jiangplus