{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Quickstart"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"quickstart","__idx":0},"children":["Quickstart"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CDQ MCP"]}," is a Model Context Protocol server that gives AI assistants and agents access to CDQ business partner data. Any MCP-compatible client can connect to it to look up business partners by company name, address and identifiers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"server-url","__idx":1},"children":["Server URL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.cdq.com/mcp\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every tool runs on behalf of the authenticated user, so no organization, storage or workspace identifier needs to be passed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-tools","__idx":2},"children":["Available Tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tool names are grouped by product area with the prefix ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reference_data-"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reference_data-lookup_business_partners"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find candidate business partners by name, address parts and identifiers"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"typical-flow","__idx":3},"children":["Typical flow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reference_data-lookup_business_partners"]}," with a company name or an identifier, optionally narrowed by address parts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the slim matches: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cdqId"]},", name, address, identifiers, status, source of record and matching score."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To fetch more matches, pass the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nextStartAfter"]}," value of the result as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startAfter"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lookup results may include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warnings"]},", for example when a data source has no quota left. A warning qualifies the result and does not mean the search failed."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"External providers"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The lookup does not query Dun & Bradstreet or Bureau van Dijk, so it cannot answer a request for a DUNS number or a BvD ID."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":4},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server uses the OAuth 2.1 authorization flow defined by the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization"},"children":["MCP specification"]},". A request without a token is answered with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}," and a pointer to the server's OAuth metadata, so an MCP client that supports remote servers with OAuth sets up the connection by itself:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/mcp"]}," as a remote MCP server in your client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The client discovers the authorization server and registers itself."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A browser window opens; sign in with your CDQ account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The client receives an access token and refreshes it automatically."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"URL"},"children":["URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Protected resource metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/.well-known/oauth-protected-resource/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization server metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/.well-known/oauth-authorization-server/mcp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/mcp/authorize"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/mcp/token"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dynamic client registration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.cdq.com/mcp/register"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server supports the authorization code grant with PKCE (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S256"]},") and the refresh token grant."]}]},"headings":[{"value":"Quickstart","id":"quickstart","depth":1},{"value":"Server URL","id":"server-url","depth":2},{"value":"Available Tools","id":"available-tools","depth":2},{"value":"Typical flow","id":"typical-flow","depth":3},{"value":"Authentication","id":"authentication","depth":2}],"frontmatter":{"seo":{"title":"Quickstart"}},"lastModified":"2026-10-28T14:30:59.965Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/mcp/cdq-mcp/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}