vantage-peers-mcp 1.0.0 → 2.0.0

package/README.md

@@ -1,23 +1,42 @@
-# VantagePeers MCP Server
+# vantage-peers-mcp
 
-MCP server that exposes VantagePeers Convex functions as Claude Code tools via stdio transport.
+MCP server for [VantagePeers](https://vantagepeers.com) — shared memory, messaging, and task coordination for AI agent teams.
 
-## Prerequisites
+82 tools across 18 categories: memory, profiles, tasks, missions, mission templates, messages, diary, briefing notes, search (RAG), issues, fix patterns, error monitoring, deployments, business units, components, mandates, recurring tasks, and session.
 
-- [Bun](https://bun.sh) installed
-- Convex deployment running (`CONVEX_URL` set)
-- OpenAI API key set as Convex env var (`AI_GATEWAY_API_KEY`)
+## Quick start
 
-## Setup
+```bash
+npx vantage-peers-mcp
+```
+
+Requires `CONVEX_URL` pointing to your VantagePeers Convex deployment.
+
+## Install
+
+### Option 1: npx (no install)
 
-Add to `~/.claude/settings.json` (user-scoped) or `.claude/settings.json` (project-scoped):
+```bash
+CONVEX_URL=https://your-deployment.convex.cloud npx vantage-peers-mcp
+```
+
+### Option 2: global install
+
+```bash
+npm install -g vantage-peers-mcp
+CONVEX_URL=https://your-deployment.convex.cloud vantage-peers-mcp
+```
+
+### Option 3: Claude Code MCP config
+
+Add to `~/.claude.json` or project `.claude/settings.json`:
 
 ```json
 {
   "mcpServers": {
-    "vantage-memory": {
-      "command": "bun",
-      "args": ["/path/to/vantage-memory/mcp-server/server.ts"],
+    "vantage-peers": {
+      "command": "npx",
+      "args": ["-y", "vantage-peers-mcp"],
       "env": {
         "CONVEX_URL": "https://your-deployment.convex.cloud"
       }
@@ -26,16 +45,80 @@ Add to `~/.claude/settings.json` (user-scoped) or `.claude/settings.json` (proje
 }
 ```
 
-Or omit `CONVEX_URL` and let the server read it from `.env.local` in the project root.
+## Environment variables
 
-## Verify
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CONVEX_URL` | Yes | Your VantagePeers Convex deployment URL |
 
-```bash
-bun run mcp-server/server.ts
-```
+The server also reads `CONVEX_URL` from `.env.local` in the parent directory if not set via environment.
+
+## Tools (82)
+
+### Memory (6)
+`store_memory`, `recall`, `list_memories`, `soft_delete_memory`, `get_memory`, `store_episode`
+
+### Profiles (3)
+`get_profile`, `update_profile`, `list_peers`
+
+### Tasks (10)
+`create_task`, `list_tasks`, `list_tasks_by_mission`, `update_task`, `start_task`, `complete_task`, `checkout_task`, `delete_task`, `block_task`, `add_task_dependency`
+
+### Missions (6)
+`create_mission`, `list_missions`, `update_mission`, `update_mission_status`, `get_mission_template`, `get_mission`
+
+### Mission Templates (1)
+`update_mission_template`
+
+### Messages (6)
+`send_message`, `check_messages`, `mark_as_read`, `list_messages`, `delete_message`, `list_broadcast_status`
+
+### Diary (3)
+`write_diary`, `get_diary`, `list_diaries`
+
+### Briefing Notes (2)
+`create_briefing_note`, `list_briefing_notes`
+
+### Search / RAG (3)
+`search_fix_patterns`, `text_search`, `hybrid_search`
+
+### Issues (6)
+`get_issue`, `list_issues`, `update_issue_status`, `verify_issue`, `issue_stats`, `link_commit_to_issue`
+
+### Fix Patterns (5)
+`create_fix_pattern`, `list_fix_patterns`, `add_fix_attempt`, `validate_fix`, `link_issue_to_pattern`
+
+### Error Monitoring (2)
+`list_errors`, `get_error`
+
+### Deployments & Repos (5)
+`add_deployment`, `remove_deployment`, `list_repo_mappings`, `add_repo_mapping`, `remove_repo_mapping`
+
+### Business Units (5)
+`create_bu`, `list_bus`, `get_bu`, `update_bu`, `delete_bu`
+
+### Components (6)
+`register_component`, `list_components`, `get_component`, `update_component`, `delete_component`, `search_components`
+
+### Mandates (6)
+`create_mandate`, `list_mandates`, `accept_mandate`, `update_mandate`, `validate_mandate_spending`, `settle_mandate`
+
+### Recurring Tasks (6)
+`create_recurring_task`, `list_recurring_tasks`, `pause_recurring_task`, `resume_recurring_task`, `delete_recurring_task`, `update_recurring_task`
+
+### Session (1)
+`set_summary`
+
+## Requirements
+
+- Node.js >= 18
+- A VantagePeers Convex deployment ([get started](https://vantagepeers.com/docs))
+
+## License
 
-The server waits for MCP JSON-RPC messages on stdin. No output = healthy.
+FSL-1.1-Apache-2.0
 
-## 27 Tools
+## Links
 
-See the main [README](../README.md) for the complete tool reference.
+- [Documentation](https://vantagepeers.com/docs)
+- [GitHub](https://github.com/vantageos-agency/vantage-peers)

package/dist/server.d.ts

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 /**
  * VantagePeers MCP Server
- * Exposes Convex memory functions as Claude Code tools via stdio transport.
+ * Exposes 82 Convex-backed tools to Claude Code agents via stdio transport.
  *
- * Tools:
- *   store_memory    — create a typed memory entry
- *   recall          — semantic vector search over memories
- *   store_episode   — create an episodic memory with structured fields
- *   get_profile     — fetch an orchestrator profile
- *   update_profile  — upsert an orchestrator profile
- *   list_memories   — list memories by namespace with optional type filter
+ * Tool categories: Memory, Profiles, Messages, Tasks, Missions, Diary,
+ * Briefing Notes, Components, Recurring Tasks, Mandates, Business Units,
+ * Issues, Fix Patterns, Search/RAG, Mission Templates, Error Monitoring,
+ * Deployments, Repo Mappings.
+ *
+ * See README.md for the full tool reference.
  */
 export {};