CNC Compass
Search reviewed Chinese CNC machining suppliers, with each fact linked to its source page.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"suppliers": {
"url": "https://cnccompass.com/mcp"
}
}
}Remote endpoints
https://cnccompass.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢search_suppliers(query, limit, offset, material, process, ...)
Search published CNC Compass supplier records with a natural-language sourcing brief. Returns the normalized brief, the fields the brief did not state, matched suppliers with match reasons and source evidence, the filters applied with record counts, and paging fields (offset, limit, has_more). A brief with no recognisable process, material, finish, or location returns no records and a follow-up question instead of the whole index. `query` is 3 to 5000 characters, `limit` 1 to 20, `offset` 0 to 1000. When you already know the buyer's material, process, finish, or location, pass them as the optional fields: each overrides the parsed value (for example material="aluminum 6061", process="CNC turning", finish="anodizing", location="Dongguan"); a value the index cannot match is ignored and listed in `retrieval.ignored_fields`.
Input Schema
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"limit": {
"default": 5,
"title": "Limit",
"type": "integer"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Material"
},
"process": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Process"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Finish"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
}
},
"required": [
"query"
],
"title": "search_suppliersArguments"
}Output Schema
{
"type": "object",
"properties": {
"answer": {
"title": "Answer",
"type": "string"
},
"brief": {
"$ref": "#/$defs/SearchBrief"
},
"missing": {
"items": {
"type": "string"
},
"title": "Missing",
"type": "array"
},
"follow_up_question": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Follow Up Question"
},
"suppliers": {
"items": {
"$ref": "#/$defs/SupplierHit"
},
"title": "Suppliers",
"type": "array"
},
"filters": {
"items": {
"$ref": "#/$defs/AppliedFilter"
},
"title": "Filters",
"type": "array"
},
"offset": {
"default": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"default": 5,
"title": "Limit",
"type": "integer"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"total_records": {
"default": 0,
"title": "Total Records",
"type": "integer"
},
"index_records": {
"default": 0,
"title": "Index Records",
"type": "integer"
},
"retrieval": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"title": "Retrieval",
"type": "object"
}
},
"required": [
"answer",
"brief"
],
"$defs": {
"AppliedFilter": {
"description": "One brief field used to filter records, with how many index records declare it.",
"properties": {
"field": {
"title": "Field",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"keys": {
"items": {
"type": "string"
},
"title": "Keys",
"type": "array"
},
"records": {
"default": 0,
"title": "Records",
"type": "integer"
}
},
"required": [
"field",
"label"
],
"title": "AppliedFilter",
"type": "object"
},
"Evidence": {
"properties": {
"label": {
"title": "Label",
"type": "string"
},
"quote": {
"title": "Quote",
"type": "string"
},
"source_url": {
"default": "",
"title": "Source Url",
"type": "string"
}
},
"required": [
"label",
"quote"
],
"title": "Evidence",
"type": "object"
},
"SearchBrief": {
"properties": {
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Material"
},
"process": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Process"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Finish"
},
"tolerance": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Tolerance"
},
"quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Quantity"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
}
},
"title": "SearchBrief",
"type": "object"
},
"SupplierHit": {
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"location": {
"default": "",
"title": "Location",
"type": "string"
},
"score": {
"title": "Score",
"type": "number"
},
"match_reasons": {
"items": {
"type": "string"
},
"title": "Match Reasons",
"type": "array"
},
"matched_fields": {
"items": {
"type": "string"
},
"title": "Matched Fields",
"type": "array"
},
"website_url": {
"default": "",
"title": "Website Url",
"type": "string"
},
"website_kind": {
"default": "",
"title": "Website Kind",
"type": "string"
},
"factory_verification": {
"default": "",
"title": "Factory Verification",
"type": "string"
},
"inquiry_url": {
"default": "",
"title": "Inquiry Url",
"type": "string"
},
"evidence": {
"items": {
"$ref": "#/$defs/Evidence"
},
"title": "Evidence",
"type": "array"
}
},
"required": [
"slug",
"name",
"score"
],
"title": "SupplierHit",
"type": "object"
}
},
"title": "SearchResponse"
}🟢get_supplier(slug)
Return one published supplier record in full, by the `slug` from search_suppliers results. Includes identity (legal name, Chinese registered name when a registry lookup confirmed it, location, business type, founded year, employee range), the official website or source listing, the Made-in-China.com inquiry form when there is one, capabilities (processes, materials, certifications, equipment, industries, tolerance, maximum part size) and the facet keys search_suppliers matches, certificates, product families, facilities and news items with their own source pages, the listings the record was read from with permission basis and check date, and field-level evidence (the quote, page, extraction method, and review status behind each claim). `buyer_facts.checked` lists what CNC Compass confirmed (registry review, source factory, certificates on China's national register, a named third-party audit); `buyer_facts.profile` is what the supplier publishes about itself (tolerance, inspection, lead time, MOQ, Incoterms, payment terms, ...), each item with its quote and source page: present it as the supplier's statement, to be confirmed at quotation. `verification_status`, `factory_verification` ("Verified source factory" or empty) and `last_verified_at` report editorial review. An unknown slug is a tool error.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_supplier_toolArguments"
}Output Schema
{
"type": "object",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"legal_name": {
"default": "",
"title": "Legal Name",
"type": "string"
},
"chinese_legal_name": {
"default": "",
"title": "Chinese Legal Name",
"type": "string"
},
"summary": {
"default": "",
"title": "Summary",
"type": "string"
},
"location": {
"default": "",
"title": "Location",
"type": "string"
},
"country_code": {
"default": "",
"title": "Country Code",
"type": "string"
},
"business_type": {
"default": "",
"title": "Business Type",
"type": "string"
},
"founded_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Founded Year"
},
"employee_range": {
"default": "",
"title": "Employee Range",
"type": "string"
},
"page_url": {
"default": "",
"title": "Page Url",
"type": "string"
},
"website_url": {
"default": "",
"title": "Website Url",
"type": "string"
},
"website_kind": {
"default": "",
"title": "Website Kind",
"type": "string"
},
"inquiry_url": {
"default": "",
"title": "Inquiry Url",
"type": "string"
},
"verification_status": {
"default": "",
"title": "Verification Status",
"type": "string"
},
"factory_verification": {
"default": "",
"title": "Factory Verification",
"type": "string"
},
"last_verified_at": {
"default": "",
"title": "Last Verified At",
"type": "string"
},
"processes": {
"items": {
"type": "string"
},
"title": "Processes",
"type": "array"
},
"materials": {
"items": {
"type": "string"
},
"title": "Materials",
"type": "array"
},
"certifications": {
"items": {
"type": "string"
},
"title": "Certifications",
"type": "array"
},
"equipment": {
"items": {
"type": "string"
},
"title": "Equipment",
"type": "array"
},
"industries": {
"items": {
"type": "string"
},
"title": "Industries",
"type": "array"
},
"tolerance": {
"default": "",
"title": "Tolerance",
"type": "string"
},
"maximum_part_size": {
"default": "",
"title": "Maximum Part Size",
"type": "string"
},
"facets": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"title": "Facets",
"type": "object"
},
"certificates": {
"items": {
"$ref": "#/$defs/CertificateItem"
},
"title": "Certificates",
"type": "array"
},
"products": {
"items": {
"$ref": "#/$defs/LinkedItem"
},
"title": "Products",
"type": "array"
},
"facilities": {
"items": {
"$ref": "#/$defs/LinkedItem"
},
"title": "Facilities",
"type": "array"
},
"news": {
"items": {
"$ref": "#/$defs/LinkedItem"
},
"title": "News",
"type": "array"
},
"sources": {
"items": {
"$ref": "#/$defs/SourceListing"
},
"title": "Sources",
"type": "array"
},
"evidence": {
"items": {
"$ref": "#/$defs/FieldEvidence"
},
"title": "Evidence",
"type": "array"
},
"buyer_facts": {
"additionalProperties": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"title": "Buyer Facts",
"type": "object"
}
},
"required": [
"slug",
"name"
],
"$defs": {
"CertificateItem": {
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"reference_no": {
"default": "",
"title": "Reference No",
"type": "string"
},
"platform_verification": {
"default": "",
"title": "Platform Verification",
"type": "string"
},
"verification_status": {
"default": "",
"title": "Verification Status",
"type": "string"
},
"source_url": {
"default": "",
"title": "Source Url",
"type": "string"
}
},
"required": [
"name"
],
"title": "CertificateItem",
"type": "object"
},
"FieldEvidence": {
"description": "One extracted claim and where it was read, as recorded on the supplier record.",
"properties": {
"field": {
"title": "Field",
"type": "string"
},
"value": {
"default": "",
"title": "Value",
"type": "string"
},
"quote": {
"default": "",
"title": "Quote",
"type": "string"
},
"source_url": {
"default": "",
"title": "Source Url",
"type": "string"
},
"method": {
"default": "",
"title": "Method",
"type": "string"
},
"observed_at": {
"default": "",
"title": "Observed At",
"type": "string"
},
"review_status": {
"default": "",
"title": "Review Status",
"type": "string"
}
},
"required": [
"field"
],
"title": "FieldEvidence",
"type": "object"
},
"LinkedItem": {
"description": "A product family, facility, or news item linked to the supplier, each with its own source page.",
"properties": {
"name": {
"title": "Name",
"type": "string"
},
"kind": {
"default": "",
"title": "Kind",
"type": "string"
},
"summary": {
"default": "",
"title": "Summary",
"type": "string"
},
"date": {
"default": "",
"title": "Date",
"type": "string"
},
"source_url": {
"default": "",
"title": "Source Url",
"type": "string"
}
},
"required": [
"name"
],
"title": "LinkedItem",
"type": "object"
},
"SourceListing": {
"description": "A page the record was read from: the marketplace listing or the supplier's own site.",
"properties": {
"title": {
"default": "",
"title": "Title",
"type": "string"
},
"source_name": {
"default": "",
"title": "Source Name",
"type": "string"
},
"source_url": {
"default": "",
"title": "Source Url",
"type": "string"
},
"permission_basis": {
"default": "",
"title": "Permission Basis",
"type": "string"
},
"last_checked_at": {
"default": "",
"title": "Last Checked At",
"type": "string"
}
},
"title": "SourceListing",
"type": "object"
}
},
"title": "SupplierDetail"
}🟢list_facets(field)
List the values search_suppliers can filter on, with how many published suppliers declare each. Fields are process, material, finish, and location; pass `field` for one of them. Each value has a stable `key`, a display `label`, a `records` count, and `implies` (broader keys a narrower one also matches, such as aluminum-6061 implying aluminum). Pass a label or key as the matching optional argument of search_suppliers. Locations are the city and province words that at least three supplier addresses share, most common first; `omitted_values` counts the rarer ones, which search_suppliers still matches. `index_records` is the number of published suppliers.
Input Schema
{
"type": "object",
"properties": {
"field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Field"
}
},
"title": "list_facetsArguments"
}Output Schema
{
"type": "object",
"properties": {
"fields": {
"items": {
"$ref": "#/$defs/FacetField"
},
"title": "Fields",
"type": "array"
},
"index_records": {
"default": 0,
"title": "Index Records",
"type": "integer"
}
},
"$defs": {
"FacetField": {
"properties": {
"field": {
"title": "Field",
"type": "string"
},
"values": {
"items": {
"$ref": "#/$defs/FacetValue"
},
"title": "Values",
"type": "array"
},
"omitted_values": {
"default": 0,
"title": "Omitted Values",
"type": "integer"
}
},
"required": [
"field"
],
"title": "FacetField",
"type": "object"
},
"FacetValue": {
"properties": {
"key": {
"title": "Key",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
},
"records": {
"default": 0,
"title": "Records",
"type": "integer"
},
"implies": {
"items": {
"type": "string"
},
"title": "Implies",
"type": "array"
}
},
"required": [
"key",
"label"
],
"title": "FacetValue",
"type": "object"
}
},
"title": "FacetsResponse"
}Community
Evidence