# Orderful MCP

> Orderful MCP gives your AI client direct access to B2B supply chain data. It lets you programmatically manage EDI transactions, track partner relationships, and diagnose complex supply chain errors without touching a dashboard. Connect once via Vinkius and get instant visibility into global logistics flow.

## Overview
- **Category:** logistics-supply-chain
- **Price:** Free
- **Tags:** edi, supply-chain, b2b-integration, transaction-monitoring, data-validation

## Description

Managing B2B supply chains means dealing with tons of structured data: transaction confirmations, compliance guidelines, and trading partner rules. This MCP connects your agent to Orderful's API, giving it the power to handle that complexity directly. Instead of manually checking multiple systems for every shipment status or error code, your AI client can now investigate everything in one conversation.

It handles both the high-level view—like seeing all active trading partners and the communication channels available—and the granular details, such as retrieving validation errors linked to a specific transaction ID. When you use Vinkius, your agent gets access to this entire catalog of logistics data. You can automate status checks for inbound or outbound transactions simply by talking to it; no complex scripting required.

## Tools

### get_organization
Retrieves basic details about a specific organization within your network.

### get_transaction
Pulls all the data associated with one specific EDI transaction ID.

### get_transaction_errors
Identifies and reports validation or processing errors for a given transaction.

### list_communication_channels
Lists all the supported communication methods used for B2B data exchange.

### list_guidelines
Provides a list of required industry or partner-specific EDI guidelines.

### list_relationships
Retrieves a catalog of all active trading partner relationships you maintain.

### list_transaction_types
Shows the full list of transaction types that your system supports and processes.

### list_transactions
Generates a comprehensive list of all recent and historical EDI transactions in your account.

## Prompt Examples

**Prompt:** 
```
List my recent EDI transactions.
```

**Response:** 
```
Fetching transactions... I've found 12 recent EDI exchanges. 8 are RECEIVED and 4 were SENT successfully.
```

## Capabilities

### Track and list supply chain transactions
You can request a full history of EDI exchanges, including both successful and pending records.

### Get specific transaction details
This lets your agent pull all the data associated with one single exchange or document ID.

### Diagnose transaction failures
If a transaction fails, you can immediately ask for and receive the exact validation and processing errors that caused it.

### Manage partner relationships
You can list all active trading partners and monitor their status within your network.

### Check compliance guidelines and channels
The MCP lets you view the supported communication methods, necessary industry guidelines, and valid transaction types.

## Use Cases

### Investigating an unexpected delay.
The Operations Analyst notices a shipment stalled. They ask their agent to list_transactions for that ID. The agent finds the exchange and then uses get_transaction_errors, immediately revealing a required compliance guideline is missing, resolving the issue in minutes.

### Onboarding a new vendor.
The Procurement Specialist needs to ensure the new partner meets standards. They call list_guidelines and check that their organization details are correct using get_organization before allowing any transactions.

### Auditing network health.
A Logistics Manager wants a full picture of who's connected to whom. They ask the agent to list_relationships, followed by checking list_communication_channels, ensuring all necessary pathways are open for upcoming peak season volume.

## Benefits

- You stop guessing why a shipment is stuck. By running list_transactions, you get an instant history of every exchange, allowing your agent to tell you exactly where the data flow broke down.
- Compliance checks are automated. Instead of reading lengthy PDFs, simply ask for list_guidelines to confirm what rules apply before sending critical documents to a new partner.
- Error diagnosis is immediate. When something fails, using get_transaction_errors pulls up the precise failure code and reason, saving you hours of manual troubleshooting.
- Relationship mapping becomes easy. You can quickly call list_relationships to verify if two partners are correctly linked before initiating any major transaction.
- Operational visibility covers everything from channels (list_communication_channels) to types (list_transaction_types), giving your agent a full 360-degree view of the logistics network.

## How It Works

The bottom line is that your agent talks directly to Orderful's core logistics system without you writing any code.

1. Subscribe to this Orderful MCP on Vinkius and enter your dedicated API key.
2. Your AI client recognizes the connection and makes the data available through natural language prompts.
3. You ask a question, like 'What were my recent transactions?' and the agent returns structured data about trades, partners, or errors.

## Frequently Asked Questions

**How do I list recent transactions using the Orderful MCP?**
You simply ask your agent to use list_transactions. This tool gives you a full history of all EDI exchanges, letting you see what was sent and received in bulk.

**What does get_transaction_errors do with Orderful MCP?**
It pinpoints the exact reason for failure. If an exchange fails, this tool pulls up detailed validation errors so you know if it's a format issue or a compliance problem.

**Can I check my partners using list_relationships in Orderful MCP?**
Yes, that’s exactly what list_relationships does. It gives you an up-to-date view of all your active trading partner connections and their status.

**Do I need to know the transaction type before using Orderful MCP?**
No, but it's helpful to check first. You can use list_transaction_types to see what kinds of exchanges your system supports, which helps scope your investigation.

**How do I find out available communication methods? (Orderful MCP)**
Use the list_communication_channels tool. It shows all the different ways that B2B data can legally and technically flow between parties in your network.