{"items":[{"type":"link","label":"CDQ MCP","link":"/openapi/mcp/cdq-mcp/cdq-mcp-v1","routeSlug":"/openapi/mcp/cdq-mcp/cdq-mcp-v1","content":{"contentType":"overview","meta":{"name":"CDQ MCP"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"cdq-mcp-v1.json","url":"/_bundle/openapi/mcp/cdq-mcp/cdq-mcp-v1.json?download"},{"kind":"download","label":"cdq-mcp-v1.yaml","url":"/_bundle/openapi/mcp/cdq-mcp/cdq-mcp-v1.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"MCP server","titleTranslationKey":"mcp.title","children":[{"kind":"attribute","label":"Protocol version","labelTranslationKey":"mcp.protocolVersion","value":"2025-06-18","withCopyButton":true,"copyContent":"2025-06-18"},{"kind":"tags","title":"Capabilities","titleTranslationKey":"mcp.capabilities","tags":[{"text":"tools","color":"green","icon":"checkmark"}]},{"kind":"externallink","title":"Endpoint","titleTranslationKey":"mcp.endpoint","label":"https://api.cdq.com/mcp","url":"https://api.cdq.com/mcp","withCopyButton":true,"copyContent":"https://api.cdq.com/mcp"},{"kind":"connect-mcp-button","title":"Connect","actions":["mcp-cursor","mcp-vscode"],"mcpUrl":"https://api.cdq.com/mcp"}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"description":"Production","url":"https://api.cdq.com/mcp"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"CDQ MCP (1)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The CDQ MCP server gives AI assistants and agents access to CDQ business partner data through the Model Context Protocol. Any MCP-compatible client can connect to it to look up business partners by company name, address and identifiers. Tool names are grouped by product area with the prefix "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_data-"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Every tool runs on behalf of the authenticated user, so results are always scoped to that user's own organization and workspace."},"children":[]}]}]}]}],"sectionId":"/openapi/mcp/cdq-mcp/cdq-mcp-v1"}],"sectionId":"/openapi/mcp/cdq-mcp/cdq-mcp-v1"}]}]}},{"type":"group","label":"Reference Data","link":"/openapi/mcp/cdq-mcp/cdq-mcp-v1/reference-data","routeSlug":"/openapi/mcp/cdq-mcp/cdq-mcp-v1/reference-data","items":[{"type":"link","label":"Lookup business partners","link":"/openapi/mcp/cdq-mcp/cdq-mcp-v1/reference-data/reference_data-lookup_business_partners","routeSlug":"/openapi/mcp/cdq-mcp/cdq-mcp-v1/reference-data/reference_data-lookup_business_partners","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"Lookup business partners"},"meta":{"name":"reference_data-lookup_business_partners"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Lookup business partners","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"mcpTool","attributes":{"name":"reference_data-lookup_business_partners","id":"/openapi/mcp/cdq-mcp/cdq-mcp-v1/reference-data/reference_data-lookup_business_partners"},"children":[]}]}]}}],"content":{"contentType":"group","meta":{"name":"Reference Data"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reference Data","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"MCP Tools","titleTranslationKey":"openapi.mcp.tools","items":[{"title":"Lookup business partners","prefix":{"name":"tool","color":"tool"},"link":"/reference-data/reference_data-lookup_business_partners","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/BusinessPartnerLookupRequest":{"id":"components/schemas/BusinessPartnerLookupRequest","kind":"json-schema","title":"BusinessPartnerLookupRequest","data":{"type":"object","description":"Business partner lookup criteria. Requires companyName or identifiers; the address elements only narrow the search and cannot be one on their own.","properties":{"companyName":{"type":"string","description":"The legal or trading name of the company to look up, e.g. \"REFRIGERACAO DUFRIO COMERCIAL LTDA\"."},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. \"PL\"."},"street":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Street address (street name plus number if known), e.g. \"al. Jana Pawła II 6\"."},"children":[]}]}]}]},"city":{"type":"string","description":"City name, e.g. \"Jawor\"."},"postCode":{"type":"string","description":"Postal code, e.g. \"59-400\"."},"identifiers":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identifying numbers (VAT, PL_REG, DUNS, etc.), e.g. [{\"value\":\"1234567890\",\"type\":\"PL_NIP\"}]."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/IdentifierParam"}},"dataSources":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Restrict the search to specific data sources, given as ALEI prefixes, e.g. [\"BR.RF\"] or [\"PL.NOBR\",\"BR.RF\"]. An ALEI prefix is the part of a cdqId before the colon: a match with cdqId \"BR.RF:01754239004298\" comes from the \"BR.RF\" data source, so a prefix can be read off any earlier result. Omit this to search every data source the caller can access."},"children":[]}]}]}],"items":{"type":"string"}},"startAfter":{"type":"string","description":"Pagination cursor. Omit for the first page; pass the nextStartAfter value from the previous result to fetch the next page."},"limit":{"type":"integer","format":"int32","description":"Items per page, e.g. 5. Allowed range 1..50; defaults to 5 to keep response tokens small.","minimum":1,"maximum":50,"default":5}}}},"components/schemas/IdentifierParam":{"id":"components/schemas/IdentifierParam","kind":"json-schema","title":"IdentifierParam","data":{"type":"object","required":["value"],"properties":{"value":{"type":"string","description":"The identifier value, e.g. \"1234567890\"."},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identifier type technicalKey, e.g. \"PL_NIP\", \"PL_REG\", \"DUNS\". Omit it to search the value across all types; never ask the user for one."},"children":[]}]}]}]}}}},"components/schemas/BusinessPartnerLookupResult":{"id":"components/schemas/BusinessPartnerLookupResult","kind":"json-schema","title":"BusinessPartnerLookupResult","data":{"type":"object","properties":{"matches":{"type":"array","items":{"$ref":"#/components/schemas/BusinessPartnerLookupMatch"}},"limit":{"type":"integer"},"totalMatches":{"type":"integer"},"nextStartAfter":{"type":"string","description":"Cursor for the next page; pass it as startAfter."},"warnings":{"type":"array","nullable":true,"items":{"$ref":"#/components/schemas/LookupWarning"}}}}},"components/schemas/LookupWarning":{"id":"components/schemas/LookupWarning","kind":"json-schema","title":"LookupWarning","data":{"type":"object","properties":{"severity":{"type":"string","example":"warning"},"message":{"type":"string","example":"CREFO.SSU: There is no more quota left for this data source."}}}},"components/schemas/BusinessPartnerLookupMatch":{"id":"components/schemas/BusinessPartnerLookupMatch","kind":"json-schema","title":"BusinessPartnerLookupMatch","data":{"type":"object","properties":{"cdqId":{"type":"string","example":"CH.CR:1206654L"},"nameLocal":{"type":"string","example":"CDQ AG"},"addressString":{"type":"string","example":"Switzerland, St. Gallen, Lukasstrasse 4"},"externalId":{"type":"string","example":"1206654"},"identifiers":{"type":"array","items":{"$ref":"#/components/schemas/Identifier"}},"status":{"type":"string","example":"Active"},"lastSyncDate":{"type":"string"},"dataSourceTechnicalKey":{"type":"string","example":"CH.CR"},"dataSourceName":{"type":"string","example":"Swiss commercial register"},"matchingScore":{"type":"number","format":"double","minimum":0,"maximum":1}}}},"components/schemas/Identifier":{"id":"components/schemas/Identifier","kind":"json-schema","title":"Identifier","data":{"type":"object","properties":{"value":{"type":"string","example":"CHE218608886"},"type":{"type":"string","example":"CH_UID"}}}}},"exampleStore":{},"securitySchemeStore":{"apiKey":{"id":"apiKey","type":"apiKey","in":"header","paramName":"X-API-KEY"}},"mcp":{"protocolVersion":"2025-06-18","servers":[{"url":"https://api.cdq.com/mcp"}],"capabilities":{"tools":{"listChanged":true}},"tools":[{"name":"reference_data-lookup_business_partners","title":"Lookup business partners","tags":["Reference Data"],"description":"**When:** the user wants to find candidate business partners by any combination of company name, address parts and identifiers (VAT, PL_REG, etc.) — including by an identifier alone.\n\n**What it returns:** a paginated list of slim matches. Each match carries:\n\n- `cdqId`, local-language name, a composed address string and external id\n- identifiers (VAT, PL_REG, ...) as `{value, type}` pairs\n- status and source-of-record identity (`technicalKey` + name)\n- a matching score\n\nIt may also return **warnings**: notices the search made about itself, each with a severity and a plain-language message, most often saying that some of the data the search was asked to cover is not enabled for the caller's organization. A warning qualifies the result and never means the search failed — relay it to the user when it explains a short or empty list of matches, along with whatever its message asks them to do.\n\n**What it does not do:**\n\n- It does **not** query Dun & Bradstreet or Bureau van Dijk, so it cannot answer a request for a DUNS number or a BvD ID.\n- It does **not** return full business partner details (no bank accounts, relations, classifications, raw SAP record, etc.), only the slim matches above.\n","inputSchema":{"$ref":"#/components/schemas/BusinessPartnerLookupRequest"},"outputSchema":{"$ref":"#/components/schemas/BusinessPartnerLookupResult"},"security":[{"OAuth2":[]}]}],"resources":[]},"servers":[{"url":"https://api.cdq.com/mcp","description":"Production"}],"specType":"openapi"},"options":{"hideDownloadButtons":false,"codeSamples":{"languages":[]},"feedback":{"type":"sentiment","settings":{"label":"Share the feedback!","submitText":"Thank you for sharing!","reasons":{"component":"checkbox","label":"Tell us more about your experience.","items":["Content covered the topic well.","The content has great examples.","The content is thoroughly detailed.","The content is easy to understand."]},"comment":{"likeLabel":"What was most helpful?","dislikeLabel":"What can we improve?"}}},"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi/mcp/cdq-mcp/cdq-mcp-v1.json?download"},{"url":"/_bundle/openapi/mcp/cdq-mcp/cdq-mcp-v1.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"CDQ MCP","description":"The CDQ MCP server gives AI assistants and agents access to CDQ business partner data through the Model Context Protocol. Any MCP-compatible client can connect to it to look up business partners by company name, address and identifiers. Tool names are grouped by product area with the prefix `reference_data-`. Every tool runs on behalf of the authenticated user, so results are always scoped to that user's own organization and workspace."}},"baseSlug":"/openapi/mcp/cdq-mcp/cdq-mcp-v1","routesMapping":{}}