Gatherings MCP Server logo

Gatherings MCP Server

by abutbul

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.

View on GitHub

Last updated: N/A

What is Gatherings MCP Server?

The Gatherings MCP Server is a Machine Conversation Protocol (MCP) server interface for the Gatherings expense-sharing application. It provides an API for AI assistants to manage shared expenses.

How to use Gatherings MCP Server?

To use the server, first install the prerequisites (Python 3.8+, SQLAlchemy, MCP SDK) and dependencies using pip install -r requirements.txt. Then, start the server using python gatherings_mcp_server.py. The server runs on stdio and is compatible with MCP protocol clients. Use the exposed API tools to create gatherings, add expenses, calculate reimbursements, and manage payments.

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 members from gatherings

  • Rename members as needed

Use cases of Gatherings MCP Server

  • Managing shared expenses for social events

  • Splitting costs among participants in outings

  • Tracking expenses for group travel

  • Automating expense management with AI assistants

FAQ from Gatherings MCP Server

How do I create a gathering?

Use the create_gathering(gathering_id: str, members: int) tool.

How do I add an expense for a member?

Use the add_expense(gathering_id: str, member_name: str, amount: float) tool.

How do I calculate reimbursements?

Use the calculate_reimbursements(gathering_id: str) tool.

How do I record a payment?

Use the record_payment(gathering_id: str, member_name: str, amount: float) tool.

How do I rename a member?

Use the rename_member(gathering_id: str, old_name: str, new_name: str) tool.