splitwise-mcp: Instructions file for Claude Code

CLAUDE.md

splitwise-mcp CLAUDE.md is an instructions file for Claude Code from chrischall/splitwise-mcp. It costs 4,162 tokens per session, scanned A, original, MIT.

Project instructions for a Splitwise MCP server, which connects an AI coding assistant to Splitwise's expense-sharing service. They describe its commands, tool names, code structure, tests, and required setup.

In plain words
What is it for?
Use them when changing Splitwise tools, running type checks or tests, building the server, or configuring its API key and output directory.
Why use it?
They help developers build, test, and run the server consistently instead of guessing how its parts fit together.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions .claude-plugin; mentions CLAUDE.md.

This is chrischall/splitwise-mcp's own configuration. It tells Claude Code how to work on splitwise-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything splitwise-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to chrischall/splitwise-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/chrischall/splitwise-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/chrischall/splitwise-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for splitwise-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/chrischall/splitwise-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/chrischall/splitwise-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/chrischall/splitwise-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/chrischall/splitwise-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for splitwise-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/chrischall/splitwise-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/chrischall/splitwise-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,162 This file is loaded in full into every session.
When invoked 4,162 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.04162 $0.04162
Opus 5.5 $0.01665 $0.01665
Sonnet 5.5 $0.00832 $0.00832
Haiku 4.5 $0.00416 $0.00416

Measured 10d ago against content hash f5fddcd01f6e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

splitwise-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 167 lines

How it starts

The opening of the file, as written. The whole thing — 167 lines — stays where its author put it; the contents beside it link to each section on GitHub.

splitwise-mcp

MCP server for Splitwise. Wraps the Splitwise REST API (https://secure.splitwise.com/api/v3.0) and exposes 31 tools to Claude over stdio. Built on @chrischall/mcp-utils (runMcp, createApiClient, readEnvVar, textResult).

Commands

npm run build          # tsc + esbuild bundle → dist/index.js + dist/bundle.js
npm test               # tsc typecheck + vitest run
npm run test:watch     # vitest watch
npm run test:coverage  # tsc typecheck + vitest run --coverage (v8 reporter, no thresholds)

Run locally (requires built dist/):

SPLITWISE_API_KEY=xxx node dist/index.js

Tool naming

All tools are prefixed sw_ (e.g. sw_list_expenses, sw_create_expense).

Architecture

src/
  index.ts        # MCP server entry — calls runMcp() from @chrischall/mcp-utils
                  #   with name/version/banner + the register*Tools array
  client.ts       # SplitwiseClient (createApiClient wrapper) + exported `client`
                  #   singleton; reads SPLITWISE_API_KEY, 1× 2s retry, 30s timeout,
                  #   16 MiB response cap (receipts: 25 MiB per call)
  tools/
    user.ts       # sw_get_current_user, sw_get_user, sw_update_user
    groups.ts     # sw_list_groups, sw_get_group, sw_create_group,
                  #   sw_delete_group, sw_undelete_group,
                  #   sw_add_user_to_group, sw_remove_user_from_group
    friends.ts    # sw_list_friends, sw_create_friend, sw_delete_friend
    expenses.ts   # sw_list_expenses, sw_get_expense, sw_create_expense,
                  #   sw_update_expense, sw_attach_receipt, sw_delete_expense,
                  #   sw_undelete_expense
    _list.ts      # sw_list_expenses' local filters, cursor scan (200/page,
                  #   1000-record budget), rows view, inline comments
    _create.ts    # create pre-flight: category by name (cached), category
                  #   inference, duplicate scan, split:"equal" resolution
    _split.ts     # equalSplit (minor-unit arithmetic) + resolveMember
    _expense-state.ts # deleted-expense pre-check, 403 explanation,
                  #   post_state, undelete verification
    uploads.ts    # sw_get_upload_url — signed PUT on mcp-host's blob store
                  #   (signing: blobStoreFromEnv from @chrischall/mcp-utils/export)
    receipts.ts   # sw_get_receipt — authenticated receipt download,
                  #   inline bytes, and PDF text extraction
    _receipt.ts   # receipt UPLOAD for create/update/attach: loadReceipt (upload_id |
                  #   sandboxed path | base64, magic-byte type check, 10 MiB cap),
                  #   buildReceiptForm, verifyReceiptStored, releaseUpload
                  #   (deletes a used upload_id after a successful write)
    utilities.ts  # sw_get_notifications, sw_get_categories, sw_get_currencies,
                  #   sw_get_comments, sw_create_comment, sw_delete_comment
    _confirm.ts   # confirmWrite(): the gate for the group/friend/user writes
    hints.ts      # _meta.mint context-group hints (group `money`): moneyMeta(),
                  #   withToolMeta() for the mcp-utils-registered writes/batch/confirm
    _brief.ts     # view:"brief" for the canonical reads (sw_list_friends = whats-due,
                  #   sw_get_notifications = whats-new): lines in the untrusted envelope
    batch.ts      # sw_confirm (registerConfirmTool) + sw_batch (registerBatchTool),
                  #   registered LAST — sw_batch lists the writes before it

Read the full file on GitHub · 167 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago Changed · +2 lines · +308 tokens per session f5fddcd01f6e
  2. 11d ago Changed · +4 lines · +82 tokens per session ca46534b4670
  3. 27d ago Changed · +3 tokens per session 1bf99542b88c
  4. 28d ago Changed · +18 lines · +653 tokens per session 7ed187d98c0f
  5. 1mo ago Changed · +4 lines · +170 tokens per session 6421c8d59388
  6. 1mo ago Changed · +3 lines · +147 tokens per session f25d27a87892
  7. 1mo ago Changed · +1 lines · +48 tokens per session 9c43501570fa
  8. 1mo ago Changed · +13 tokens per session 559e6bb82351
  9. 1mo ago Changed · -8 tokens per session 2154e2701cb1
  10. 1mo ago First seen · 135 lines · 2,746 tokens per session scan A 4b09b50c2b98

Subscribe to this mod's changes

splitwise-mcp CLAUDE.md is an instructions file published in the GitHub repository chrischall/splitwise-mcp (2 stars, last pushed 2d ago), licensed MIT. It adds 4,162 tokens to every session, about $0.0166 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

splitwise-mcp CLAUDE.md compared with instructions from other repositories

splitwise-mcp CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
splitwise-mcp CLAUDE.mdchrischall/splitwise-mcpInstructions file22d agoMITA4,162Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file144ktodayMITA8,130Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA5,685GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file150ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA3,153GitHub Copilot
generative-ai-for-beginners AGENTS.mdmicrosoft/generative-ai-for-beginnersInstructions file124ktodayMITA2,981Codex, OpenCode