archeious/quartermaster
1
0
Fork 0
Code Issues 4 Pull requests 1 Projects Releases Packages Wiki Activity Actions

Add MCP proposal document #24

Merged
archeious merged 1 commit from feat/23-mcp-proposal-doc into main 2026-04-19 11:27:01 -06:00
Conversation 0 Commits 1 Files changed 1 +317
archeious commented 2026-04-17 21:05:05 -06:00
Owner
Copy link

Doc-only change. Drops docs/MCPProposal.md proposing a thin MCP server adapter over the existing service layer so AI agents can read budget state, log transactions, and drive month-lifecycle transitions.

Refs #23

Summary

  • In-process Python module, stdio transport, QUARTERMASTER_MCP_MODE=read|write gate.
  • Tool surface aligned with current schema (sections, notes, month lifecycle, postings, debt target).
  • Three-phase rollout: read-only -> transaction writes -> entry and lifecycle writes.

Test plan

  • Read MCPProposal.md; flag anything that misrepresents the current schema or routes.
  • Decide whether to start Phase A implementation or keep queued.

🤖 Generated with Claude Code

Doc-only change. Drops `docs/MCPProposal.md` proposing a thin MCP server adapter over the existing service layer so AI agents can read budget state, log transactions, and drive month-lifecycle transitions. Refs #23 ## Summary - In-process Python module, stdio transport, `QUARTERMASTER_MCP_MODE=read|write` gate. - Tool surface aligned with current schema (sections, notes, month lifecycle, postings, debt target). - Three-phase rollout: read-only -> transaction writes -> entry and lifecycle writes. ## Test plan - [ ] Read MCPProposal.md; flag anything that misrepresents the current schema or routes. - [ ] Decide whether to start Phase A implementation or keep queued. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
archeious added 1 commit 2026-04-17 21:05:05 -06:00 
Design proposal for a thin MCP server adapter over the existing
service layer so Claude Code and other MCP clients can consume
Quartermaster state and execute mutations without opening the
browser.

Document only. Covers:

- Goal and non-goals (no staging queue, no auth, no bank-feed
  ingestion).
- Architecture: in-process Python module (quartermaster-mcp
  script) sharing QUARTERMASTER_DB_URL with the web app; stdio
  transport; QUARTERMASTER_MCP_MODE env var gates read/write.
- Tool surface aligned with the current model: get_budget,
  list_months, get_month, get_month_entry, list_postings,
  get_zero_amount (read); add/update/remove entry, create /
  activate / close / reopen month, add / update / delete
  transaction, set debt target (write).
- Resources: quartermaster://budget, quartermaster://month/YYYY-MM.
- Prompts: monthly_review, quick_log, close_prep.
- Typed errors with stable codes.
- Three-phase rollout: read-only -> transaction writes -> entry
  and lifecycle writes.
- Four open questions parked at the bottom.

Refs #23

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
archeious merged commit 3b4b34a84c into main 2026-04-19 11:27:01 -06:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: archeious/quartermaster#24
No description provided.
Delete branch "feat/23-mcp-proposal-doc"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?