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

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