# Airfocus MCP

> airfocus MCP lets you take control of your product roadmap directly through natural conversation. You can programmatically manage the entire feature lifecycle, from listing all strategic workspaces to updating complex prioritization scores. Need to know what features are ready for development? This MCP gives your AI agent deep access to your airfocus data, letting you instantly list items, retrieve metadata, and coordinate product strategy without switching tabs or running manual reports.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** airfocus, product-management-api, roadmaps-orchestration, prioritization-tools, agile-workflows, workspace-management, feature-tracking, strategic-planning, mcp

## Description

Think of this MCP as a dedicated Chief Product Officer embedded in your workflow. It lets you manage your entire product roadmap—the features, initiatives, and tasks—simply by talking to your agent. Instead of opening five different browser tabs just to check the status of 'User Analytics' or verify if 'Mobile App v2' is ready for engineering context, your AI handles it all in one conversation. You can ask your agent to list all strategic workspaces, get detailed metadata on specific features, and even update prioritization scores across multiple boards automatically. If you're using Vinkius as part of your overall catalog connection, this MCP ensures that airfocus data becomes another reliable source for your AI client, finally giving you the full picture of what needs to be built next.

## Tools

### create_airfocus_item
Adds a new feature or task to any designated workspace.

### get_airfocus_item
Pulls specific, detailed data for one item on the board.

### list_airfocus_fields
Retrieves a list of all custom fields used to score and categorize features across your boards.

### list_airfocus_items
Shows you all the items currently contained within a specific workspace board.

### list_airfocus_workspaces
Lists every major strategic project area or roadmap available in your account.

### update_airfocus_item
Modifies the status, description, or score of an existing feature item.

## Prompt Examples

**Prompt:** 
```
List all items in the 'Product Roadmap' workspace (ID: '123').
```

**Response:** 
```
I've retrieved your roadmap items. You currently have 15 active features, including 'AI Search' (Status: In Progress) and 'Mobile App v2'. Would you like the detailed high-fidelity metadata for any of these?
```

**Prompt:** 
```
Create a new feature 'User Analytics' in workspace '123'.
```

**Response:** 
```
Item created! I've successfully registered 'User Analytics' in specified workspace (ID: 123). It's now visible on your priority board. Shall I list the custom fields for this board to set a priority score?
```

**Prompt:** 
```
Show the custom fields for workspace '123'.
```

**Response:** 
```
Accessing board configuration... Workspace 123 has 5 custom fields including 'Impact', 'Effort', and 'Strategic Fit'. I've retrieved the high-fidelity IDs for these fields to help with automated scoring. Need a summary of the values?
```

## Capabilities

### View all project areas
List every strategic workspace in your account so you know exactly where to look for data.

### Check specific feature status
Retrieve detailed information on any single item, including its current metadata and high-fidelity descriptions.

### Update roadmap data
Change the details of an existing feature or initiative, like moving a task from 'In Progress' to 'Complete'.

### Create new features
Add entirely new items, tasks, or initiatives directly into your designated product board.

### Manage scoring metrics
Update prioritization scores and custom field data to align the team on what truly matters for the next build cycle.

## Use Cases

### The quarterly sync meeting prep
A Product Owner needs a summary of all high-priority features for the Q3 review. They ask their agent to list airfocus workspaces, then pull details on items with an 'Impact' score above 80. The agent returns a clean, actionable list that requires zero manual formatting.

### The urgent bug fix request
An engineer needs to know exactly what the current production scope is for the payment flow. They use get_airfocus_item on the 'Payment Gateway' item, retrieving all necessary metadata so they can begin fixing without needing a meeting.

### The new feature ideation phase
A Product Manager brainstorms five potential features. Instead of manually creating them in airfocus, they use create_airfocus_item for all five at once, then ask the agent to list_airfocus_fields so they can set up custom scoring criteria immediately.

### Syncing between PM and Eng
The engineering team finished a component early. They use update_airfocus_item via their agent, changing the 'Mobile App v2' item status from 'In Progress' to 'Ready for Review,' keeping the roadmap accurate automatically.

## Benefits

- Stop manually checking status updates. Use get_airfocus_item to pull the detailed metadata for any feature, instantly confirming its current state and description.
- Never lose track of your scope again. list_airfocus_workspaces lets you programmatically see every single strategic roadmap area in your entire account.
- Maintain perfect team alignment by using update_airfocus_item to adjust prioritization scores across multiple initiatives with a simple prompt.
- Get engineering context without leaving your IDE. Your agent can query specific item details, ensuring the code matches the product requirements before you write a line of code.
- Speed up feature definition. You can use create_airfocus_item to register new ideas or tasks onto the roadmap instantly, keeping your flow going.

## How It Works

The bottom line is you stop managing data and start having conversations with it.

1. Subscribe to this MCP in Vinkius and grab your API key from your airfocus settings.
2. Connect that key to any compatible AI client, like Claude or Cursor.
3. Ask your agent a natural language question, for example, 'List all active features in the Q3 roadmap workspace.' The MCP handles the rest.

## Frequently Asked Questions

**How does the airfocus MCP help with feature prioritization?**
It lets you update_airfocus_item and list_airfocus_fields. You can programmatically adjust scoring metrics, like 'Impact' or 'Effort', based on strategic decisions without touching the web interface.

**Can I use airfocus MCP to see all my project boards?**
Yes. The list_airfocus_workspaces tool lets you programmatically retrieve a full catalog of every workspace in your account, helping you manage scope across multiple projects.

**What if I want to add a brand new feature idea?**
Use the create_airfocus_item function. You can ask your agent to register a new task or initiative onto any board with simple natural language commands.

**Does airfocus MCP only work for active items?**
No, it works across the whole lifecycle. By using list_airfocus_items and get_airfocus_item, you can pull status details on everything, whether it's a draft idea or an item marked as complete.

**Is airfocus MCP better than just viewing data in the web interface?**
Yes. The major difference is that this MCP allows your agent to perform actions—it doesn't just read; it writes and updates the underlying records, which you can't do with a simple view.