# YoneTeam MCP > YoneTeam MCP connects your Turkish procurement system to your agent. Manage the entire buying cycle—from creating internal purchase demands to comparing supplier quotes and tracking finalized deliveries. It lets you ask questions about materials, suppliers, and open orders using natural conversation. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** procurement, purchasing-management, demand-management, supplier-offers, order-management ## Description You can manage every step of a supply chain deal right through chat. Start by defining what you need with a new purchasing demand; then, compare real-time offers from multiple vendors. The system tracks the purchase order lifecycle until delivery is scheduled. If you're building complex automations that cross procurement and finance, remember Vinkius lets your agent connect this MCP with other systems through multi-MCP chaining. This means you don't just track orders; you build end-to-end workflows spanning different business platforms. You get full visibility into every action taken via Vinkius AI Analytics, so nothing happens in the dark. ## Tools ### create_demand Generates a new internal purchase demand record in the system. ### get_me Retrieves basic account information for verification purposes. ### get_offer_details Pulls specific details about an existing supplier quote or offer. ### get_order_details Retrieves the full history and current status of a specified purchase order. ### list_deliveries Provides a list view of all scheduled future deliveries and shipments. ### list_demands Displays a comprehensive list of internal purchasing demands, including status and department. ### list_materials_catalog Shows the master list of available materials for sourcing within the company. ### list_offers Lists all current and historical supplier offers and quotes related to a demand. ### list_purchase_orders Provides an index of all purchase orders that have been issued or are pending. ### list_suppliers Retrieves a directory of approved and vetted suppliers for sourcing materials. ## Prompt Examples **Prompt:** ``` Show me all pending purchasing demands from the IT department. ``` **Response:** ``` I've retrieved the demands. There are 2 pending requests from IT: 'Laptops for New Hires' and 'Server Maintenance Spares'. Would you like to check for supplier offers on these? ``` **Prompt:** ``` Compare the current offers for purchase demand #1029. ``` **Response:** ``` I've analyzed the offers for Demand #1029. You have 3 quotes: 'Global Systems' ($1,200), 'Office Plus' ($1,150), and 'Tech Source' ($1,300). 'Office Plus' is currently the most cost-effective option. ``` **Prompt:** ``` Create a new demand for '10x Ergonomic Chairs' for the Sales team. ``` **Response:** ``` Success! A new purchasing demand for '10x Ergonomic Chairs' (Sales Dept) has been created with ID DEM-8823. I'll monitor for incoming supplier offers. ``` ## Capabilities ### Start a Purchase Request Create a new internal purchasing demand when an item or service is needed. ### Compare Vendor Pricing Query and inspect multiple supplier offers to determine the most cost-effective buying choice. ### Track Order Status Get detailed information on a specific purchase order, including its current status and expected dates. ### View Vendor List List all approved suppliers or browse the internal materials catalog to find sourcing options. ### Monitor Shipments Retrieve a list of scheduled deliveries and incoming shipments for operational tracking. ## Use Cases ### The IT department needs new servers. Instead of emailing three different managers for quotes, the agent first lists purchasing demands. Then, using that list, it queries multiple supplier offers and recommends the most cost-effective option before creating a formal purchase order. ### The warehouse needs to know if materials are coming. The user asks for scheduled shipments. The agent uses list_deliveries to pull data, cross-references it with list_purchase_orders, and alerts the team if a key material is delayed. ### A new project requires unusual materials. The user first lists approved suppliers. Then, using that directory, they check the materials catalog to confirm availability before initiating a purchase demand for specialized parts. ### Closing out an old order. A manager needs to verify the final count and payment status of an older item. The agent retrieves the details using get_order_details, confirming everything matched the initial demand. ## Benefits - Never manually check status updates again. You can instantly list all pending demands or view purchase order details using the agent, saving hours of dashboard clicking. - Stop guessing on pricing. The MCP lets you query multiple supplier offers and compare quotes side-by-side to make sure you're always getting the best deal. - Build full automations that span platforms. By chaining this procurement MCP with a billing system, your agent can process a purchase order right through to invoicing in one go. - Stay organized on inventory needs. Use list_materials_catalog and list_suppliers together to quickly identify approved vendors for specific items when an emergency demand pops up. - Get clear delivery visibility. Instead of calling logistics daily, you can list deliveries to see exactly when materials are scheduled to arrive. ## How It Works The bottom line is you use natural conversation to execute complex backend ERP tasks. 1. Subscribe to this MCP and input your YoneTeam API Key. 2. Connect your agent (Claude, Cursor, or any compatible client) using the credentials. 3. Ask your agent a question—for example, 'What are all pending demands for IT?'—and it handles the rest. ## Frequently Asked Questions **How do I use create_demand? Is it hard?** It's easy. Just tell your agent what you need, who needs it, and for how many units. The tool handles formatting the request into a formal purchasing demand. **Can list_offers compare prices automatically?** Yes. It lists all available supplier offers and when asked, your agent analyzes them to help you find the most cost-effective option based on your criteria. **What is the purpose of list_suppliers? Does it track pricing?** list_suppliers gives you a directory of approved vendors. It helps narrow down who can even provide materials, so you don't waste time asking non-vetted companies. **How does get_order_details help me when I have a purchase order number?** You just provide the PO ID. The tool pulls up all related information: who ordered it, what was purchased, and its current location in the supply chain. **Do I need to use create_demand before list_purchase_orders?** Not necessarily, but usually yes. While you can list existing purchase orders, creating a demand first formalizes the underlying need and makes the subsequent order process smoother. **When I use list_materials_catalog, how can I filter for specific material categories or suppliers?** The tool allows filtering by category code and supplier ID. If you don't specify these parameters, it returns the full catalog. Always check the documentation to see which fields support dynamic filtering. **If I run get_offer_details, does the data tell me if the quoted price is still valid or if it has expired?** Yes. The details returned include a 'status' field and an explicit expiration date for every offer analyzed. This prevents you from basing decisions on outdated pricing. **After connecting my account, what should I run with get_me to confirm that the AI agent has all the necessary permissions?** Running this tool validates your current API scope and returns core account identifiers. Use it immediately after setup to verify the agent can access all modules you need. **Can I see the pricing details of a specific supplier offer?** Yes, use the `get_offer_details` tool with the appropriate Offer ID to retrieve full metadata and pricing information from the quote. **How do I check when a purchase order is scheduled to arrive?** You can use the `list_deliveries` query to see a schedule of all incoming material shipments and their estimated arrival dates. **Is it possible to list all materials available in our catalog?** Absolutely. Run the `list_materials_catalog` query to retrieve a complete list of items and materials currently registered in the purchasing system.