# Craft.io MCP

> Craft.io MCP connects your product management data to any AI client, letting you manage features, track epics, and monitor roadmaps using natural conversation. Instead of navigating complex project boards or running manual queries, your agent accesses detailed workspace metadata, backlogs, and portfolio status instantly. This lets teams coordinate strategy and execution directly through chat.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** product-management, roadmap-software, feature-tracking, epic-management, backlog-automation, craft-io

## Description

Need to keep tabs on product plans without opening a dozen browser tabs? This connector gives you conversational access to your entire product ecosystem. You can talk to the system about features, epics, or even high-level company financials, getting instant answers instead of digging for them yourself. It helps coordinate everything from initial feature ideas to final roadmap status by letting your agent query all workspaces and portfolios in one go. If you're looking for a central hub for this kind of access, the Vinkius catalog is where it’s at. Your AI client handles the heavy lifting—it finds what you need, whether that's listing every available product workspace or checking the current status of an epic. You manage your full product lifecycle conversationally.

## Tools

### check_craft_status
Verifies if the connection to your Craft.io account is active and working correctly.

### create_item
Adds a new item, like a feature or story, into any of your product workspaces.

### get_company
Retrieves basic details and information about a specific company.

### get_company_competitors
Lists the competitors for any given company you are researching.

### get_company_employees
Fetches a list of employees associated with a specific company.

### get_company_financials
Retrieves the financial records and key metrics for a given company.

### get_item
Retrieves full details, including status and metadata, for any individual product item.

### get_company_news
Gathers recent news articles and announcements related to a specific company.

### get_portfolio
Gets comprehensive data on a specific product portfolio to understand its scope.

### list_items
Lists all the items, like features and stories, contained within a chosen workspace.

### list_portfolios
Provides an overview of all existing product portfolios in your account.

### list_workspaces
Lists every distinct product management workspace available to you.

### search_companies
Searches the database for companies based on criteria like industry or name.

## Prompt Examples

**Prompt:** 
```
List all active workspaces in my Craft.io account.
```

**Response:** 
```
I've retrieved your workspaces. You have 3 active environments: 'Mobile App Roadmap', 'Web Platform Backend', and 'Design System'. Which one would you like to see items for?
```

**Prompt:** 
```
Show me the last 5 items in the 'Mobile App Roadmap' (ID: 10293).
```

**Response:** 
```
I've fetched the items. For the 'Mobile App Roadmap', there are 5 recent items: 'Epic: Dark Mode Support', 'Feature: Social Login', 'Story: Fix Header Layout', and 2 others. Shall I retrieve the details for the Dark Mode epic?
```

**Prompt:** 
```
Create a new feature: 'AI Search Integration' in workspace 'ws_88231'.
```

**Response:** 
```
Success! The feature 'AI Search Integration' has been created in workspace ws_88231 with ID item_10293. I've added it to your product backlog in Craft.io.
```

## Capabilities

### List and inspect all workspaces
See a complete inventory of every product management workspace in your account.

### Track feature and story backlogs
Create new items or query existing ones—like stories, features, and epics—to manage your development backlog.

### Understand organizational portfolios
View and analyze product portfolio data to see how different parts of the company align strategically.

### Get detailed item information
Fetch all metadata, descriptions, and current status for any specific product item using natural language commands.

### Monitor release progress
Check the real-time progress of features or epics to keep your team on track with the scheduled release cycle.

### View company and market data
Retrieve external business intelligence, such as a company's financial reports, competitors, or employee lists.

## Use Cases

### Quarterly roadmap alignment review
The PM needs to know if 'Social Login' is ready for Q3 and how it compares to the competitor doing the same. They ask their agent, which first uses `get_item` for status, then calls `get_company_competitors` to pull market data. The result tells them exactly where they stand.

### Onboarding a new engineering team
The Engineering Lead needs an overview of the entire product suite's current state. They ask their agent to use `list_workspaces` and then `get_portfolio` to map out all active environments and associated high-level goals.

### Responding to a client query
A Product Ops specialist must answer, 'What is the financial health of our main competitor?' They ask their agent, which executes `search_companies` first, then calls `get_company_financials` on the result. The data comes back in seconds.

### Capturing quick ideas from meetings
During a brainstorming session, a PM doesn't want to open Craft.io. They ask their agent to `create_item` with a new feature idea and drop it directly into the correct workspace for later review.

## Benefits

- Stop manually checking statuses across tabs. You can ask your agent to monitor the progress of epics or features and get a direct, consolidated report.
- Boost market awareness by pulling in external data. Combine internal feature tracking with competitor lists (`get_company_competitors`) or recent company news (`get_company_news`).
- Control your product backlogs without leaving chat. Use the `create_item` tool to drop a new story or feature directly into the right workspace.
- Understand organizational strategy by viewing portfolios. Querying all available product portfolios helps you see where resources are allocated at a high level.
- Verify project scope immediately. The agent lets you list workspaces (`list_workspaces`) and get item details (`get_item`), ensuring your team knows exactly what's in play.
- Keep your process organized by using the MCP through Vinkius. You connect once to access all these tools, keeping your workflow centralized.

## How It Works

The bottom line is you ask your agent questions about your product strategy and get structured data back immediately.

1. Subscribe to this MCP and input your Craft.io API key and Account ID.
2. Direct your AI client to the connector, giving it permission to access your product data.
3. Ask your agent a question, like 'What is the status of the Dark Mode feature?' The system returns a direct answer.

## Frequently Asked Questions

**How do I use `list_workspaces` with Craft.io MCP?**
Call `list_workspaces` first to get a list of all available environments in your account. This tells you exactly what project spaces are available for the agent to query.

**Can I use `get_item` to check feature status?**
Yes. The `get_item` tool fetches detailed metadata, including the current operational status of any specific item you name in your prompt.

**Does Craft.io MCP help with competitor analysis?**
Absolutely. You can use `get_company_competitors` to list rivals and then pull their details using other tools like `get_company_financials` for a full market picture.

**What is the purpose of `create_item`?**
The `create_item` tool lets you add new items—like a story or a feature—directly into your product backlogs without needing to open the platform's UI.

**How do I link company data to my roadmap?**
You can use `search_companies` and then pull relevant financial records with `get_company_financials`. You can then ask your agent to compare that external data against a feature in your workspace using `list_items`.

**How do I use `check_craft_status` to confirm my API key works?**
It instantly verifies your connection and permissions. Running this tool confirms your AI client can successfully communicate with Craft.io, saving you time troubleshooting bad keys or access issues.

**What information does `list_portfolios` provide about my product line?**
This tool lists all the major product portfolios across your organization. It gives you a high-level view of strategic distribution, showing where company focus is without needing to drill into individual workspaces.

**How does `search_companies` help me find data on an unfamiliar business?**
You search by name or industry to narrow down results. It returns a list of matching companies and their IDs, letting you target the exact entity before running detailed queries for news or financials.

**Can I see all the items in a specific workspace via AI?**
Yes! Use the `list_workspace_items` tool and provide the Workspace ID. Your agent will retrieve all features, stories, and epics organized within that environment.

**How do I add a new feature to my backlog using the agent?**
Use the `create_product_item` action. Provide the Workspace ID and the title of the feature. The agent will instantly create the record in your Craft.io account.

**Is it possible to list all my product portfolios via AI?**
Absolutely. Use the `list_product_portfolios` query. The agent will retrieve the complete list of portfolios configured in your account, allowing you to monitor high-level strategy.