get_* tool that reads it back by id. The MCP Overview explains when your assistant needs to poll.
Field names
Field names below are the exact JSON keys the tool accepts. Your assistant fills them in from your conversation, so you rarely type them yourself, but knowing them helps when you want to be specific (“search liens in Texas and Oklahoma only”).Business Search
The foundation product (Business Search basics). A business search matches a legal name and address against Secretary of State registrations and returns the verified entity, its officers, and verification signals.search_business
Search for a business by its legal name and legal address. Returns a completed business search with matched registrations, officer details, and verification signals such as TIN match and address match. Synchronous, with a 30 second wait.
Returns a business search:
id, state, the matched business with its registrations and officers, and verification signals. See Create a business search in the API reference.
Example prompt: “Verify Acme Holdings LLC at 500 Main St, Austin TX 78701. The EIN is 12-3456789.”
search_business_with_orders
Start a business search that also orders add-on products. At least one option is required. Asynchronous: returns the PENDING search immediately, and your assistant polls get_business_search until it completes.
Accepts every search_business parameter plus:
Order.Enhanced requires both Order.WebsiteAnalysis and Order.NaicsPrediction in the same request.
Example prompt: “Run a full KYB on Acme Holdings LLC at 500 Main St, Austin TX, including website analysis and industry classification.”
get_business_search
Retrieve a business search by id: its state and, once COMPLETED, the matched registrations, verification signals, and results of any ordered add-ons.
get_business
Retrieve a business’s full verified record by id: registrations, officers, watchlist hits, industry classification, and risk signals. Use it to expand a business found through search_business.
Returns the business record. See Get a business in the API reference.
International Business Search
Verify a business registered outside the US directly at its country’s corporate registry (International products). For a business registered in a US state or territory, usesearch_business instead.
search_international_business
Search for a business at its country’s registry by name and address, by registration (filing) number, or both. Returns the matched registration, KYB and Risk scores, and watchlist hits. Synchronous, with a 30 second wait. A search that is still PENDING after that (usual with Order.Enhanced) is returned as is, and your assistant polls get_international_business_search until it completes.
Order.Enhanced is available only in countries marked ★. In any other country the tool returns an error saying so, and nothing is ordered.
Returns an international business search: id, state, and once COMPLETED the matched registration, KYB and Risk scores, and watchlist hits. See Post International Search in the API reference.
Example prompt: “Verify Northwind Trading Ltd in the UK, company number 01234567, and include beneficial owners.”
get_international_business_search
Retrieve an international business search by id: its state and, once COMPLETED, the matched registration and KYB and Risk scores.
Returns the international business search. See Get International Search in the API reference.
Industry Classification
See the Industry Prediction user guide.predict_naics
Predict a business’s NAICS industry classification from its name, address, and any other context you have. Returns the predicted NAICS code, SIC codes, a risk level, and reasoning. Synchronous, with a 30 second wait.
See Create a NAICS prediction request in the API reference for the full response.
Example prompt: “What industry is Ray’s Famous Pizza at 27 Prince St, New York NY in? Give me the NAICS code.”
get_naics_prediction
Retrieve a NAICS prediction by id: its state and, once COMPLETED, the predicted NAICS code, SIC codes, risk level, and reasoning.
Lien Search
See Lien Search basics for how lien data is sourced.search_liens
Search UCC and tax lien filings for a business or person name in the US states you specify. Returns the filings found. Synchronous, with a 30 second wait.
Returns a liens search:
id, state, and filings with filing number, type, date, status, and secured and debtor parties. See Start an ad hoc lien search in the API reference.
Example prompt: “Are there any UCC filings or tax liens against Acme Holdings LLC in Texas or Delaware?”
get_liens_search
Retrieve a liens search by id: its state and, once COMPLETED, the lien filings found.
Docket Search
See Litigation and Bankruptcy Search basics.search_litigations
Search court dockets for civil litigations and bankruptcies involving a business or person name. Searches both by default. Synchronous, with a 30 second wait.
Returns a docket search:
id, state, and the dockets found with court, case number, filing date, parties, and case type. See Start an ad hoc docket search in the API reference.
Example prompt: “Has Acme Holdings LLC filed for bankruptcy or been party to any lawsuits?”
get_litigations_search
Retrieve a docket search by id: its state and, once COMPLETED, the court dockets found.
Employment Verification
verify_employment
Verify that a person is employed by a business using public web evidence. Returns whether the person was verified, their role title, department, and the evidence and sources behind the conclusion. Synchronous, with a 30 second wait.
See Start an employee verification request in the API reference for the full response.
Example prompt: “Confirm that Jane Doe works at Acme Holdings LLC in Austin and tell me her title.”
get_employment_verification
Retrieve an employment verification by id: its state and, once COMPLETED, the outcome with evidence and sources.
Online Presence
See Online Presence basics and the response reference.analyze_online_presence
Start an online presence analysis for a business in the US or elsewhere: discovers and analyzes its website and wider online footprint. Asynchronous: returns the PENDING request immediately, and your assistant polls get_online_presence_analysis until it completes.
Returns a web presence request. Once
COMPLETED it carries the discovered website, website analysis, and results for each ordered option. See Create a web presence request in the API reference.
Example prompt: “Find Ray’s Famous Pizza’s website and social profiles and summarize their online reviews.”
get_online_presence_analysis
Retrieve an online presence analysis by id: its state and, once COMPLETED, the discovered website and findings.
Watchlist Screening
See Watchlists and Sanctions basics.search_watchlists
Screen a name against government watchlists, grouped by source. Synchronous. One billable order is written per watchlist requested.
Returns
results grouped by watchlist, each with matched entries and a similarity score, plus total_matches. See Search multiple watchlists in the API reference.
Example prompt: “Screen John Smith against OFAC and PEP lists with a 0.85 similarity threshold.”
TIN Verification
verify_tin
Verify a TIN or EIN against IRS records by business name. Synchronous. If the IRS service is unavailable the request stays PENDING and is retried later, and your assistant polls get_tin_verification for the outcome.
Returns
tin_matched (boolean) and tin_match_type. See Submit a TIN verification in the API reference.
Example prompt: “Does EIN 12-3456789 match Acme Holdings LLC?”
get_tin_verification
Retrieve a TIN verification by id: its state and, once resolved, tin_matched and tin_match_type.
Retries and idempotency_key
Every tool that starts a search or verification also accepts an optional idempotency_key string. If a call is retried with the same key and the same arguments, the tool returns the resource the first call created instead of ordering, and billing, the work again. Reusing a key with different arguments, or on a different tool, returns an error that names the existing resource. This works the same way as the REST API’s Idempotency-Key header.
Request states
Every search and verification carries astate:
COMPLETED, FAILED, and CANCELLED are terminal. Anything else should be polled with the matching get_* tool.
Permissions
Tools check the same role permissions as the REST API. If your role lacks a permission the tool returns an error naming it, and an organization admin can grant it in the Console.
International Business Search is available on enterprise plans. On other plans the international tools return a permission error.