mcp-procurement 2.0.0

Procurement MCP server — purchase orders, RFQs, supplier management, approvals, receiving, spend analytics, contract tracking
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

use serde::{Deserialize, Serialize};
use serde_json::Value;

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Supplier {
    pub id: String,
    pub name: String,
    pub category: String,
    pub contact_email: Option<String>,
    pub contact_phone: Option<String>,
    pub country: String,
    pub currency: String,
    pub payment_terms: String, // net30, net60, cod
    pub rating: f64, // 0-5
    pub status: String, // active, suspended, blacklisted
    pub metadata: Value,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct PurchaseOrder {
    pub id: String,
    pub supplier_id: String,
    pub status: String, // draft, pending_approval, approved, sent, partially_received, received, cancelled
    pub lines: Vec<PoLine>,
    pub currency: String,
    pub subtotal: f64,
    pub tax: f64,
    pub total: f64,
    pub payment_terms: String,
    pub delivery_date: Option<String>,
    pub notes: Option<String>,
    pub created_by: String,
    pub approved_by: Option<String>,
    pub created_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct PoLine {
    pub sku: String,
    pub description: String,
    pub quantity: f64,
    pub unit_price: f64,
    pub total: f64,
    pub received_qty: f64,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Rfq {
    pub id: String,
    pub title: String,
    pub status: String, // open, closed, awarded
    pub items: Vec<RfqItem>,
    pub supplier_ids: Vec<String>,
    pub responses: Vec<RfqResponse>,
    pub deadline: String,
    pub created_by: String,
    pub created_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct RfqItem {
    pub description: String,
    pub quantity: f64,
    pub unit: String,
    pub specs: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct RfqResponse {
    pub supplier_id: String,
    pub supplier_name: String,
    pub unit_prices: Vec<f64>,
    pub total: f64,
    pub lead_time_days: u32,
    pub notes: Option<String>,
    pub submitted_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct GoodsReceipt {
    pub id: String,
    pub po_id: String,
    pub lines: Vec<ReceiptLine>,
    pub received_by: String,
    pub received_at: String,
    pub notes: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct ReceiptLine {
    pub sku: String,
    pub quantity_received: f64,
    pub quantity_rejected: f64,
    pub rejection_reason: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Contract {
    pub id: String,
    pub supplier_id: String,
    pub title: String,
    pub contract_type: String, // fixed_price, time_materials, blanket, framework
    pub value: f64,
    pub currency: String,
    pub start_date: String,
    pub end_date: String,
    pub auto_renew: bool,
    pub terms: String,
    pub status: String, // draft, active, expired, terminated
    pub created_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Invoice {
    pub id: String,
    pub po_id: String,
    pub supplier_id: String,
    pub invoice_number: String,
    pub amount: f64,
    pub currency: String,
    pub status: String, // pending, matched, disputed, paid
    pub received_at: String,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Budget {
    pub id: String,
    pub department: String,
    pub category: String,
    pub allocated: f64,
    pub spent: f64,
    pub currency: String,
    pub period: String, // 2026-Q2, 2026
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct SupplierDiversity {
    pub supplier_id: String,
    pub certifications: Vec<String>, // minority_owned, women_owned, veteran_owned, small_business, disabled_owned, lgbtq_owned
    pub certified_by: Option<String>,
    pub expiry_date: Option<String>,
}

#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct CatalogItem {
    pub id: String,
    pub supplier_id: String,
    pub sku: String,
    pub description: String,
    pub unit_price: f64,
    pub currency: String,
    pub lead_time_days: u32,
    pub min_order_qty: f64,
}