Splid MCP

What is Splid MCP?

Splid MCP is a Model Context Protocol server that exposes the Splid (splid.app) expense‑sharing application through MCP tools. It uses the reverse‑engineered splid-js client to interact with Splid and is intended for developers who want to automate expense tracking and group management via AI agents or other MCP‑compatible clients.

How to use Splid MCP?

Install Node.js dependencies with npm install, create a .env file with your Splid invite code (CODE) and optional PORT (default 8000), then build and run with npm run build && npm run dev. Connect to http://localhost:8000/mcp using a Streamable HTTP transport (or use npm run inspect for local testing). Tools accept optional groupId, groupCode, or groupName selectors to override the default group.

Key features of Splid MCP

• Health check tool (health) for connectivity.
• Group info tool (whoami) shows members and group details.
• Expense creation tool (createExpense) with payers and profiteers.
• Entry listing tool (listEntries) with configurable limits.
• Group summary tool (getGroupSummary) for balances.

Use cases of Splid MCP

• Automatically create shared expenses in a Splid group from a chat or workflow.
• Query group balances and recent entries for reporting or reconciliation.
• Integrate Splid expense tracking with AI assistants or automation agents.

FAQ from Splid MCP

What transports does Splid MCP support?

Streamable HTTP (default on http://localhost:8000/mcp) and stdio for the local inspector.

What runtime does Splid MCP require?

Node.js with ESM and TypeScript. The project is built with npm run build.

How do I authenticate with Splid MCP?

No authentication headers are needed for the HTTP transport. The server uses the Splid invite code set in the CODE environment variable to access the default group.

What happens if my expense shares don’t sum to 1?

The server returns a 400 error. All profiteer share values must be in (0,1] and sum to exactly 1 (within ±1e‑6).

How can I resolve an “unknown name” error in createExpense?

Use the whoami tool to retrieve the exact member names for the group, then use those names (case‑insensitive) in the expense payload.