# oboloo MCP > oboloo MCP Server handles end-to-end procurement management. It lets your AI client track contracts, analyze spending trends by category, and monitor supplier risk scores across your entire vendor base. You can list all suppliers, view pending approvals, and run deep spend analysis to find where the money actually goes. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** procurement, supplier-management, contract-tracking, spend-analysis, compliance-monitoring, cost-savings ## Description Look, this isn't some generic dashboard. This Oboloo MCP Server gives your AI client total control over how you handle procurement—from finding out if the API is even working to figuring out exactly where every dime went last year. When you hook up oboloo, your agent can track contracts, monitor supplier risk scores across your whole vendor list, and run deep spend analysis so you know exactly what's eating up your budget. If you need to start anywhere, first, check the health with `check_oboloo_status` to make sure everything’s running clean. Need a quick overview of who you work with? You can pull every vendor in the system using `list_suppliers`, and then dive deep into any single company's profile by calling `get_supplier`. When it comes to contracts, there are ways to see *everything*. Run `list_contracts` for an index of every agreement you’ve ever signed. If you need the nitty-gritty details on a specific deal, use `get_contract`, which pulls all the terms and dates for one contract ID. You can also track your historical dealings by running `list_projects` to see both current and archived procurement initiatives. You gotta know what's pending, right? Your agent checks for necessary internal sign-offs using `list_approvals`; this tells you exactly which purchases are sitting there waiting on a human decision. You can also get the full picture of your spending by calling `get_spend_analysis`, which spits out a breakdown showing how much money went to different categories and individual suppliers, letting you see where the dough actually lands. Want to scope out the rules? Run `list_categories` if you need the official list of spending buckets used in the system. You can also pull detailed info on any specific project using `get_project`. If risk is your thing, use `list_risks`; it generates a report detailing known red flags attached to suppliers or contracts, helping you flag compliance issues before they blow up. And don't forget about savings—`list_savings` provides records of cost cuts identified in past cycles. Need to keep track of your agreements? Beyond just listing them, `list_contracts` gives you that full index. You can also run a dedicated list of all current and archived projects using `list_projects`. If you're building out vendor relationships, `get_supplier` gets you the profile data for any single vendor, while `list_suppliers` pulls the master roster. Think about what’s next: if you see spending patterns that need checking, `get_spend_analysis` shows the distribution across categories and vendors. You can even list all those historical contracts with `list_contracts`, or check which items are waiting for approval using `list_approvals`. Your agent covers it all, giving you visibility into vendor risk via `list_risks`, managing procurement flow by getting project details with `get_project`. ## Tools ### check_oboloo_status Verifies the current connection status of the oboloo API. ### get_contract Retrieves specific, detailed information for a single procurement contract. ### get_project Gets all necessary details regarding a specified procurement project. ### get_spend_analysis Returns a breakdown of spending by category and supplier. ### get_supplier Pulls all profile data for one specific vendor. ### list_approvals Lists all pending internal approvals that require action. ### list_categories Returns a list of recognized spending categories used in the system. ### list_contracts Retrieves an exhaustive index of every contract on file. ### list_projects Lists all current and archived procurement projects. ### list_risks Generates a report detailing known risks associated with suppliers or contracts. ### list_savings Provides records of cost savings identified in past spending cycles. ### list_suppliers Lists every vendor currently registered in the oboloo system. ## Prompt Examples **Prompt:** ``` List all my suppliers. ``` **Response:** ``` You have 89 suppliers. Top by spend: 'TechParts Inc.' (.2M), 'Office Supply Co.' (), 'Cloud Services Ltd.' (). ``` **Prompt:** ``` Show procurement spend analysis. ``` **Response:** ``` Total spend: .8M. Technology 42% (.0M), Facilities 23% (.1M), Services 18% (), Materials 17% (). Savings identified: . ``` **Prompt:** ``` Show all pending approvals. ``` **Response:** ``` 7 pending approvals: 'Server Upgrade' (, due tomorrow), 'Office Lease Renewal' (, due Friday), 'SaaS License' (, due next week). ``` ## Capabilities ### Assess Supplier Profiles Retrieves detailed information on specific vendors using the `get_supplier` tool. ### Audit Contract Details Fetches all necessary data points for a given contract ID via the `get_contract` tool, allowing full review of terms and dates. ### Analyze Spend by Category Generates a detailed financial breakdown of spending using `get_spend_analysis`, showing distribution across predefined categories. ### List Active Contracts Retrieves an exhaustive list of all active and historical contracts available in the system via `list_contracts`. ### Determine Pending Approvals Checks for necessary internal sign-offs by calling `list_approvals`, telling you exactly what needs a human decision. ### Identify Vendor Risks Provides actionable risk reports on suppliers and contracts using the dedicated `list_risks` tool, helping flag compliance issues. ## Use Cases ### Vetting a New Vendor A supply chain coordinator needs to onboard 'Global Logistics Inc.' First, they run `get_supplier` to review the vendor's profile. Next, they use `list_risks` to see if any red flags pop up on their contracts. Finally, they check `list_contracts` to ensure Global Logistics already has an active agreement structure before proceeding. ### Auditing Budget Overruns A finance analyst notices spending is too high in one area. They call `get_spend_analysis`, which shows the category and supplier breakdown. If they see a spike, they can then use `get_contract` on that specific vendor to check if their pricing changed unexpectedly. ### Preparing for an Audit A manager needs proof of due diligence across all vendors. They start by running `list_suppliers` to get a master list, then use `list_risks` and `get_contract` on key accounts to compile documentation proving compliance and proper contract execution. ### Completing a Major Project A project lead is finishing the 'Warehouse Upgrade' initiative. They check `list_projects` for the status, then use `get_project` details to confirm milestones were hit. The last step is checking `list_approvals` to ensure final budget sign-off was secured. ## Benefits - Stop guessing where your money goes. Use `get_spend_analysis` to break down total spending by category or supplier instantly, giving you clear financial accountability without digging through reports. - Keep compliance airtight. Running `list_risks` gives you a consolidated view of both vendor and contract risks, letting you flag potential issues before they become audit failures. - Never miss an approval step again. The `list_approvals` tool immediately shows which purchases or changes are stuck waiting for sign-off, keeping your supply chain moving. - Build better relationships by knowing your vendors' weak spots. Use `get_supplier` to pull full profiles and assess their health alongside running `list_risks` against them. - Track cost reductions automatically. The `list_savings` tool compiles all documented savings, giving you the data needed to justify process improvements or budget adjustments. ## How It Works The bottom line is, your AI client runs the specific oboloo tools against your account to get granular data, then presents that information directly to you without needing manual steps. 1. You ask your AI client to perform a task—for example, 'Check the total spend in technology for Q3'. 2. The agent identifies that it needs financial data and calls the `get_spend_analysis` tool. 3. Oboloo returns the structured spending report. Your agent processes this data and sends you a plain English answer. ## Frequently Asked Questions **How do I check if my vendor has any known risks using list_risks?** You run `list_risks` and specify the vendor or contract ID you are concerned about. The tool returns a categorized report of all active flags, like compliance failures or financial instability warnings. **Can I find out how much we spent on specific categories using get_spend_analysis?** Yes. Use `get_spend_analysis` and specify the timeframe and category codes (you can use `list_categories` first) to generate a precise spending breakdown. **Do I need to list all contracts or just one? What's the difference between list_contracts and get_contract?** `list_contracts` gives you an index—a table of contents for every contract ID. `get_contract` takes one specific ID from that list and pulls all the deep, detailed terms and conditions for just that single agreement. **What if I want to see who needs to sign off on a purchase? Which tool do I use?** Use `list_approvals`. This tool gives you an immediate count and list of pending approvals. It tells you exactly what decision is required, and from whom. **Before running reports, how can I confirm connectivity using check_oboloo_status?** It verifies your API connection status immediately. This tool confirms that your agent can successfully talk to oboloo's endpoints. You should run this whenever you switch environments or credentials to make sure nothing broke. **Does list_suppliers pull all supplier data at once if my vendor has thousands of contacts?** No, it handles large datasets by returning paginated results. Your agent will automatically iterate through pages of suppliers rather than hitting a single limit, ensuring you get the complete dataset. **When should I use list_projects instead of checking a specific project with get_project?** Use list_projects when you need an overview of all active initiatives. It shows the names and current status dates across your entire portfolio before you deep-dive into one specific project's details. **I need to analyze spending but don't know the codes. How do I find out what spend types are possible using list_categories?** This tool gives you a master list of all defined cost categories available in your account. You can feed these category IDs back into your prompts for accurate and structured spend reporting, eliminating guesswork. **Can my AI list suppliers and contracts?** Yes. `list_suppliers` and `list_contracts` retrieve all records, then `get_supplier` or `get_contract` provide full details. **Can I analyze procurement spend?** Yes. `get_spend_analysis` returns spend breakdowns by category and supplier. **Can I see pending approvals?** Yes. `list_approvals` returns all items awaiting procurement approval with details and deadlines.