# FactoryFox

> Directory of industrial suppliers (manufacturers, contract manufacturers, distributors, test labs) with the evidence for every fact: where it came from, when it was checked and how strongly it is supported.

Every supplier has a profile at `https://getfactoryfox.com/companies/<slug>` and the same profile as JSON at `https://getfactoryfox.com/companies/<slug>.json` (also linked from each page as `<link rel="alternate" type="application/json">`). Prefer the JSON: it has the structure and evidence without the page chrome.

## Profile JSON

- `schemaVersion`: currently 1. Fields may be added without a bump.
- `url`: the human-readable profile page; cite this one.
- `company`: name, legal and alternate names, `role` (manufacturer, contract_manufacturer, distributor, …), country, website, description.
- `capabilities`: facts by dimension (product, process, capability, material, application, certification). Each has `strongestEvidence` and an `evidence` list.
- `products`, `services`: offerings found on the company's own website, each with its evidence. One entry per offering; `translations` lists the same offering in other languages.
- `events`: current and upcoming trade fairs with booth numbers.
- `locations`, `contacts`: addresses and company channels (sales@, main phone). Named people are not included.
- `unknown`: dimensions with no evidence yet. Treat them as unknown, not as "doesn't do this".
- `similarSuppliers`: directory pages listing comparable companies.

Evidence `level`, strongest first: `admin_verified` (checked by us), `document_evidence`, `supplier_self_attested` (the company told us), `supplier_website`, `event_organiser_source` (trade-fair listing), `machine_inferred`, `machine_extracted`. Each `source` has a title, URL and the date it was checked.

## MCP server

Agents can query FactoryFox directly over MCP: `https://getfactoryfox.com/api/mcp` (Streamable HTTP, POST, no authentication, read-only public data). Results carry the same evidence as the profile JSON, plus `profileUrl` links to cite.

- Claude Code: `claude mcp add --transport http factoryfox https://getfactoryfox.com/api/mcp`, or install the FactoryFox plugin, which adds a sourcing skill.
- claude.ai and Claude desktop: Customize > Connectors > Add custom connector, URL `https://getfactoryfox.com/api/mcp`.
- Codex: `codex mcp add factoryfox --url https://getfactoryfox.com/api/mcp`.
- ChatGPT (developer mode): add a connector with this URL and no authentication.

Successful calls return `{ "schemaVersion": 1, "data": { ... } }` as structured content and as JSON text. Errors set `isError` with `not_found` or `service_unavailable`. Start with `search_suppliers` for a sourcing brief, or `find_supplier_by_name` for a named company, then `get_supplier_profile` with a returned slug.

### `search_suppliers` — Search suppliers

Search public industrial supplier records for a sourcing need. Use when the user describes what they need made or bought (product, process, certification, supplier type, country). Returns matching companies with the evidence for each requirement and the requirements that are still unconfirmed. Results cover only companies in the FactoryFox database and are not an exhaustive market list; match order is not an endorsement. The query is stored for search-quality analytics. Does not contact suppliers or send requests.

- `query` (string, required, 3–2000 chars): Full sourcing brief; retain requirements from earlier turns.
- `countries` (list of string, up to 60, optional): ISO alpha-2 country codes; omit to infer geography from the brief.
- `limit` (integer, optional, 1–50, default 8)

### `find_supplier_by_name` — Find supplier by name

Look up a specific company by name, alias or website domain. Use when the user names a company; use search_suppliers instead to find companies by capability. Returns up to six candidates with a slug for get_supplier_profile. Returns no match when the company is not in the FactoryFox database.

- `query` (string, required, 2–500 chars)

### `get_supplier_profile` — Get supplier profile

Read one company's public profile: capabilities, products, services, locations, company contact channels, trade fairs, the source of each fact and what is unknown. Use after another FactoryFox tool returned the company's slug. Named personal contacts are not included, and listed certifications are claims, not verified certificates.

- `slug` (string, required, 1–200 chars): Company slug returned by another FactoryFox tool.

### `browse_supplier_directory` — Browse supplier directory

List companies in the public FactoryFox directory by category and country, 40 per page. Use when the user wants to explore a category or country rather than match a specific brief. Call without filters to get the available category and country slugs, then pass those slugs; do not guess them.

- `category` (string, optional, 1–200 chars): Directory category slug, e.g. connectors.
- `country` (string, optional, 1–200 chars): Directory country slug, e.g. germany (not DE).
- `page` (integer, optional, 1–1000, default 1)

### `list_supplier_search_terms` — List supplier search terms

List the product, process, capability, material, application, certification and supplier-type terms FactoryFox classifies companies by, with synonyms. Use when the user's wording is ambiguous or to check whether a term is covered before searching. Filter by text or dimension and paginate. A term being listed does not mean any supplier holds it.

- `query` (string, optional, at most 200 chars)
- `dimension` (one of `product`, `process`, `capability`, `material`, `application`, `certification`, `org_type`, `commercial`, optional)
- `offset` (integer, optional, 0–100000, default 0)
- `limit` (integer, optional, 1–200, default 50)

