# Infinity MCP MCP

> Infinity MCP lets you manage complex projects using natural language conversations. It connects to your work boards and workspaces, allowing you to interact with tasks, attributes, and records without ever leaving your AI client. You can list all available workspaces, inspect board structures, create new items, or update status fields just by talking to your agent.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** task-management, workspace-organization, custom-attributes, board-management, workflow-automation

## Description

This MCP lets you treat your project management system like a conversation partner. Instead of clicking through multiple tabs, navigating folder hierarchies, and manually updating statuses in the Infinity dashboard, you simply ask your AI client to do it for you. It reads the entire structure—from listing all workspaces to checking custom attributes on any board—and executes the changes directly.

When using Vinkius, you connect your preferred AI client once and gain access to this full library of project tools. Your agent can then read item field values and metadata across boards or create brand new tasks right from chat. It's about getting data out of silos and into a conversational workflow.

## Tools

### check_api_health
Verifies if the connection to the Infinity API is active and working.

### create_board_item
Adds a brand new task or record item to a specific board.

### remove_board_item
Deletes an existing task or record item from a board, making it permanently unavailable.

### get_current_user_profile
Retrieves the basic profile information for the authenticated user making the request.

### list_board_attributes
Reads and lists all custom fields and attributes defined on a specific board.

### list_workspace_boards
Lists all the individual boards that belong to a specified workspace.

### list_item_comments
Fetches the comment history associated with an item on a board.

### list_board_folders
Gets a list of folder containers within an existing board.

### list_board_items
Retrieves all tasks or records from a specified board, allowing filtering by folders.

### list_board_webhooks
Displays active webhooks that are currently running for a given board.

### list_workspaces
Retrieves a directory of every major workspace available in the organization.

### update_board_item
Modifies the details of an item that already exists on a board.

## Prompt Examples

**Prompt:** 
```
Show all workspaces and the boards in the 'Product Development' workspace.
```

**Response:** 
```
Workspaces: 4. Product Development, Marketing, Operations, HR. 'Product Development' boards: 1) 'Sprint Board' (42 items, 8 folders). 2) 'Bug Tracker' (23 items). 3) 'Feature Requests' (56 items). 4) 'Roadmap' (12 items). Total: 133 items across 4 boards. Would you like to see items or folders in a specific board?
```

**Prompt:** 
```
Create a new task in the Sprint Board and list all items with 'In Progress' status.
```

**Response:** 
```
Task created! 'Implement OAuth integration' in Sprint Board (item_4521). Assigned folder: 'Sprint 12'. Status: To Do. Priority: High. In Progress items (8): 'API rate limiting' (Sarah, 3 days), 'Dashboard redesign' (Mike, 5 days), 'Email notifications' (Lisa, 2 days), 5 others. Sprint Board: 42 → 43 items.
```

**Prompt:** 
```
Show the attributes on the Bug Tracker board and the folder structure.
```

**Response:** 
```
Bug Tracker attributes: 8 fields. Status (dropdown: Open, In Progress, Resolved, Closed), Priority (dropdown: Critical, High, Medium, Low), Assignee (person), Due Date (date), Component (dropdown: Frontend, Backend, API, Mobile), Steps to Reproduce (text), Screenshots (file), Resolution (text). Folders: 4. 'Frontend Bugs' (8 items), 'Backend Bugs' (6), 'API Issues' (5), 'Mobile' (4). Total: 23 bug reports.
```

## Capabilities

### Discover workspaces
Lists all high-level project containers within your organization.

### View board structure
Inspects the layout, folders, and attributes configured on specific boards.

### Manage tasks (items)
Creates, modifies, or deletes individual tasks and records within any specified board.

### Read custom data
Retrieves specific field values and metadata from existing items on a board.

### Audit user access
Provides basic details about the authenticated user linked to this connection.

## Use Cases

