Integration · MODEL CONTEXT PROTOCOL
abutbul gatherings mcp python
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 split among participants.
WHAT IT CONNECTS
What abutbul gatherings mcp python gives an AI Agent
- 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
- Python 3.8+
- SQLAlchemy
- MCP SDK
- Clone this repository:
- Install the required dependencies:
- Set environment variables (optional):
- Create a gathering for a dinner with 5 friends:
- Add expenses as people pay for things:
- Calculate reimbursements:
- Record payments as people settle up:
- Close the gathering when all payments are settled:
- **MCP Server Interface** (`gatherings_mcp_server.py`): Provides the MCP protocol interface that AI tools can interact with.
- **Service Layer** (`services.py`): Contains business logic for managing gatherings, expenses, and payments.
- **Data Layer** (`models.py`): Defines the database schema using SQLAlchemy ORM and handles data persistence.
- **Gathering**: Represents a social event with expenses to split
- **Member**: A participant in a gathering
- **Expense**: Money spent by a member for the gathering
- **Payment**: Money paid by a member to settle balances
SECURITY
An MCP listing is not a security review
An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.