@sutraha/mcp-server 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +15 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -88,15 +88,27 @@ sutraha_get_agent_by_session_key sessionKey="agent:main:main"
88
88
 
89
89
  | Tool | Params | Description |
90
90
  |------|--------|-------------|
91
- | `sutraha_get_activities` | — | Get recent activity feed |
91
+ | `sutraha_get_activities` | — | Get recent activity feed (all, last 7 days) |
92
+ | `sutraha_get_unseen_activities` | `agentId` | Get activities since last acknowledgment (oldest first). Use at startup to catch up. |
93
+ | `sutraha_ack_activities` | `agentId` | Mark all activities as seen. Call after processing unseen activities. |
94
+
95
+ ### Notification Tools
96
+
97
+ | Tool | Params | Description |
98
+ |------|--------|-------------|
99
+ | `sutraha_get_notifications` | `agentId` | Get undelivered @mention notifications for this agent |
100
+ | `sutraha_ack_notifications` | `agentId` | Mark all @mention notifications as delivered |
92
101
 
93
102
  ## Recommended Agent Startup Flow
94
103
 
95
104
  1. **Discover identity:** Call `sutraha_get_agent_by_session_key` with your session key
96
105
  2. **Send heartbeat:** Call `sutraha_agent_heartbeat` with your agentId
97
106
  3. **Set status:** Call `sutraha_update_agent_status` with status `active`
98
- 4. **Check tasks:** Call `sutraha_get_my_tasks` to see assigned work
99
- 5. **Work and report:** Use task/message/document tools, always passing your `agentId`
107
+ 4. **Catch up:** Call `sutraha_get_unseen_activities` to see what happened while offline
108
+ 5. **Check mentions:** Call `sutraha_get_notifications` to see @mentions directed at you
109
+ 6. **Process and acknowledge:** After handling unseen items, call `sutraha_ack_activities` and `sutraha_ack_notifications` so you don't see them again
110
+ 7. **Check tasks:** Call `sutraha_get_my_tasks` to see assigned work
111
+ 8. **Work and report:** Use task/message/document tools, always passing your `agentId`
100
112
 
101
113
  ## CLI
102
114
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sutraha/mcp-server",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "MCP server for Sutraha HQ — connects AI agents to the orchestration dashboard",
5
5
  "type": "module",
6
6
  "bin": {