Purchased Services Analytics MCP Server

Installation

Use this URL as a streamable HTTP MCP server endpoint in your MCP client.

https://psa-mcp.dev.directsupply-sandbox.cloud/mcp

Config Shape

{
  "mcpServers": {
    "psa": {
      "url": "https://psa-mcp.dev.directsupply-sandbox.cloud/mcp"
    }
  }
}

Available Tools

Rendered from the same MCP descriptors used by tools/list.

5 available

Tool	Title	Source	Description
`resolve_customer_scope`	Resolve Customer Scope	composite	Read-only. Resolve a user-provided location, facility, system, customer, or aggregation group name into the canonical facilityId, systemId, or aggregateGroupId to use as a downstream spend or invoice scope. Use this when the user types an imprecise location/facility/system/group name such as 'northbrook', 'Mayo clinic', or 'Captis' instead of an exact ID. Do not use this to retrieve spend or invoice data; if needsDisambiguation is true, ask the user to choose a suggested facility, system, or aggregation group before proceeding.
`resolve_category`	Resolve Category	composite	Read-only. Resolve a user-provided category phrase against the PSA category catalog from the Payment API and return canonical categories plus lexical candidates. Use this when the user mentions a spend category or asks for category news but may not know the exact category name or categoryId; do not use it for supplier, facility, or customer resolution. If multiple plausible categories remain, ask the user to choose before using a categoryId.
`resolve_supplier`	Resolve Supplier	composite	Read-only. Resolve user-provided supplier text against VIPR Payment supplier search to a canonical supplierId for downstream spend, invoice, contract, diversity, or usage tools. Use this when the user provides a supplier name, alternate formatting, or messy supplier reference instead of a supplierId; do not use this to retrieve spend or invoice data. If multiple plausible matches are returned and needsDisambiguation is true, ask the user to choose a suggested supplier before proceeding; do not guess.
`list_facilities_for_system`	List Facilities For System	composite	Read-only. List all facilities that belong to a VIPR Payment system. Use this when the user asks for facilities, locations, buildings, or child facilities within a named or known system; accepts systemId or systemName and resolves names before listing facilities. Do not use this for spend totals, supplier lookup, or facility name disambiguation by itself; if system resolution returns multiple matches, ask the user to choose before proceeding.
`get_spend_summary`	Get Spend Summary	composite	Read-only. Return total or grouped spend from VIPR Payment data using optional customer, category, supplier, department, GL, and date filters. Use this when the user asks how much was spent, who or which facility spent the most, top suppliers or categories, or monthly/category/supplier/facility rollups. Do not use this for invoice row details, product drill-downs, non-category exclusion math, or peer benchmark-only comparisons; if a resolver reports ambiguity, ask the user to choose before proceeding.

5 available tools
5 composite
0 OpenAPI