SplitFast - Group Expense MCP

Installation

• pip install -r requirements.txt
• Or run the container build defined by the repo's Dockerfile, which installs the same requirements and starts python server.py.

Configuration

• Starts an HTTP MCP server on 0.0.0.0:8080.
• Uses a local SQLite database file named splitfast.db.
• No runtime environment variables are documented for server behavior.
• The remote registry target is streamable-http:https://server.smithery.ai/@mrugankpednekar/bill_splitter_mcp/mcp.

Capabilities

• create_group: create a group and receive a generated secret.
• record_debt: record a direct debtor-to-creditor debt.
• add_split: record an equal split expense.
• history: list recent expense entries for a group.
• balances: compute minimal settlement transfers.
• quick_settle: parse simple free-form debt text and compute a settlement without writing to the database.

Limitations

• Group operations require the generated secret returned by create_group.
• State is stored locally in SQLite, so the server is not stateless.
• quick_settle only handles simple X owes Y amount style sentences with alphabetic names.
• The remote Smithery endpoint requires bearer-token authentication.