@atoms-tech/atoms-mcp 0.47.0 → 0.59.0

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.
package/README.md CHANGED
@@ -9,10 +9,10 @@ MCP server for [ATOMS.tech](https://atoms.tech) — connect AI agents to your re
9
9
 
10
10
  ```bash
11
11
  # 1. Login to your ATOMS account
12
- npx @atoms-tech/atoms-mcp login
12
+ npx @atoms-tech/atoms-mcp@latest login
13
13
 
14
14
  # 2. Add to Claude Code
15
- claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp
15
+ claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp@latest
16
16
  ```
17
17
 
18
18
  That's it. Claude can now read, create, and manage requirements in your ATOMS projects.
@@ -44,7 +44,7 @@ Every action is logged with AI actor attribution (`mcp_claude`) and enforces you
44
44
  | `atoms_search` | Full-text search across items | Read | |
45
45
  | `atoms_browse` | Interactive filterable item viewer | Read | Browse viewer |
46
46
  | `atoms_get_coverage` | Find requirements without test cases | Read | Coverage heatmap |
47
- | `atoms_verification_status` | Release-bound verification state per requirement | Read | |
47
+ | `atoms_verification_status` | Release-bound verification state per requirement, and the tests to rerun (also with no Release) | Read | |
48
48
  | `atoms_get_history` | Audit trail for an item | Read | |
49
49
  | `atoms_export_mermaid` | Generate traceability diagram | Read | |
50
50
  | `atoms_trace` | Walk traceability graph (upstream/downstream) | Read | Force-directed graph |
@@ -79,13 +79,13 @@ ATOMS MCP uses **OAuth 2.1 with PKCE** — the same flow used by GitHub CLI and
79
79
 
80
80
  ```bash
81
81
  # Interactive login (opens browser)
82
- npx @atoms-tech/atoms-mcp login
82
+ npx @atoms-tech/atoms-mcp@latest login
83
83
 
84
84
  # Check current session
85
- npx @atoms-tech/atoms-mcp whoami
85
+ npx @atoms-tech/atoms-mcp@latest whoami
86
86
 
87
87
  # Clear credentials
88
- npx @atoms-tech/atoms-mcp logout
88
+ npx @atoms-tech/atoms-mcp@latest logout
89
89
  ```
90
90
 
91
91
  **How it works:**
@@ -100,10 +100,10 @@ You can also set `ATOMS_ACCESS_TOKEN` as an environment variable for CI/headless
100
100
  ## CLI Commands
101
101
 
102
102
  ```
103
- npx @atoms-tech/atoms-mcp login # Authenticate with ATOMS
104
- npx @atoms-tech/atoms-mcp logout # Clear stored credentials
105
- npx @atoms-tech/atoms-mcp whoami # Show current user
106
- npx @atoms-tech/atoms-mcp --help # Show all commands
103
+ npx @atoms-tech/atoms-mcp@latest login # Authenticate with ATOMS
104
+ npx @atoms-tech/atoms-mcp@latest logout # Clear stored credentials
105
+ npx @atoms-tech/atoms-mcp@latest whoami # Show current user
106
+ npx @atoms-tech/atoms-mcp@latest --help # Show all commands
107
107
  ```
108
108
 
109
109
  Running without a subcommand starts the MCP server on stdio.
@@ -113,7 +113,7 @@ Running without a subcommand starts the MCP server on stdio.
113
113
  ### Claude Code
114
114
 
115
115
  ```bash
116
- claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp
116
+ claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp@latest
117
117
  ```
118
118
 
119
119
  ### Claude Desktop
@@ -125,7 +125,7 @@ Add to your `claude_desktop_config.json`:
125
125
  "mcpServers": {
126
126
  "atoms-mcp": {
127
127
  "command": "npx",
128
- "args": ["@atoms-tech/atoms-mcp"]
128
+ "args": ["@atoms-tech/atoms-mcp@latest"]
129
129
  }
130
130
  }
131
131
  }
@@ -133,7 +133,23 @@ Add to your `claude_desktop_config.json`:
133
133
 
134
134
  ### Cursor / Windsurf
135
135
 
136
- Add to your MCP configuration with `command: "npx"` and `args: ["@atoms-tech/atoms-mcp"]`. Refer to your editor's MCP documentation for the exact config file location.
136
+ Add to your MCP configuration with `command: "npx"` and `args: ["@atoms-tech/atoms-mcp@latest"]`. Refer to your editor's MCP documentation for the exact config file location.
137
+
138
+ ## Updating atoms-mcp
139
+
140
+ A config with no tag keeps running the copy npx cached the first time, so it does not update on its own. In your MCP client config, set the args to `@atoms-tech/atoms-mcp@latest`, then restart the client:
141
+
142
+ ```json
143
+ "args": ["@atoms-tech/atoms-mcp@latest"]
144
+ ```
145
+
146
+ If your config writes `-y` today, keep it:
147
+
148
+ ```json
149
+ "args": ["-y", "@atoms-tech/atoms-mcp@latest"]
150
+ ```
151
+
152
+ atoms-mcp checks for a newer version once a day and tells you in `atoms_status` and in the next tool result. Set `ATOMS_MCP_NO_UPDATE_CHECK=1` to turn the check off.
137
153
 
138
154
  ## Org-Controlled Policy
139
155
 
@@ -163,7 +179,7 @@ Set to `1` (or `true`) to drop every mutating tool. Useful for analyst agents, C
163
179
  "mcpServers": {
164
180
  "atoms-mcp": {
165
181
  "command": "npx",
166
- "args": ["@atoms-tech/atoms-mcp"],
182
+ "args": ["@atoms-tech/atoms-mcp@latest"],
167
183
  "env": { "ATOMS_MCP_READ_ONLY": "1" }
168
184
  }
169
185
  }