KnowFirst integration
KnowFirst is a business and contact intelligence database for Australia and New Zealand. Search millions of business profiles and people records by keyword, industry, location, size, tech stack and reviews, read per-business views (locations, socials, ads, search rankings, tech stack, jobs, employees, salaries, news, contracts, trademarks, awards, reviews), enrich lists of ABNs, NZBNs or domains, and manage your custom lists and saved filters. Most reads consume account credits; account, list and filter routes are free. Every KnowFirst API route is exposed. Authentication is an API key from the KnowFirst app (API Keys page) sent in the x-api-key header.
Say what should happen.
The workflow builds itself.
What you can do with KnowFirst
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Business, 24 operations
enrich_businessesEnrich businessesGETMatch up to 100 identifiers (ids, ABNs, ACNs, NZBNs, URLs, stock codes) to businesses in one call; each identifier parameter takes several values. Uses 1 credit per call.get_business_adsGet business adsGETGet a business's online advertising activity (Google Ads, Google Shopping, Bing Ads). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_awardsGet business awardsGETGet the awards a business has won. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_contractsGet business contractsGETGet the contracts and tenders a business has undertaken. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_customer_reviewsGet business customer reviewsGETGet a business's customer review data (Google, Facebook, ProductReview). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_directoriesGet business directoriesGETGet the business directories a business appears on (Google Business, Yelp, Yellow Pages, True Local). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_domainsGet business domainsGETGet the websites and domains registered by a business. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_employee_reviewsGet business employee reviewsGETGet a business's employee review data (Glassdoor). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_feedGet business feedGETGet the event history (feed) of a business. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_jobsGet business jobsGETGet the jobs a business advertises. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_locationsGet business locationsGETGet a business's physical locations. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_newsGet business newsGETGet news articles about a business. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_organic_rankingsGet business organic rankingsGETGet a business's organic search rankings. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_overviewGet business overviewGETGet a business's overview (names, identifiers, industry, size, contact details). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_peopleGet business peopleGETGet a business's current (or, with past=true, former) employees. Returns personal data: names, roles, contact details and salary ranges. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_salariesGet business salariesGETGet salary data for roles within a business (sensitive pay data). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_socialsGet business socialsGETGet a business's social media profiles. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_tech_stackGet business tech stackGETGet the technologies detected on a business's website. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_trademarksGet business trademarksGETGet the trademarks registered by a business. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_business_viewsGet business viewsGETGet several views of one business in a single call (views: comma-separated, e.g. overview,locations,tech_stack). Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.get_related_businessesGet related businessesGETGet businesses related to a business. Pass one identifier: id (from search_businesses), abn, acn, nzbn, url or stockcode. Uses 1 credit per call.list_suggested_businessesList suggested businessesGETList businesses KnowFirst suggests based on your past activity. Uses 1 credit per call.search_businessesSearch businessesGETSearch Australian and New Zealand businesses by keyword, industry, location, size, tech stack, reviews and more. Pass endpoint.next_token back as next_token for the next page. Uses 1 credit per call.search_businesses_with_viewsSearch businesses with viewsGETLike search_businesses, but each result also carries the requested views (views: comma-separated, e.g. locations,socials). Uses 1 credit per business returned.
Saved filter, 6 operations
create_business_saved_filterCreate business saved filterPUTSave a business search filter; takes the same filter parameters as search_businesses. Free (no credits).create_person_saved_filterCreate person saved filterPUTSave a person search filter; takes the same filter parameters as search_people. Free (no credits).delete_business_saved_filterDelete business saved filterDELETEDelete a saved business search filter.delete_person_saved_filterDelete person saved filterDELETEDelete a saved person search filter.list_business_saved_filtersList business saved filtersGETList the account's saved business search filters. Free (no credits).list_person_saved_filtersList person saved filtersGETList the account's saved person search filters. Free (no credits).
Business list, 4 operations
create_business_listCreate business listPUTCreate an empty custom business list; add businesses with add_businesses_to_list. Free (no credits).delete_business_listDelete business listDELETEDelete a custom business list and all its items. Cannot be undone.list_business_listsList business listsGETList the account's custom business lists (id, name, item count). Use a list id as list in search_businesses. Free (no credits).rename_business_listRename business listPUTRename an existing custom business list. Free (no credits).
Person list, 4 operations
create_person_listCreate person listPUTCreate an empty custom person list; add people with add_people_to_list. Free (no credits).delete_person_listDelete person listDELETEDelete a custom person list and all its items. Cannot be undone.list_person_listsList person listsGETList the account's custom person lists (id, name, item count). Use a list id as list in search_people. Free (no credits).rename_person_listRename person listPUTRename an existing custom person list. Free (no credits).
Person, 3 operations
find_person_by_emailFind person by emailGETGet a person's profile and role history by email address (optionally with a profile URL such as LinkedIn). Returns personal data: contact details, socials, salary ranges. Uses 1 credit per call.get_personGet personGETGet a person's profile and role history by KnowFirst person id (from search_people or get_business_people). Returns personal data: contact details, socials, salary ranges. Uses 1 credit per call.search_peopleSearch peopleGETSearch people (employees of AU and NZ businesses) by name, role, seniority, location and employer filters. Returns personal data. Pass endpoint.next_token back for the next page. Uses 1 credit per call.
Business filter, 2 operations
list_business_filter_fieldsList business filter fieldsGETList every filter field accepted by search_businesses with its available options. Free (no credits).list_business_filter_valuesList business filter valuesGETList the accepted values of one search_businesses filter field (type, tags, tech_stack, anzsic, state...). Free (no credits).
Business list item, 2 operations
add_businesses_to_listAdd businesses to listPUTAdd one or more businesses (by id) to a custom business list. Free (no credits).remove_businesses_from_listRemove businesses from listDELETERemove one or more businesses (by id) from a custom business list.
Export, 2 operations
list_business_exportsList business exportsGETList the business exports this account has performed. Free (no credits).list_person_exportsList person exportsGETList the person exports this account has performed. Free (no credits).
Person list item, 2 operations
add_people_to_listAdd people to listPUTAdd one or more people (by id) to a custom person list. Free (no credits).remove_people_from_listRemove people from listDELETERemove one or more people (by id) from a custom person list.
Account, 1 operation
get_accountGet accountGETGet the current KnowFirst account: plan, remaining API credits and counts of lists, saved filters and exports. Free (no credits).
Credit transaction, 1 operation
list_credit_transactionsList credit transactionsGETList the account's credit transactions (credits issued and consumed), filterable by time, type and source. Free (no credits).
Domain, 1 operation
get_domain_viewsGet domain viewsGETGet website-level data for domains (views: comma-separated from websites, ads, organic, customer_reviews, socials, directories, tech_stack), filtered by domain or business.id. Uses 1 credit per call.
Location, 1 operation
list_locationsList locationsGETList physical locations, filtered by business.id. Pass endpoint.next_token back as next_token for the next page. Uses 1 credit per call.
Use KnowFirst from Claude Code, Cursor or Codex
Connect KnowFirst in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its KnowFirst operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect KnowFirst
- Create your workspace
Sign up free. Nothing to install.
- Connect KnowFirst once
Add your KnowFirst connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
KnowFirst integration FAQ
What can you do with the KnowFirst integration?
LiveContext exposes 53 operations on KnowFirst, covering business, saved filter, business list and person list.
