# Factor (Cofactr) MCP MCP

> Factor (Cofactr) MCP connects your entire electronics supply chain to your AI agent. Check real-time stock, manage component catalogs, track every purchase order, and handle supplier relationships—all without leaving your chat window.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** procurement, bill-of-materials, purchase-orders, logistics, manufacturing, inventory-tracking

## Description

Managing a complex inventory or running procurement used to mean jumping between ERP dashboards, spreadsheets, and vendor portals. You don't have to do that anymore. This connector lets you talk directly to your entire supply chain data. Need to know if 50 capacitors are available in the Phoenix warehouse? Just ask. Want to create a purchase order for three different parts from two different vendors? Your agent handles it.

It gives you full control over everything from checking component availability against your Bill of Materials to listing every supplier contact, all through natural conversation. When you connect this MCP via Vinkius, your AI client treats your entire inventory and vendor network like a single database. You can check the status of old requests for quotes (RFQs) or build entirely new purchase orders on demand.

## Tools

### create_purchase_order
Generates and submits a brand new purchase order record.

### get_item
Retrieves detailed specifications for a specific part or component number.

### get_me
Fetches the current API user profile information.

### get_purchase_order
Retrieves all details for a specific, existing purchase order number.

### get_rfq
Fetches the full details of a requested quote (RFQ).

### get_supplier
Retrieves all known information about one specific supplier.

### list_inventory
Provides a comprehensive list of current stock levels across multiple warehouses.

### list_items
Lists every part and component available in the entire product catalog.

### list_purchase_orders
Provides a list summary of all purchase orders recorded.

### list_rfqs
Lists every outstanding or completed request for quotes (RFQs).

### list_suppliers
Provides a list of all connected and pre-vetted suppliers.

## Prompt Examples

**Prompt:** 
```
List all active purchase orders on Factor.
```

**Response:** 
```
I've retrieved your purchase orders. You have PO-102 (Shipped), PO-105 (Pending Approval), and PO-108 (Received) among others. Which one should I inspect further?
```

**Prompt:** 
```
Check the kitting status for project ABC.
```

**Response:** 
```
Searching kitting status... Project ABC is 85% complete. 42 out of 50 parts are currently in stock and ready. We are waiting on 8 capacitors from Vendor X.
```

**Prompt:** 
```
List all suppliers in my network.
```

**Response:** 
```
Fetching suppliers... I found 15 pre-vetted suppliers including 'Avnet', 'Digi-Key', and 'Mouser'. Would you like to see the performance rating for any of them?
```

## Capabilities

### Check Current Stock Levels
List real-time stock counts across all your specialized warehouses.

### Create Purchase Orders
Generate and submit new purchase orders directly from the chat interface.

### Manage Components
Get details or list every part and component in your catalog, including BOM items.

### Track Requests for Quotes (RFQs)
Review the status and details of open requests for quotes from suppliers.

### View Supplier Details
Fetch information about any pre-vetted supplier in your network.

## Use Cases

### The Quarterly Inventory Audit
The Ops Coordinator needs to know if they have enough components for the Q3 product run. They ask their agent, 'List all parts needed and check current stock.' The agent uses `list_items` and `list_inventory`, providing a single, consolidated report that saves hours of cross-referencing.

### Responding to an Urgent Design Change
A Hardware Engineer realizes they need a component the team doesn't track. They ask their agent to 'check details for part X.' The agent uses `get_item` to confirm if it exists in the BOM and fetches its specifications.

### Closing Out an Old Project
The Procurement Manager needs a historical view of why a project was delayed. They ask their agent to 'list all POs for Project Beta.' The system uses `list_purchase_orders` and allows the manager to then inspect specific records using `get_purchase_order`.

### Onboarding a New Vendor
The Operations Team needs to vet a new supplier. They ask their agent to 'find all suppliers that handle microcontrollers.' The system uses `list_suppliers` and then provides full details via `get_supplier` for the top candidates.

## Benefits

- Stop switching tabs for status checks. You can list all purchase orders or check a single PO using `get_purchase_order`—all through natural dialogue.
- Need to know if you can build the next product? Use `list_inventory` to get real-time stock levels across multiple specialized warehouses instantly.
- Don't manually manage vendor lists. Quickly retrieve all supplier data or list contacts using `list_suppliers` and `get_supplier` in seconds.
- Creating new orders is fast. Instead of filling out forms, your agent can draft and submit the entire purchase order using `create_purchase_order`.
- Manage sourcing requests without friction. You can view all open RFQs with `list_rfqs` or get deep details on a specific one using `get_rfq`.

## How It Works

The bottom line is you talk to your supply chain system using plain English commands through any MCP-compatible client.

1. Subscribe to this MCP and enter your Factor/Cofactr API Key and Base URL.
2. Connect the credential data through your preferred AI client (like Claude or Cursor).
3. Use natural language instructions—for example, asking your agent to 'list all pending purchase orders'—and get the results immediately.

## Frequently Asked Questions

**How do I list all components using the `list_items` tool?**
You simply ask your agent to 'List all items in the catalog.' The agent will use the `list_items` tool and return a comprehensive, filterable list of every component available.

**Can I create a purchase order with `create_purchase_order`?**
Yes. You tell your agent which parts you need and how many, and it executes the `create_purchase_order` tool to generate the record in Factor.

**What is the difference between `get_item` and `list_items`?**
`list_items` gives you an overview of everything in the catalog. Use `get_item` when you know the exact part number and only need its specific details.

**How do I check inventory levels with `list_inventory`?**
Ask your agent to 'List current stock across all warehouses.' The agent runs `list_inventory`, giving you a real-time count report by location and part number.

**How do I verify my credentials or check my account status using `get_me`?**
It retrieves your current API user profile information. This lets you confirm that the connection is active and provides key details about the linked Factor/Cofactr account, helping you troubleshoot setup issues right away.

**If I want to check a specific PO status, should I use `get_purchase_order` or `list_purchase_orders`?**
You need to use `get_purchase_order` when you already have the specific Purchase Order number. This tool lets you inspect detailed information for just one order, like its current shipping status or line items.

**What is the best way to track all open sourcing requests using `list_rfqs`?**
This tool pulls a comprehensive list of all Requests for Quotes. It's perfect for generating an immediate overview of which vendors need to provide pricing and tracking the overall status of your supply chain needs.

**If I run `list_suppliers` multiple times in a day, are there rate limits I should worry about?**
The MCP handles standard API rate limiting automatically. However, running many mass lookups (like listing all suppliers) frequently might require checking your dedicated Factor/Cofactr documentation for specific quota details.

**How do I obtain my Factor/Cofactr API Key?**
API access is available to Cofactr enterprise customers. Reach out to your account manager or point of contact at Cofactr to request a Platform API key.

**What systems does Factor integrate with?**
Factor (Cofactr) is designed to sync with major ERP systems like NetSuite, Oracle, and SAP, as well as PLM tools like Arena and Altium.

**Can I create new Purchase Orders through this agent?**
Yes! The `create_purchase_order` tool allows you to programmatically generate POs directly within your AI-powered procurement workflow.