canonical: https://jentic.com/apis/cnccompass.com/cnccompass # CNC Compass Search API The CNC Compass Search API searches a directory of CNC machining and manufacturing suppliers and returns their profiles. It is public and read-only: a caller sends a query and gets back matching suppliers with their facts. The same search can be issued as a URL query string or as a structured JSON request body, and the facts in each result are also published as static pages with JSON-LD. An optional API key raises the per-IP rate quota for callers that need more throughput. ## For AI agents Search a directory of CNC machining and manufacturing suppliers and read their profiles, using either a query string or a structured JSON request. Read-only, with an optional API key to raise the rate quota. ## Scope Does not place orders, request quotes, or manage supplier contracts. Use for searching the CNC Compass supplier directory only. ## Capabilities - Search a directory of CNC machining and manufacturing suppliers - Send the same search as a URL query string or as a structured JSON request body - Read supplier result facts that are mirrored as static pages with JSON-LD ## Use cases ### Agent-Driven Supplier Discovery Through Jentic An AI agent sourcing a manufacturing job can search the CNC Compass directory through Jentic instead of integrating the API by hand. The agent sends the requirements as a query, reads the matching suppliers and their facts, and hands the shortlist to the next step. Because the API is read-only and exposes a single search, the agent's reach is simple to bound. Example prompt: Search the supplier directory for a machining requirement and return the top matching suppliers with their facts ### Sourcing Candidate Manufacturing Suppliers A procurement workflow can query the directory to build a shortlist of suppliers for a part. Sending the query as a structured JSON body lets the workflow express its requirements precisely and read back the suppliers that match. Example prompt: Submit a structured JSON search for suppliers matching a requirement and collect the returned candidates ### Enriching a Part Request With Supplier Options When a part request comes in, a service can query CNC Compass to attach candidate suppliers to it. The static JSON-LD pages behind each result mean the supplier facts can also be fetched and cited directly, keeping the enrichment verifiable. Example prompt: Take an incoming part requirement, query the directory for suppliers that match, and attach the candidates to the request ## Key resources - **Supplier Search** — Search CNC machining and manufacturing suppliers via a query string or a JSON request body and read matching supplier facts ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 59 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 64 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 40 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 75 / 100 - **View full report:** https://jentic.com/apis/cnccompass.com/cnccompass/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the CNC Compass Search API by hand means deciding whether to pass an optional key in the X-Api-Key header to raise your rate quota and choosing between the query-string and JSON-body search forms. Through Jentic you install once, import CNC Compass from the API Directory, store the optional key once, and your agent calls it. - **Permission scoping:** The CNC Compass Search API is read-only and carries your query in the request, so a rule bounds which operations your agent may call, not which supplier it can see. Limit the agent to the search operation and it can look up suppliers and reach nothing else through the same binding. - **Credential handling:** Your optional CNC Compass key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as find a CNC machining supplier, and Jentic returns the CNC Compass search operation with its input schema so the agent sends the query without reading the reference docs. ## Related APIs - **Crunchbase** — A searchable company directory, though general-business rather than CNC-specialized. - **People Data Labs** — Company and person data lookup across industries, not specific to manufacturing. - **Clearbit** — Enriches a found supplier company with firmographic and technographic data. ## FAQ ### What authentication does the CNC Compass Search API use? The API is public and read-only, so search works without credentials. An optional API key in the X-Api-Key header raises your rate quota, per the OpenAPI spec. Through Jentic that optional key is stored encrypted by your own Jentic One instance and injected at call time. ### What can I search for with the CNC Compass Search API? The search operation returns CNC machining and manufacturing suppliers that match your query. You can send the query as a URL query string with the GET form or as a structured JSON body with the POST form, and the facts in each result are also published as static pages with JSON-LD. ### What are the rate limits for the CNC Compass Search API? Anonymous calls are rate limited per IP address, and adding the optional API key raises the quota, per the API's own notes. The spec does not state exact numbers; check the vendor documentation at https://cnccompass.com for current limits. ### How do I find suppliers with the CNC Compass Search API through Jentic? Install Jentic One, then import CNC Compass from the API Directory. Your agent searches by intent such as find a CNC machining supplier, and Jentic returns the search operation with its input schema so the agent sends the query and reads the matching suppliers back. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there an MCP server for the CNC Compass Search API? Yes, CNC Compass exposes the same supplier search as an MCP tool. You can also connect it directly through Jentic: import the search API from the Directory, store your optional key once, and your agent calls the search operation on demand without loading another server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the CNC Compass Search API? Yes. The API is read-only and exposes a supplier search, so a rule that allows the search operation lets your agent look up suppliers and reach nothing else through the same binding. Every call it makes is logged.