Advertise
MCP.so
Sign In

Gatherings MCP Server

@abutbul

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

abutbul

About Gatherings MCP Server

The Gatherings MCP Server provides an API that allows AI assistants to interact with the Gatherings application through the Machine Conversation Protocol. This enables AI systems to help users manage shared expenses for social events, outings, or any gathering where costs are spl

#gatherings#mcp#expense-sharing#api

Gatherings MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gatherings-mcp-python": {
      "command": "python",
      "args": [
        "gatherings_mcp_server.py"
      ]
    }
  }
}

Gatherings MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gatherings MCP Server?

A Model Context Protocol server that provides an API for AI assistants to interact with the Gatherings application, enabling management of shared expenses for social events where costs are split among participants. It uses SQLAlchemy for data persistence and the MCP Python SDK.

How to use Gatherings MCP Server?

Install dependencies with uv pip install -r requirements.txt or pip install -r requirements.txt, optionally set environment variables GATHERINGS_DB_PATH and GATHERINGS_SCRIPT, then run python gatherings_mcp_server.py. The server communicates over stdio with any MCP client. Tools are invoked by name with parameters (e.g., create_gathering, add_expense, calculate_reimbursements).

Key features of Gatherings MCP Server

  • Create and manage gatherings with multiple members
  • Add expenses for specific members
  • Calculate fair reimbursements
  • Record payments and reimbursements
  • Generate detailed payment summaries
  • Add, remove, and rename members

Use cases of Gatherings MCP Server

  • Splitting dinner costs among a group of friends
  • Managing shared expenses for a group outing
  • Tracking who paid and who owes for a social event

Frequently asked questions

1

What dependencies does Gatherings MCP Server require?

Python 3.8+, SQLAlchemy, MCP SDK, and the `uv` package manager (optional but recommended). Dependencies are listed in `requirements.txt`.

2

How does the server persist data?

It uses SQLAlchemy ORM with a database file whose path can be customized via the `GATHERINGS_DB_PATH` environment variable.

3

What transport does the server use?

The server communicates over stdio, making it compatible with MCP protocol clients that expect a subprocess.

4

What tools are available and how do I call them?

Tools include `create_gathering`, `add_expense`, `calculate_reimbursements`, `record_payment`, `rename_member`, `show_gathering`, `list_gatherings`, `close_gathering`, `delete_gathering`, `add_member`, and `remove_member`. Each tool expects specific parameters as documented in the API reference.

5

Are there any known limits or restrictions?

A member can only be removed if they have no expenses. The `delete_gathering` command requires `force=True` for closed gatherings.

Comments

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

ICSS

chokcoco

不止于 CSS

20.7K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Advertise