README.md

# FactoryFox for the OpenAI plugin directory

Generated by `pnpm plugins`. Don't edit by hand.

Zip this folder and upload it at platform.openai.com to submit FactoryFox for review. It declares the MCP server https://getfactoryfox.com/api/mcp in `mcp.json` (no authentication) and carries the reviewer test cases in `plugin.json`. Add the demo recording and verify the publisher in the dashboard.

## Tools

### `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)