MCP Tools

The Baselayer MCP server exposes 17 tools. Each one calls the same service that backs the matching REST endpoint, so billing, sandbox behavior, permissions, and response shapes are identical across both surfaces. The linked API reference page for each tool documents the full response schema.

Tools come in pairs: a tool that starts work and a 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.

ParameterTypeRequiredDescription
namestringYesRegistered legal name of the business.
addressstringYesRegistered legal address of the business.
officer_namesstring[]NoOfficer names to include in matching.
websiteURLNoBusiness website.
phone_numberstringNoBusiness phone number.
emailstringNoBusiness email address.
alternative_namesstring[]NoDBA or trade names.
tinstringNoNine digit TIN or EIN. Enables TIN matching.
reference_idstringNoYour own identifier for this search, up to 128 characters.

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:

ParameterTypeRequiredDescription
optionsstring[]YesOne or more of Order.WebsiteAnalysis, Order.NaicsPrediction, Order.Pep, Order.Enhanced.

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.

ParameterTypeRequiredDescription
idUUIDYesThe search id returned by a search tool.

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.

ParameterTypeRequiredDescription
idUUIDYesThe business id from a completed search.

Returns the business record. See Get a business 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.

ParameterTypeRequiredDescription
namestringYesBusiness name.
addressstringYesBusiness address.
alternative_namesstring[]NoDBA names, up to 10.
officer_namesstring[]NoOfficer names.
websitestringNoBusiness website.
phone_numberstringNoBusiness phone number.
emailstringNoBusiness email address.
reference_idstringNoYour own identifier for this request.

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.

ParameterTypeRequiredDescription
idUUIDYesThe prediction request id.

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.

ParameterTypeRequiredDescription
namestringYesBusiness or person name to search.
search_statesstring[]YesTwo letter state codes. All 50 states are supported; DC and territories are not.

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.

ParameterTypeRequiredDescription
idUUIDYesThe liens search id.

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.

ParameterTypeRequiredDescription
namestringYesBusiness or person name to search.
optionsstring[]NoOrder.Litigations, Order.Bankruptcy, or both. Defaults to both.

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.

ParameterTypeRequiredDescription
idUUIDYesThe docket search id.

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.

ParameterTypeRequiredDescription
person_namestringYesFull name of the person.
business_namestringYesName of the business to check against.
business_addressstringNoBusiness address, used to disambiguate similarly named businesses.
alternative_namesstring[]NoDBA names for the business, up to 10.

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.

ParameterTypeRequiredDescription
idUUIDYesThe verification request id.

Online Presence

See Online Presence basics and the response reference.

analyze_online_presence

Start an online presence analysis for a US business: 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.

ParameterTypeRequiredDescription
namestringYesBusiness name.
addressstringYesBusiness address.
optionsstring[]NoAny of Order.NaicsPrediction, Order.WebsiteAnalysis, Order.SocialMedia, Order.ReviewSummary, Order.ReviewFull, Order.DirectoryListing. Defaults to Order.NaicsPrediction and Order.WebsiteAnalysis.
alternative_namesstring[]NoDBA names, up to 10.
officer_namesstring[]NoOfficer names.
websitestringNoKnown website, if you have one.
phone_numberstringNoBusiness phone number.
emailstringNoBusiness email address.
social_profilesobject[]NoKnown social media profiles, up to 10.
iso2_country_codestringNoMust be US or omitted. International analysis is not yet available over MCP.
reference_idstringNoYour own identifier for this request.

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.

ParameterTypeRequiredDescription
idUUIDYesThe web presence request id.

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.

ParameterTypeRequiredDescription
qstringYesThe name to screen.
watchlistsstring[]YesOne or more of OFAC, PEP, CSL, FBI, CNS, OIG.
similarity_thresholdnumberNoMinimum match similarity from 0 to 1. Defaults to 0.9.
limitintegerNoMaximum matches per watchlist, 1 to 50. Defaults to 5.
WatchlistSource
OFACUS Treasury sanctions lists (SDN and consolidated)
PEPPolitically exposed persons
CSLUS Consolidated Screening List (Commerce, State, Treasury)
FBIFBI most wanted
CNSCanadian sanctions
OIGHHS Office of Inspector General exclusions

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.

ParameterTypeRequiredDescription
namestringYesBusiness name as registered with the IRS.
tinstringYesNine digit TIN or EIN. Hyphens are accepted.
addressstringNoBusiness address.

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.

ParameterTypeRequiredDescription
idUUIDYesThe TIN verification id.

Request states

Every search and verification carries a state:

StateMeaning
PENDINGQueued, not yet started.
EXECUTINGRunning.
COMPLETEDFinished. Results are populated.
FAILEDFinished with an error.
CANCELLEDStopped before completion.

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.

ToolsPermission
search_business, search_business_with_orders, predict_naics, verify_employment, analyze_online_presence, search_watchlists, verify_tinsearches:create
get_business_search, get_naics_prediction, get_employment_verification, get_online_presence_analysis, get_tin_verificationsearches:read
get_businessbusinesses:read
search_liens / get_liens_searchliens.searches:create / liens.searches:read
search_litigations / get_litigations_searchdockets.searches:create / dockets.searches:read

Did this page help you?