sola-mcp

sociallayer-im/sola-mcp

3.2

If you are the rightful owner of sola-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Sola MCP Server is a stateless, streamable HTTP server designed for the Social Layer platform, implementing the Model Context Protocol (MCP) to facilitate interactions with events, groups, profiles, and venues.

Tools

  1. event/get

    Get event details by ID

  2. event/list

    List events for a group and date range

  3. event/search

    Search events by keyword

  4. group/get

    Get group details

  5. profile/get

    Get profile details

  6. venue/get

    Get venue details

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