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)
- Event retrieval (
- Stateless, session-based HTTP transport
- Ready for deployment on Fly.io
Getting Started
Prerequisites
- Bun (for running and installing dependencies)
- Node.js (for compatibility with some dependencies)
- Fly.io account (for deployment, optional)
Installation
bun install
Running the Server
bun run index.ts
The server will start on port 3000 by default.
Inspecting the MCP Server
You can inspect the running server using the MCP Inspector:
bunx @modelcontextprotocol/inspector http://localhost:3000/mcp/public
API Endpoints
POST /mcp/public— Main endpoint for MCP client-to-server communicationGET /mcp/public— Server-to-client notifications via SSEDELETE /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 IDevent/list: List events for a group and date rangeevent/search: Search events by keywordgroup/get: Get group detailsprofile/get: Get profile detailsvenue/get: Get venue details
Deployment
This project is ready to deploy on Fly.io:
- Install the Fly CLI
- Authenticate:
fly auth login - Launch:
fly launch - 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