@atoms-tech/atoms-mcp 0.2.1 → 0.3.1

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2024-2026 Atoms.tech. All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying, distribution,
+modification, or use of this software, via any medium, is strictly prohibited.
+
+This software is provided to end users solely for use with the Atoms.tech platform
+under the terms of the Atoms.tech Terms of Service.
+
+For licensing inquiries, contact: support@atoms.tech

package/README.md

@@ -3,7 +3,7 @@
 MCP server for [ATOMS.tech](https://atoms.tech) — connect AI agents to your requirements management workspace.
 
 [![npm version](https://img.shields.io/npm/v/@atoms-tech/atoms-mcp)](https://www.npmjs.com/package/@atoms-tech/atoms-mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://atoms.tech)
 
 ## Quick Start
 
@@ -32,23 +32,35 @@ Every action is logged with AI actor attribution (`mcp_claude`) and enforces you
 
 ## Available Tools
 
-| Tool | Description | Access |
-|------|-------------|--------|
-| `atoms_list_projects` | List all accessible projects | Read |
-| `atoms_list_items` | Browse items with type/domain/level filters | Read |
-| `atoms_get_item` | Get full item details with relationships | Read |
-| `atoms_search` | Full-text search across items | Read |
-| `atoms_get_coverage` | Find requirements without test cases | Read |
-| `atoms_get_history` | Audit trail for an item | Read |
-| `atoms_export_mermaid` | Generate traceability diagram | Read |
-| `atoms_create_item` | Create a requirement, test case, or note | Write |
-| `atoms_update_item` | Update item fields | Write |
-| `atoms_delete_item` | Soft-delete an item | Write |
-| `atoms_link_items` | Add/remove relationships between items | Write |
-| `atoms_bulk_import` | Bulk create up to 100 items at once | Write |
-| `atoms_record_test_result` | Record pass/fail for a test case | Write |
-| `atoms_trace` | Walk traceability graph (upstream/downstream) | Read |
-| `atoms_project_summary` | Project compliance dashboard (counts, coverage, status) | Read |
+| Tool | Description | Access | MCP App UI |
+|------|-------------|--------|------------|
+| `atoms_list_projects` | List all accessible projects | Read | |
+| `atoms_list_items` | Browse items with type/domain/level filters | Read | |
+| `atoms_get_item` | Get full item details with relationships | Read | |
+| `atoms_search` | Full-text search across items | Read | |
+| `atoms_get_coverage` | Find requirements without test cases | Read | Coverage heatmap |
+| `atoms_get_history` | Audit trail for an item | Read | |
+| `atoms_export_mermaid` | Generate traceability diagram | Read | Interactive diagram |
+| `atoms_create_item` | Create a requirement, test case, or note | Write | |
+| `atoms_update_item` | Update item fields | Write | |
+| `atoms_delete_item` | Soft-delete an item | Write | |
+| `atoms_link_items` | Add/remove relationships between items | Write | |
+| `atoms_bulk_import` | Bulk create up to 100 items at once | Write | Results table |
+| `atoms_record_test_result` | Record pass/fail for a test case | Write | |
+| `atoms_trace` | Walk traceability graph (upstream/downstream) | Read | Force-directed graph |
+| `atoms_project_summary` | Project compliance dashboard | Read | Charts + gauges |
+
+## Interactive UIs (MCP Apps)
+
+5 tools include interactive UIs powered by [MCP Apps](https://modelcontextprotocol.io/extensions/apps). In supported hosts (Claude, ChatGPT), these tools render rich visualizations inline in the conversation:
+
+- **Project Summary** — compliance dashboard with coverage gauge, test status bar, and domain charts
+- **Trace Graph** — interactive force-directed graph showing requirement/test traceability
+- **Mermaid Diagram** — pan/zoom diagram of the requirement hierarchy
+- **Coverage Heatmap** — visual coverage report with uncovered requirements list
+- **Bulk Import Results** — color-coded table showing created items and errors
+
+In non-UI clients (Claude Code CLI, Cursor), these tools return standard JSON text — no functionality is lost.
 
 ## Authentication
 
@@ -69,7 +81,7 @@ npx @atoms-tech/atoms-mcp logout
 
 1. `login` opens your browser to the ATOMS consent page
 2. You approve the MCP connection with your ATOMS account
-3. Tokens are stored locally at `~/.atoms-mcp/credentials.json`
+3. Tokens are stored locally at `~/.atoms/credentials.json`
 4. Tokens auto-refresh — you only need to login once
 
 You can also set `ATOMS_ACCESS_TOKEN` as an environment variable for CI/headless use.