# ONES MCP

> ONES manages complex R&D projects and workflows directly through your AI agent. It lets you list projects, create tasks, update statuses, and retrieve organization-wide reports without ever opening the ONES dashboard. Use it to track development progress, manage requirements, or audit team processes via natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** rd-management, issue-tracking, workflow-automation, agile, team-collaboration, task-management

## Description

**ONES** lets your AI agent handle massive R&D projects without you ever touching the actual ONES dashboard. You don’t need to click through menus or wait for load times; your agent just talks to the system, pulling exactly what you need, instantly. It's like having an expert pair of hands on every single part of the development lifecycle—from initial planning to final audit. Here’s how you use it.

**Project Oversight and Discovery:**
You can start by getting a complete picture of everything running at once. Use `list_projects` and your agent pulls a full list of every active R&D project on the platform, so you know exactly what teams are working on. If you need more than just names, run `get_project`. This tool fetches all the deep-dive details for one specific project ID, giving you scope definitions and an accurate roster of everyone involved. You can also get a general overview of organizational health with `get_org_info`, which pulls summary metrics about high-level activity across the entire company.

**Task Management Deep Dive:**
Managing tasks is where this thing really shines. You don't just check if something's done; you know *why* it's done and who owns it. First, run `list_task_types` to see all the standardized categories—like 'Bug' or 'Story'—so your agent knows what kind of work is expected. Then, use `list_workflows` to display every available development process model for a project; you can audit whether they’re sticking to Kanban or Scrum rules. To get a running list of work items, run `list_tasks`, which fetches all tasks tied to a specific project ID in paginated chunks. Need the specifics on one ticket? `get_task_details` gives you every single data point for that task ID: its current status, detailed notes, and who’s assigned it. You can also kick off work by having your agent create a new record using `create_task`, sending an instruction with the title, description, and assignee right away. If a requirement changes mid-project, you don't worry; just use `update_task` to modify an existing task’s status, assign ownership, or change its description after verifying the correct ID.

**People and Process Directory:**
Knowing who's on what is half the battle. Run `list_members` and your agent provides a comprehensive directory listing of every single person in the ONES workspace. This lets you manage assignments instantly without opening an HR portal. You can also get full project details using `get_project`, which includes member information, keeping everyone accountable to the right scope. By combining these tools, you're not just checking boxes; your agent helps you track development progress and audit team processes in natural conversation.

You’ll use this server when you need concrete data points—like confirming a task status or listing all active projects—instead of wading through UI clutter. It’s pure, focused interaction with the core system data.

## Tools

### create_task
Creates a new task record within an ONES project, accepting title, description, and assignee details.

### get_org_info
Pulls a summary report detailing high-level activity across the entire organization.

### get_project
Retrieves full details for one specific ONES project, including scope and members.

### get_task_details
Gets all available data points—status, notes, assignees—for a single task ID.

### list_members
Returns an exhaustive list of every user and team member in the ONES organization.

### list_projects
Gives a complete, current listing of all active R&D projects available on the platform.

### list_task_types
Outputs the standardized list of task classifications used in ONES (e.g., Bug, Story).

### list_tasks
Fetches a paginated list of tasks belonging to a specific project ID.

### list_workflows
Displays the available development workflows and process models for an ONES project.

### update_task
Modifies an existing task's status, assignment, or description after validation of its ID.

## Prompt Examples

**Prompt:** 
```
List all my active R&D projects on ONES.
```

**Response:** 
```
I've retrieved your active ONES projects. You have 4 active projects, including 'Core Platform V2' and 'Security Hardening'. Which one would you like to review?
```

**Prompt:** 
```
Create a new task in project 'Mobile SDK' titled 'Implement OAuth2 login'.
```

**Response:** 
```
Done! I've created the task 'Implement OAuth2 login' in the 'Mobile SDK' project. Would you like to assign it to someone or add a more detailed description?
```

**Prompt:** 
```
Show me the recent activity summary for our organization.
```

**Response:** 
```
I've retrieved the organization summary. In the last 7 days, 150 tasks were created and 120 were completed across 8 projects. Your team velocity remains stable. Would you like a breakdown by project?
```

## Capabilities

### Create a new task
Sends an instruction to create a task within the platform, accepting titles, descriptions, and assignees.

### Get organization summary
Retrieves high-level metrics about the entire ONES organization's activity.

### Fetch project details
Gets specific information for a single R&D project, including its status and members.