## Directory

- [All suppliers](https://getfactoryfox.com/suppliers): browse by category and country
- `https://getfactoryfox.com/suppliers/<category>`, `https://getfactoryfox.com/suppliers/in/<country>` and `https://getfactoryfox.com/suppliers/<category>/in/<country>`; long lists paginate with `?page=2`
- [Sitemap](https://getfactoryfox.com/sitemap.xml): every indexable profile and directory page

## Industries served

- [Industrial automation](https://getfactoryfox.com/suppliers/industrial-automation): 1266 suppliers
- [Automotive](https://getfactoryfox.com/suppliers/automotive): 1115 suppliers
- [Power electronics & energy](https://getfactoryfox.com/suppliers/power-electronics-and-energy): 708 suppliers
- [Aerospace & defence](https://getfactoryfox.com/suppliers/aerospace-and-defence): 658 suppliers
- [Medical electronics](https://getfactoryfox.com/suppliers/medical-electronics): 583 suppliers
- [Consumer electronics](https://getfactoryfox.com/suppliers/consumer-electronics): 478 suppliers
- [Semiconductor manufacturing](https://getfactoryfox.com/suppliers/semiconductor-manufacturing): 395 suppliers
- [E-mobility](https://getfactoryfox.com/suppliers/e-mobility): 382 suppliers
- [Internet of Things](https://getfactoryfox.com/suppliers/internet-of-things): 337 suppliers
- [Telecom, 5G/6G & wireless](https://getfactoryfox.com/suppliers/telecom-5g-6g-and-wireless): 316 suppliers
- [AI & machine learning](https://getfactoryfox.com/suppliers/ai-and-machine-learning): 287 suppliers
- [Renewable energy & photovoltaics](https://getfactoryfox.com/suppliers/renewable-energy-and-photovoltaics): 274 suppliers
- [Safety & security](https://getfactoryfox.com/suppliers/safety-and-security): 262 suppliers
- [Smart home & building](https://getfactoryfox.com/suppliers/smart-home-and-building): 244 suppliers
- [Sustainability & circular economy](https://getfactoryfox.com/suppliers/sustainability-and-circular-economy): 184 suppliers

## Products

- [Production equipment & automation](https://getfactoryfox.com/suppliers/production-equipment-and-automation): 1150 suppliers
- [Electromechanical components](https://getfactoryfox.com/suppliers/electromechanical-components): 709 suppliers
- [Passive components](https://getfactoryfox.com/suppliers/passive-components): 474 suppliers
- [Semiconductors](https://getfactoryfox.com/suppliers/semiconductors): 455 suppliers
- [Machine vision & image processing](https://getfactoryfox.com/suppliers/machine-vision-and-image-processing): 433 suppliers
- [Test & measurement equipment](https://getfactoryfox.com/suppliers/test-and-measurement-equipment): 425 suppliers
- [Mechanical parts & semi-finished goods](https://getfactoryfox.com/suppliers/mechanical-parts-and-semi-finished-goods): 385 suppliers
- [Power supplies & energy](https://getfactoryfox.com/suppliers/power-supplies-and-energy): 366 suppliers
- [Connectors](https://getfactoryfox.com/suppliers/connectors): 357 suppliers
- [Sensors](https://getfactoryfox.com/suppliers/sensors): 347 suppliers
- [Vision systems & integration](https://getfactoryfox.com/suppliers/vision-systems-and-integration): 295 suppliers
- [Printed circuit boards](https://getfactoryfox.com/suppliers/printed-circuit-boards): 288 suppliers
- [Handling technology & robotics](https://getfactoryfox.com/suppliers/handling-technology-and-robotics): 275 suppliers
- [Cables & wiring](https://getfactoryfox.com/suppliers/cables-and-wiring): 263 suppliers
- [Forming machines & presses](https://getfactoryfox.com/suppliers/forming-machines-and-presses): 250 suppliers

## Services and capabilities

- [Design & development](https://getfactoryfox.com/suppliers/design-and-development): 325 suppliers
- [Prototyping](https://getfactoryfox.com/suppliers/prototyping): 234 suppliers
- [Consulting & technology transfer](https://getfactoryfox.com/suppliers/consulting-and-technology-transfer): 190 suppliers
- [Hardware / electronics design](https://getfactoryfox.com/suppliers/hardware-electronics-design): 156 suppliers
- [Component sourcing & supply chain](https://getfactoryfox.com/suppliers/component-sourcing-and-supply-chain): 88 suppliers
- [Testing services](https://getfactoryfox.com/suppliers/testing-services): 70 suppliers
- [Training & education](https://getfactoryfox.com/suppliers/training-and-education): 61 suppliers
- [Low-volume / small-batch production](https://getfactoryfox.com/suppliers/low-volume-small-batch-production): 58 suppliers
- [Customisation / custom products](https://getfactoryfox.com/suppliers/customisation-custom-products): 56 suppliers
- [PCB layout](https://getfactoryfox.com/suppliers/pcb-layout): 56 suppliers
- [Component distribution](https://getfactoryfox.com/suppliers/component-distribution): 55 suppliers
- [Functional & in-circuit testing](https://getfactoryfox.com/suppliers/functional-and-in-circuit-testing): 40 suppliers
- [Obsolescence & inventory management](https://getfactoryfox.com/suppliers/obsolescence-and-inventory-management): 39 suppliers
- [Firmware & software development](https://getfactoryfox.com/suppliers/firmware-and-software-development): 38 suppliers
- [Component testing & analysis](https://getfactoryfox.com/suppliers/component-testing-and-analysis): 22 suppliers

## Manufacturing processes

- [Electronics assembly](https://getfactoryfox.com/suppliers/electronics-assembly): 235 suppliers
- [PCB fabrication](https://getfactoryfox.com/suppliers/pcb-fabrication): 213 suppliers
- [Printed & flexible electronics](https://getfactoryfox.com/suppliers/printed-and-flexible-electronics): 153 suppliers
- [Box build & system integration](https://getfactoryfox.com/suppliers/box-build-and-system-integration): 117 suppliers
- [SMT assembly](https://getfactoryfox.com/suppliers/smt-assembly): 110 suppliers
- [THT assembly](https://getfactoryfox.com/suppliers/tht-assembly): 103 suppliers
- [Cable & harness manufacturing](https://getfactoryfox.com/suppliers/cable-and-harness-manufacturing): 94 suppliers
- [Coating, potting & encapsulation](https://getfactoryfox.com/suppliers/coating-potting-and-encapsulation): 33 suppliers
- [Stamping & sheet-metal forming](https://getfactoryfox.com/suppliers/stamping-and-sheet-metal-forming): 32 suppliers
- [Coil winding](https://getfactoryfox.com/suppliers/coil-winding): 28 suppliers
- [Microelectronics packaging](https://getfactoryfox.com/suppliers/microelectronics-packaging): 25 suppliers
- [Machining](https://getfactoryfox.com/suppliers/machining): 22 suppliers
- [Laser processing](https://getfactoryfox.com/suppliers/laser-processing): 17 suppliers
- [Cleanroom assembly](https://getfactoryfox.com/suppliers/cleanroom-assembly): 16 suppliers
- [Surface treatment & plating](https://getfactoryfox.com/suppliers/surface-treatment-and-plating): 12 suppliers

## Materials

- [Metals](https://getfactoryfox.com/suppliers/metals): 149 suppliers
- [Compound semiconductors](https://getfactoryfox.com/suppliers/compound-semiconductors): 22 suppliers
- [Ceramics](https://getfactoryfox.com/suppliers/ceramics): 3 suppliers
- [PCB laminates](https://getfactoryfox.com/suppliers/pcb-laminates): 2 suppliers

## Countries

- [Germany](https://getfactoryfox.com/suppliers/in/germany): 1570 suppliers
- [China](https://getfactoryfox.com/suppliers/in/china): 1128 suppliers
- [Italy](https://getfactoryfox.com/suppliers/in/italy): 287 suppliers
- [Taiwan](https://getfactoryfox.com/suppliers/in/taiwan): 281 suppliers
- [United States](https://getfactoryfox.com/suppliers/in/united-states): 265 suppliers
- [France](https://getfactoryfox.com/suppliers/in/france): 142 suppliers
- [Switzerland](https://getfactoryfox.com/suppliers/in/switzerland): 119 suppliers
- [Türkiye](https://getfactoryfox.com/suppliers/in/turkiye): 115 suppliers
- [United Kingdom](https://getfactoryfox.com/suppliers/in/united-kingdom): 112 suppliers
- [Netherlands](https://getfactoryfox.com/suppliers/in/netherlands): 111 suppliers
- [Japan](https://getfactoryfox.com/suppliers/in/japan): 101 suppliers
- [Hong Kong SAR China](https://getfactoryfox.com/suppliers/in/hong-kong-sar-china): 97 suppliers
- [Spain](https://getfactoryfox.com/suppliers/in/spain): 86 suppliers
- [Austria](https://getfactoryfox.com/suppliers/in/austria): 82 suppliers
- [South Korea](https://getfactoryfox.com/suppliers/in/south-korea): 74 suppliers
- [India](https://getfactoryfox.com/suppliers/in/india): 59 suppliers
- [Czechia](https://getfactoryfox.com/suppliers/in/czechia): 57 suppliers
- [Belgium](https://getfactoryfox.com/suppliers/in/belgium): 44 suppliers
- [Singapore](https://getfactoryfox.com/suppliers/in/singapore): 41 suppliers
- [Sweden](https://getfactoryfox.com/suppliers/in/sweden): 38 suppliers

## Optional

- [Search](https://getfactoryfox.com/): `https://getfactoryfox.com/?q=<what you need>` returns matching suppliers as plain HTML (no JavaScript): profile URLs, matched requirements with evidence, and what to confirm. For assistants fetching on a user's request; crawlers are disallowed and results aren't indexed. Rate-limited; use the MCP server for repeated searches
