MCP tool implementation notes

A stable tool count would become stale. This page describes capability groups and where their availability differs.

The canonical tool list is the tool-reference resource served by the MCP server — every advertised tool with its purpose, scope, and arguments. What your connection exposes depends on your key's scopes, so confirm with tools/list on your own transport.

RAG and materials

Registered on the full server

Semantic contractor search, answer-with-sources behavior, vector statistics, and material search/detail/list handlers are defined in mcp.ts.

Supplier ingestion and BOM

Implemented service foundations

The package includes supplier ingestion and normalization adapters, BOM calculation/templates, pricing helpers, and a WooCommerce client.

Browser tools

Playwright-backed

Navigation, form filling, screenshots, extraction, and browser-session cleanup are implemented with Playwright and URL/file validation.

Permit, vendor, SEO, and agent tools

Inspect before use

Definitions and handlers exist, but some code paths use fallback, mocked, or staged integrations. Registration does not mean a downstream service is live.

Tenant and side-effect checks

The full server validates contractor access for its tenant-scoped RAG and material handlers. Review every other handler separately, especially tools that place orders, submit forms, update workflow state, or call external suppliers. Keep human approval around side effects until the complete path has been validated.