### Audit a large project scope
The PM needs to know if the 'Q3 Marketing' workspace has all its expected boards. They ask their agent to use `list_workspaces` followed by `list_workspace_boards`. The agent returns a list of every board, ensuring nothing was missed before planning capacity.

### Update status across multiple items
The ops engineer finishes reviewing 15 bug reports. Instead of opening them one by one, they ask the agent to use `update_board_item` for all of them, setting the status from 'In Progress' to 'Ready for QA'.

### Check data integrity before migration
A dev needs to verify what attributes are used on a legacy board. They use `list_board_attributes` to get a definitive list of all fields, guaranteeing that the new system will match the old structure.

### Get project visibility
The user asks to see all tasks in the 'Bug Tracker' board. The agent uses `list_board_items` and can optionally narrow the scope by calling `list_board_folders`, providing a complete, structured report.

## Benefits

- Stop switching contexts. You can create new items using `create_board_item` or update existing ones with `update_board_item` without ever leaving your chat window.
- Get a full view of your project scope by calling `list_workspaces` and then `list_workspace_boards`. It maps out the entire organizational structure for you.
- No more guessing what data exists. Use `list_board_attributes` to instantly see all custom fields configured on any board, ensuring you don't miss crucial metadata.
- Keep track of conversations around a task by using `list_item_comments`. You get the full history right alongside the task details.
- Automate cleanup. If an item is obsolete or needs archiving, use `remove_board_item` to delete it directly through conversation.

## How It Works

The bottom line is that your AI client handles the API calls; you just talk to it.

1. First, subscribe to this MCP and provide your Infinity Access Token.
2. Next, pass a natural language request (e.g., 'List all boards in the Marketing workspace').
3. Your agent executes the required tool calls through Vinkius and returns structured data or confirmation.

## Frequently Asked Questions

**How do I find all my projects in Infinity using the list_workspaces tool?**
You simply ask your agent to 'List all workspaces.' It executes `list_workspaces` and gives you a directory of every major project container, helping you scope out where to look next.

**Can I update the status of an item using the update_board_item tool?**
Yes. You must provide the specific item ID or unique reference data for `update_board_item` to work. Otherwise, you'll get an error.

**What does list_board_attributes do in Infinity?**
`list_board_attributes` reads and reports all the custom fields on a board. This is useful if you need to know what metadata (like 'Priority' or 'Assignee') is even available for items.

**Do I have to list every item manually using list_board_items?**
No, the agent can handle that. If you ask for all tasks in a board, it uses `list_board_items` and handles potential filtering by folder automatically.

**What does `get_current_user_profile` do if my API token loses access?**
It immediately returns an unauthorized error, letting you know your credentials are bad or revoked. This forces you to reauthenticate and refresh the connection using a new Infinity Access Token.

**When I use `list_item_comments`, how does it handle items with hundreds of comments?**
The tool supports pagination, so you won't get an overflow error. You just need to make subsequent calls using the page marker provided in the initial response until you collect all comments.

**If I run `create_board_item` and miss a required attribute field, what happens?**
The function will fail with a specific validation error listing every missing or incorrectly typed field. You'll need to check the board's schema using `list_board_attributes` first.

**How can I use `list_board_folders` to find exactly which section an item belongs in?**
It outputs a full, nested folder path structure. You can trace the hierarchy from the top-level workspace down to the exact subfolder where your target task resides.

**Can I create and manage tasks through the AI agent?**
Yes. Use `create_board_item` to add new items to any board, `list_board_items` to browse existing items, `update_board_item` to modify fields and status, and `delete_board_item` to remove items. Use `list_board_attributes` to see available fields.

**Can I navigate workspaces, boards, and folders?**
Yes. Use `list_workspaces` → `list_workspace_boards` → `list_board_folders` to navigate the hierarchy. Each level provides IDs needed for the next level and for item management.

**Can I view custom fields and attributes on boards?**
Yes. `list_board_attributes` retrieves all custom attributes (fields) configured on a board, including field type, options, and default values. This helps understand the data structure before creating or updating items.