Get Connected in Minutes
You'll need Dun & Bradstreet credentials. If you don't already have them, get access here.
- Get your credentials from the Get MCP Access page.
- Choose your platform below.
- Copy the MCP configuration into your tool's settings.
- Authenticate with your D&B credentials when prompted.
- Verify the connection with a test prompt.
Connector Setup: Claude Code
1. Set credentials in your shell
Before connecting, ensure your D&B Direct+ API credentials are available in your environment.
export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"
2. Add the MCP server
Register the D&B Direct+ MCP server with your Claude Code client using the transport protocol.
claude mcp add --transport http \
--client-id "$CLIENT_ID" \
--client-secret \
--callback-port 8080 \
dnb-directplus https://plus.dnb.com/v2/mcp
The CLI may prompt you interactively to store these credentials securely in your system's keychain.
3. Verify the server was added
Confirm that the server is successfully registered and available in your active configuration.
claude mcp list
claude mcp get dnb-directplus
Connector Setup: Claude Desktop
1. Locate configuration file
Open your Claude Desktop configuration file. You can find this in the app settings under "Developer".
2. Add the MCP server
Add the D&B Direct+ server URL configuration to your claude_desktop_config.json file.
{
"mcpServers": {
"dnb-directplus": {
"url": "https://plus.dnb.com/v2/mcp"
}
}
}
3. Restart Claude Desktop
Fully close and restart Claude Desktop to load the new MCP server.
Connector Setup: Cursor
1. Open Cursor settings
Navigate to Settings (Gear Icon) > Features > MCP Servers.
2. Add new server
Click "+ Add new MCP server". Set the type to SSE (or HTTP), name it dnb-directplus, and use the URL below.
https://plus.dnb.com/v2/mcp
3. Refresh servers
Click the refresh icon next to your new MCP server to initialize it.
Connector Setup: Codex
1. Locate configuration file
Open your Codex configuration file. This is typically located at ~/.codex/config.toml or .codex/config.toml in your project root.
2. Add the MCP server
Add the D&B Direct+ server URL block to your TOML file.
[mcp_servers.dnb-directplus]
url = "https://plus.dnb.com/v2/mcp"
3. Trust workspace and run
Run codex trust in your terminal if you are using a workspace-specific configuration to activate the new server.
Connector Setup: Gemini
1. Set credentials in your shell
Before connecting, ensure your D&B Direct+ API credentials are available in your environment.
export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"
2. Add the MCP server
Register the D&B Direct+ MCP server with your Gemini CLI client using the transport protocol.
gemini mcp add --transport http \
--client-id "$CLIENT_ID" \
--client-secret \
--callback-port 8080 \
dnb-directplus https://plus.dnb.com/v2/mcp
3. Verify the server was added
Confirm that the server is successfully registered and available in your active configuration.
gemini mcp list
gemini mcp get dnb-directplus
Connector Setup: Copilot Studio
1. Add the MCP server
Open the agent's Build page, select Tools, and add a Model Context Protocol server.
2. Enter server details
Select OAuth 2.0 and choose Manual configuration. Enter the configuration values below.
Server name: D&B MCP
Server description: Verified B2B context for agent workflows
Server URL: https://plus.dnb.com/v2/mcp
Authentication: OAuth 2.0
Configuration type: Manual
Client ID: <D&B_CLIENT_ID>
Client secret: <D&B_CLIENT_SECRET>
Authorization URL: https://plus.dnb.com/v2/mcp/authorize
Token URL: https://plus.dnb.com/v2/mcp/token
Refresh token URL: https://plus.dnb.com/v2/mcp/token
Scopes: use the values supplied for your D&B environment
3. Connect and verify
Select Add, review the discovered tools, save the agent, and test in Preview.
4. Authentication and token renewal
The managed connection uses the configured authorization and token endpoints to complete the OAuth code exchange. Renewal is managed by the connection. Reconnect the MCP server from the agent's Tools page if authorization is requested again.
Connector Setup: Databricks
1. Create an MCP connection
Log into Databricks. Navigate to Catalog > Manage (gear icon) > Connections. Click Create Connection.
2. Enter connection basics
In Connection Basics, enter a connection name, set Connection Type to HTTP, set Auth Type to OAuth Machine to Machine, and click Next.
3. Configure authentication
In Authentication, enter the host and port, leave OAuth Scope empty, and enter the D&B Client Secret and Client ID. Then click Next.
Host: https://plus.dnb.com
Port: 443
OAuth scope: leave empty
Client ID: <D&B_CLIENT_ID>
Client secret: <D&B_CLIENT_SECRET>
Token endpoint: https://plus.dnb.com/v2/mcp/oauth/token
Base path: /v2/mcp
Is MCP Connection: checked
4. Enter connection details
In Connection Details, enter Token endpoint https://plus.dnb.com/v2/mcp/oauth/token and Base path /v2/mcp. Check Is MCP Connection, then click Submit.
5. Test MCP connection
Navigate to Playground. Select the LLM to use. Click + Add Tool. On the MCP Servers tab, choose External MCP Server and select the connection under External MCP Connection. Select the connection tool from the drop-down menu and press Save.
6. Run a test query
Enter a query and press the chevron to run it. Databricks calls the required MCP tools and returns the raw response plus the LLM interpretation.
Verify Your Connection
After setup, test with a simple prompt to confirm the D&B MCP server is responding:
Find the D‑U‑N‑S® Number for Gorman Manufacturing Company, Inc. in Jacksonville, FL.
If you get a D‑U‑N‑S Number and company details back, you're connected. If you see an auth error message, check your credentials. If the tool isn't found, verify that the MCP server is listed in your tool's settings.
If you see the D‑U‑N‑S number for Gorman Manufacturing Test Company, Inc. (DUNS: 804735132) in Jacksonville, FL, your connection was successful.
How Connectors Work
D&B connectors provide a governed interface between your tools and the D&B Commercial Graph™.
- Authenticated -- Every request is tied to your identity and subscription.
- Governed -- Maintain per-attribute lineage and audit trails to support transparency, accountability, and compliance.
- Credit-tracked -- Usage is metered against your entitlement.
MCP server URL: https://plus.dnb.com/v2/mcp
This URL works for all MCP-compatible platforms.
Authentication
The Dun & Bradstreet MCP connector uses OAuth 2.0 for authentication. View the documentation.
Preview Usage Limits
Up to 100 Domestic (Region 1) records and 100 Rest of World (Region 2) records.
Error Handling
View the documentation on common error codes, retry logic, and troubleshooting guidance.