Getting Started
First MCP Test
Run your first ATOMS MCP tool call
First MCP Test
Once installed and authenticated, try these tools to verify everything works.
Check connection
Ask your AI assistant:
"Check my ATOMS connection status"
The assistant will call atoms_status and return your authentication status and email.
{
"status": "success",
"data": {
"status": "authenticated",
"email": "you@example.com",
"message": "Connected to ATOMS"
}
}List your projects
"Show me my ATOMS projects"
This calls atoms_list_projects : the entry point for all other tools.
{
"status": "success",
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Medical Device Requirements",
"description": "ISO 14971 compliant requirements",
"org_name": "Acme Corp"
}
]
}Search for items
"Search for requirements about braking system in my project"
This calls atoms_search with your query.
{
"status": "success",
"data": [
{
"id": "REQ-001",
"type": "requirement",
"title": "Emergency braking shall activate within 100ms",
"summary": "Critical safety requirement for braking response time"
}
],
"meta": { "total_count": 3, "has_more": false }
}Check test coverage
"Show me test coverage for this project"
This calls atoms_get_coverage and renders an interactive heatmap in Claude.
{
"status": "success",
"data": {
"covered": 42,
"uncovered": 8,
"total": 50,
"coverage_percent": 84,
"uncovered_items": [
{ "id": "REQ-023", "title": "System shall log all access attempts" }
]
}
}All 16 tools are documented in the Tool Reference. Each tool page includes parameters, examples, and response format.
What to try next
- Trace dependencies: "Show me what REQ-001 depends on"
- Create items: "Create a new requirement for user authentication"
- Export diagrams: "Generate a Mermaid diagram of the requirement hierarchy"
- Bulk import: "Import these 10 requirements into the project"