### Get task specifics
Retrieves all granular data about one existing task ID.

### List organization members
Provides a directory listing of every person in the ONES workspace.

### Find and list projects
Retrieves a full, current list of all active R&D projects available to your agent.

### List task types
Shows the predefined categories for tasks (e.g., bug, story) used across the platform.

## Use Cases

### The Project Status Check
A PM needs to know if 'Core Platform V2' is ready. Instead of clicking into the project, then filtering by status, they ask their agent: 'What are the tasks in Core Platform V2 that are blocked?' The agent runs `get_project` then iterates through relevant tools to give a single, actionable report.

### Task Creation on the Fly
An engineer finds a bug during code review. They don't open ONES; they just tell their agent: 'Create a new task in Mobile SDK titled 'Fix Auth Bug'. Assign it to me.' The agent calls `create_task` and handles the necessary fields.

### Auditing Development Process
A manager wants to know if the team is following best practices. They ask: 'What are the allowed workflows for this project?' The agent calls `list_workflows`, instantly giving them visibility into the development process without manual document reading.

### Gathering Team Data
A Product Owner needs to know who owns which requirement. They ask: 'List all members and tell me who is assigned to security hardening.' The agent uses `list_members` combined with project data to provide a filtered list.

## Benefits

- **Instant Project View:** Stop clicking through dashboards. Use `list_projects` to get a clear, immediate list of every active project without navigating the ONES UI.
- **Task Command Center:** Need to update something? The `update_task` tool lets your agent modify status or assignees directly from chat, skipping three clicks and two screens.
- **Team Directory:** Forget searching through roles. Run `list_members` once, and your agent provides a clean list of who's on the team for assignment management.
- **Audit Workflows:** Understand *how* development happens. Use `list_workflows` to review project processes and `list_task_types` to see what kinds of tasks are allowed.
- **Organization Overview:** Get immediate organizational health checks with `get_org_info`. Instead of running a report, you ask for the summary and get it instantly.

## How It Works

The bottom line is, you talk to your AI agent, and it talks to ONES using structured API calls for you.

1. Subscribe to this server and provide your ONES API Access Token and Organization ID.
2. Connect your preferred client (Claude, Cursor, etc.) to the MCP Server endpoint.
3. Ask your agent a natural language question like, 'List all my active R&D projects.' The agent then invokes the appropriate tool.

## Frequently Asked Questions

**How do I list all my active R&D projects using the list_projects tool?**
Run `list_projects` first. This action returns a clean list of every available ONES project ID and name, so you know exactly which one to target next.

**Can I update task status using the update_task tool?**
Yes. You must provide the specific Task ID and the desired new status (e.g., 'In Review'). The agent then executes `update_task` directly against the ONES platform.

**Does get_org_info show project-level details?**
No, `get_org_info` provides a high-level summary across all projects. If you need specific metrics for one team, run `list_projects` and then use the `get_project` tool.

**What if I don't know which task type to use?**
Run `list_task_types`. This tool shows you all the standardized classifications (like Bug, Story, Task) used within ONES so you can accurately create or reference tasks.

**When using `list_members`, what level of access is required for my agent?**
The server needs read-only permissions for the organization directory. Your agent must use API credentials that specifically allow reading user data to run this tool successfully.

**If I try to use `create_task` with a missing required field, how does the AI client handle the error?**
The agent catches the specific API validation error and reports it back directly. It will tell you exactly which parameter failed (e.g., 'Assignee ID is mandatory').

**When running `list_tasks`, does the tool handle large result sets, or do I need to loop through pages?**
The MCP server manages pagination automatically. If a project has more tasks than one page limit, your agent will request subsequent data until every task is retrieved.

**What kind of data does `list_workflows` return? Is it just names or the full step definitions?**
It returns the structured name and sequence of steps defined for that project. This lets your agent understand the entire development process without needing to read individual task descriptions first.

**How do I generate an API Access Token in ONES?**
Log in to your ONES Management Console, navigate to [Settings] → [API Authentication], and click 'Create Token'. Make sure to copy it immediately as it will only be shown once.

**Where can I find my Organization ID?**
Your Organization ID (often a UUID) can be found in the URL of your ONES dashboard or in the [Organization Profile] section of the Management Console.

**Can I update the status of a task through the agent?**
Yes. Use the `update_task` tool and provide the task UUID and the new status UUID. You can find available status UUIDs by checking the project's workflow with `list_workflows`.