# BasicOps MCP MCP

> BasicOps MCP centralizes project management, task tracking, and team communication into natural conversation. Stop toggling between tabs to update status or check history. This connector lets your AI agent act as a dedicated coordinator for all your projects, giving you full control over complex workflows from one place.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, workflow-automation, project-tracking, team-collaboration, document-sharing, project-phases

## Description

Forget jumping between multiple apps just to keep track of what needs doing. This MCP connects your entire BasicOps account directly to your agent, putting project oversight and team coordination right where you work. You can talk to it like a manager talks to an assistant—tell it to list all active projects or ask for the full communication history on a specific task. It handles the whole lifecycle: creating new tasks, updating status dates, and even listing out every team member so everyone's in sync. When you connect this through Vinkius, your AI agent becomes much more than a chatbot; it’s an operational extension of your actual workspace. You get to manage project sections and monitor metadata without ever leaving the chat window.

## Tools

### create_project
Registers a brand new project into your BasicOps account.

### create_task
Adds a completely new, trackable task within an existing project.

### get_account_info
Retrieves basic information about your user profile and account settings.

### get_project
Pulls detailed data for a single, specific project ID.

### get_task
Fetches all the current details associated with one task.

### list_task_messages
Retrieves the full conversation thread for a task, including notes and updates.

### list_projects
Gets an overview and names of all the projects you manage in BasicOps.

### list_project_sections
Lists out all major phases or sections defined within a project's timeline.

### list_project_tasks
Retrieves a list of every task associated with a particular project.

### list_team_users
Provides a directory listing of every team member connected to your workspace.

### list_webhooks
Shows a list and status details for all active automation webhooks.

### update_task
Changes the status, due date, or description of an existing task.

## Prompt Examples

**Prompt:** 
```
List all active projects in my BasicOps workspace.
```

**Response:** 
```
I've retrieved your projects. You currently have 3 active projects, including 'Marketing Launch' (ID: 123) and 'App Development'. Which one should we check for tasks?
```

**Prompt:** 
```
Create a new high-priority task 'Fix Login Bug' in project '123'.
```

**Response:** 
```
Task created! I've successfully registered 'Fix Login Bug' in project 123. It's now visible to your team with high priority. Need help assigning a specific member?
```

**Prompt:** 
```
Show the communication history for task ID '456'.
```

**Response:** 
```
Accessing task intelligence... I've retrieved 5 recent updates for task 456, including a technical note from @user1 and a status confirmation. Would you like the high-fidelity metadata for these messages?
```

## Capabilities

### List all projects
Retrieves a complete list of every project you have set up in BasicOps.

### Create new projects
Registers an entirely new, isolated project within your workspace structure.

### Manage task details
Creates, retrieves, or modifies the status and description of individual work items (tasks).

### Review team directory
Accesses a full roster of users in your organization to understand who works on what.

### Track communication history
Pulls the complete message log associated with any specific task for context.

### View webhooks status
Lists and provides metadata on all active automation webhooks tied to your workspace.

## Use Cases

### The weekly status report is due, but projects are scattered.
A PM needs a snapshot of three different client accounts. They ask the agent to use `list_projects` first, then iterate through each one using `get_project` and `list_project_tasks` to pull out all overdue items into a single summary report.

### A critical bug is reported, and nobody knows who was last assigned.
The agent uses `list_task_messages` on the ticket ID. It instantly pulls up the technical note from three different people, showing exactly which team member provided the final confirmation needed for resolution.

### We need to restructure our whole quarter into new operational phases.
An Ops Lead uses `list_project_sections` and instructs the agent to update or add sections. This automates the workflow change, ensuring every team member sees the updated project structure immediately.

### I need a quick roster of contacts for an urgent meeting.
Instead of opening the separate directory tab, the PM asks the agent to run `list_team_users`, getting names and roles instantly. This saves several clicks and keeps the conversation flowing.

## Benefits

- Stop manual updates: Instead of finding a task and changing its status manually, use the `update_task` tool to simply tell your agent what needs fixing. It does the rest.
- Maintain context: The ability to call `list_task_messages` means you never lose track of *why* something was done or who said it. All history is immediately available.
- See the big picture: Use `list_projects` and then `get_project` to pull up summaries for multiple clients in minutes, without clicking through a dozen dashboards.
- Organize workflows: You can programmatically list project sections with `list_project_sections`, which is critical when you need to structure your team's operational phases quickly.
- Coordinate people: The `list_team_users` tool gives instant access to who works on what, so you don't waste time tracking down contacts or assigning ownership.

## How It Works

The bottom line is: your AI agent handles the connection and the commands for you.

1. Subscribe to this MCP and grab your Personal Access Token from BasicOps settings.
2. Connect that token within Vinkius, allowing your AI client access to the project data.
3. Tell your agent what you need—for example, 'List all active projects' or 'Update task 456 status to Done'.

## Frequently Asked Questions

**How do I use the `create_project` tool?**
You tell your agent, 'Create a new project for Marketing Q3.' The MCP handles generating the necessary structure and registering it in BasicOps.

**Can I update tasks with `update_task` via my AI client?**
Yes. You can instruct your agent to use `update_task` directly, changing status, setting due dates, or adding descriptions without logging into the web app.

**What does `list_team_users` show me?**
`list_team_users` provides a complete directory of your team members, letting you know who is available and what roles they play in BasicOps.

**Is there a way to list all projects at once? (Using `list_projects`)**
Absolutely. Using the `list_projects` tool provides an immediate overview of every single project you manage, saving you from having to navigate manually.

**How do I use `get_account_info` to check my credentials?**
The tool fetches your profile details directly. It confirms that your AI client has successfully authenticated with the BasicOps API, verifying basic operational access.

**What does `list_task_messages` do? Does it show all historical comments?**
It retrieves a complete log of communication history for any given task ID. You get every status update and note recorded in the thread, providing full context.

**How can I use `list_project_sections` to understand project phases?**
This function lists all defined sections or phases within a project structure. It helps you map out the entire operational timeline for your team.

**If I need to check integrations, how do I use `list_webhooks`?**
The tool displays all active webhooks attached to your account. This lets you monitor which external systems are connected and reporting data instantly.

**How do I find my BasicOps Personal Access Token?**
Log in to your account, navigate to **Settings** > **API**, and generate a new Personal Access Token for your integration.

**What is a Project Section via AI?**
Sections allow your agent to group related tasks into specific phases, sprints, or categories within a larger project programmatically.

**How do I list team members programmatically?**
Use the `list_users` tool to retrieve your complete organizational directory including high-fidelity names and email addresses.