Integrations & API
Your data, straight into the tools you use
No downloading and re-uploading spreadsheets. Send every list to your outreach tool, CRM or dialler with one click — or let your AI agent find, price and order the data itself.
One-click sends from your login
Once an order is delivered, open My orders → Send to CRM / dialler, connect your tool once, and press Send. Tick "Send new files automatically" and every future order goes across the moment it's ready.
| Tool | What happens | What you need |
|---|---|---|
| Instantly | Leads added to a campaign or lead list (1,000 per call, duplicates skipped) | API key (v2) and the campaign ID |
| Smartlead | Leads added to a campaign | API key and the campaign ID |
| lemlist | Leads added to a campaign (anyone already in it is skipped) | API key and the campaign ID |
| Reply.io | Contacts created or updated, and enrolled in a sequence | API key, and the sequence ID if you want them enrolled |
| HubSpot | Contacts (updated if the email already exists) or companies | A private app access token |
| Zapier, Make, n8n | Each record sent to your Zap or scenario — then on to Pipedrive, Salesforce, Google Sheets, Slack or anything else | Your catch-hook address |
| Diallers (Vicidial and others) | CSV uploaded to your SFTP/FTP drop folder, or one API call per lead | Server login, or your add-lead URL |
| Your own API | Records POSTed as JSON in batches | Your endpoint (and an auth header if you use one) |
Names are split into first and last name, phones are sent as +44, and company number, business activity, address and every other column go across as custom fields. Cold-email tools only take records with an email address; the rest are skipped and stay in your download. Your keys are stored encrypted and only ever used to send your own data.
Files ready to import
Prefer to import by hand? Every delivered list can be downloaded laid out for the import screen of Salesforce (Leads, Data Import Wizard), HubSpot, Pipedrive, Instantly, Smartlead, lemlist and Reply.io — as well as the normal CSV and Excel files. You'll find them under Download ready to import.
JSON push format
The "API - JSON batches" connection POSTs each batch as:
{"source":"UKDatabases","order_ref":"UKB-19501","batch":1,
"records":[{"Company name":"...","Company number":"...","Business activity":"...","Town":"...","Postcode":"...",
"Website":"...","Telephone":"...","Email":"...","Decision maker name":"..."}]}
Every column in your file, one object per record. Any 2xx reply counts as received; failed batches are retried and the send carries on from where it stopped. The Zapier / Make / n8n connection sends one flat record per call with simple field names (company, email, first_name, last_name, phone, website, town, postcode, company_number, business_activity…).
MCP server for AI agents
UK Databases is a remote Model Context Protocol server, so Claude, ChatGPT, Cursor, Claude Code, VS Code and any MCP client or AI sales agent can search UK businesses, see live counts and prices, place orders and fetch the files.
- Server URL:
https://ukdatabases.com/mcp - Transport: Streamable HTTP (stateless, JSON responses).
- Sign-in: OAuth 2.1 with PKCE — dynamic client registration and client ID metadata documents are both supported. Your users log in with their UK Databases account (or create one free during sign-in).
- Payment: agents never take payment. An order returns a secure link to a page on ukdatabases.com where the buyer pays by card; the agent then fetches the file.
| Tool | What it does |
|---|---|
find_sectors | Finds sector groups and SIC codes from plain words (e.g. "plumbers", "accountants") |
find_areas | Finds regions, counties, towns, postcode areas and districts |
count_and_price | Live count, price, delivery time and masked samples for any filters |
create_order | Creates the order and returns the payment link |
get_order | Order status; once paid, the download link (and the records for smaller lists) |
list_orders | The account's orders, including unpaid ones with their pay links |
Claude: Settings → Connectors → Add custom connector → paste the server URL (full guide).
Claude Code: claude mcp add --transport http ukdatabases https://ukdatabases.com/mcp
Cursor / VS Code / other clients:
{ "mcpServers": { "ukdatabases": { "url": "https://ukdatabases.com/mcp" } } }
Discovery: /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server. An unauthenticated call to the server returns 401 with a WWW-Authenticate header pointing at them.
Building something bigger?
Resellers, platforms and agencies: see the partner programme, or email support@ukdatabases.com about volume access. Every list comes with a 12-month licence for your own marketing — see our terms and data licence.