> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalayer.so/llms.txt
> Use this file to discover all available pages before exploring further.

# What you can do

> The fifteen live Datalayer tools, what each one is for, and what it costs.

Fifteen tools are listed on the live connector at `https://mcp.datalayer.so/mcp`.
These are the published rates for new signups. An earlier account keeps the
rates recorded for it. Empty pages and failed calls do not spend credits. A
company or people search with results costs 1 credit. A paid result you
already bought can be opened again free for 24 hours, including added profile
context on that same result.

You still need an active allowance before a data call, including a search.
[Credits and saved research](https://docs.datalayer.so/profiles-and-usage.md) is the full price list.
[Copy a setup prompt](https://docs.datalayer.so/getting-started.md#copy-this-into-your-assistant) if the connector is
not connected yet.

Not in this release: funding data, mobile and app-market data, monitors,
outreach, CRM writes, and bulk contact exports. Bulk email validation is not
offered.

| Tool | What it does | Credits |
| - | - | - |
| `find_people` | Find people by name, employer, title, country, or skill | 1 if the page has results; otherwise 0 |
| `get_person_profile` | Open one person profile. Career context and activity are optional | 1 |
| `find_work_email` | Find a verified business email for an identified person | 2 if verified; otherwise 0 |
| `validate_email` | Check an email you already have | 1 if conclusive; otherwise 0 |
| `find_companies` | Find companies by name or keyword | 1 if the page has results; otherwise 0 |
| `get_company_profile` | Open one company profile. Workforce, team, hiring, and activity are optional | 1 |
| `find_job_postings` | Search indexed job postings across companies | 1 if the page has postings; otherwise 0 |
| `get_tech_stack` | List technologies observed on a company website | 1 if the page is not empty; otherwise 0 |
| `find_sites_using_tech` | Find sites observed using one technology | 1 if the page is not empty; otherwise 0 |
| `list_technologies` | Browse the technology directory | 0 |
| `get_list_filters` | Look up filters for a people or company list | 0 |
| `preview_list` | Preview list size before building. No record IDs | 0 |
| `build_list` | Build a list of person or company IDs | 1 per 100 IDs returned, rounded up |
| `get_list_results` | Read IDs from a list you already built | 0 on later reads |
| `get_account_details` | Show account name, email, and credit balance | 0 |

`build_list` reserves 1 credit per 100 requested IDs, rounded up, at most
10,000 IDs, and settles on the IDs actually returned. An empty or failed list
releases the reservation. The first successful `get_list_results` read is when
that settlement is delivered. A later read of the same list costs 0.

## People

### Find people

`find_people` returns a short page of professional matches by name, employer,
title, country, or skill. Use it when you need a shortlist before opening
anyone's full profile. It costs 1 credit when the page has at least one result, and 0 when the page is empty or the call fails.

> Use Datalayer to find people at Stripe with a title related to operations. Show up to five results. Do not open full profiles until I choose someone.

Seniority and function only filter the returned page. A listed role is
observational, not proof of current employment. A timeout is not an empty
result.

### Get a person profile

`get_person_profile` opens one person by person ID or public LinkedIn URL.
Career context and activity are optional. Work email is included only when you
ask. Use it after you have identified the right person.

The profile costs 1 credit. A verified business email on that same request
costs 2 credits. The same profile is free again within 24 hours.

> Look up this public LinkedIn profile in Datalayer: \[URL]. Summarize experience and skills. Mark missing details. Do not request email unless I ask.

Unverified employer-associated email candidates cost 0 and stay labelled
**UNVERIFIED**. [Read about work email](https://docs.datalayer.so/work-email.md).

### Find a business email

`find_work_email` discovers and verifies one business email for an identified
person. Use it only when you explicitly want contact research for someone
already identified.

It costs 2 credits only for a verified non-catch-all employer-domain email.
Otherwise it costs 0. There is no ownership or delivery guarantee. It shares
the 24-hour receipt with a profile that included email.

> Find the business email for person ID \[id] with Datalayer. Explain the check result and say clearly if uncertain.

### Validate an email

`validate_email` checks one email address you already have. It does not
discover emails. A conclusive valid or invalid result costs 1 credit.
Catch-all, unknown, and unavailable results cost 0. An eligible repeat within
24 hours is free. Bulk validation is not offered.

> Validate this email with Datalayer: [name@company.com](mailto:name@company.com). Report status and catch-all uncertainty.

## Companies

### Find companies

`find_companies` returns a short page of company matches by name or keyword.
Optional industry, geography, and size filters apply to that page only. Use it
to pick the right company before opening a profile. It costs 1 credit when the page has at least one result, and 0 when the page is empty or the call fails.

> Use Datalayer to search for Stripe. Show up to three company matches and their websites. Wait for me to choose before opening a full profile.

Filters are not a global market total. Inspect `result_scope` on the response.

### Get a company profile

`get_company_profile` opens one company by ID, domain, or LinkedIn company URL.
Workforce, team, hiring, and activity are optional and bundled into the profile.
Use it when you have the right match and want a briefing.

A delivered profile costs 1 credit. The same profile is free again within 24
hours.

> Open that company's Datalayer profile including hiring. Give a short briefing and flag missing or uncertain details.

Hiring counts are indexed postings, not confirmed hires. A technology stack is
separate. Use `get_tech_stack`.

## Jobs and website technology

### Find job postings

`find_job_postings` searches indexed postings, defaulting to the last 30 days
and capped at 90, by title, function, seniority, location, industry, or company.
Use it for hiring signals across companies. One company's own hiring summary is
part of `get_company_profile` when you ask for hiring.

A page with at least one posting costs 1 credit. An empty or failed page costs
0\. The identical search is free again within 24 hours.

> Use Datalayer to find recent senior marketing job postings in Canada. Summarize titles and employers. Do not treat postings as confirmed hires.

A missing close date is not proof the role is open. Company IDs on the jobs
index are not profile IDs.

### Get a technology stack

`get_tech_stack` lists technologies observed on one website, up to 100. Use a
bare hostname such as `stripe.com`. A page that lists at least one technology
costs 1 credit. An empty or failed page costs 0. The same domain is free again
within 24 hours.

> Show the website technology stack for stripe.com with Datalayer. Say what is missing.

Observed technologies are not proof of current use, and they are not part of
`get_company_profile`.

### Find sites using a technology

`find_sites_using_tech` lists sites observed using one technology slug from the
directory. A page that lists at least one site costs 1 credit. An empty or
failed page costs 0. The identical slug, limit, and offset are free again
within 24 hours.

> Using Datalayer, list sites that use the technology slug \[slug]. Show domains only.

This is an indexed observation, not a customer relationship or a complete
install base.

### List technologies

`list_technologies` browses the technology directory: slug, name, and rank. It
costs 0 credits. Use it to find the right slug before
`find_sites_using_tech`.

> Browse Datalayer technologies related to analytics and show me likely slugs.

One page is not the complete catalog. Paginate with limit and offset.

## Lists

Build a list in this order: `get_list_filters`, then `preview_list`, then
confirm the size and cost, then `build_list`, then `get_list_results`. Do not
skip the preview.

### Get list filters

`get_list_filters` looks up filter IDs for a people or company list. It is the
first step when you want a targeted list. It costs 0 credits. Feature IDs are
filters, not billable person or company IDs.

> Help me find Datalayer list filters for VP Sales titles in SaaS companies in the US.

### Preview a list

`preview_list` shows approximate size and a sample count. It returns no record
IDs and costs 0 credits. Use it before spending credits to build the list.
`page_count` is this preview page, not a population total.

> Preview this people list in Datalayer and tell me the size before building it.

### Build a list

`build_list` starts an export of person or company IDs, from 1 to 10,000. Use
it after you accept the preview size and the credit cost.

It reserves 1 credit per 100 requested IDs, rounded up, and settles on the IDs
returned. An empty or failed list releases the reservation. There is no free
repeat of an identical new export. Opening full profiles for the returned IDs
costs the usual profile price.

> Build a Datalayer list of up to 200 matching person IDs. Tell me the credit estimate first.

### Get list results

`get_list_results` reads person or company IDs for an export you already
started. The first successful delivery settles the reservation. Later reads of
the same list cost 0.

> Read the Datalayer list results for export \[id]. Do not open full profiles until I pick IDs.

Record IDs are removed 7 days after completion. The returned count remains.

## Account

### Get account details

`get_account_details` shows the connected account's saved name, email, plan,
credit balance, and expiry. It costs 0 credits and does not look up people or
companies. It works even when there is no active grant. Do not invent a name
or email that comes back empty. `remaining` excludes reservations.

> How many Datalayer credits do I have left, and when does my allowance expire?

## Field reference

Each tool has a request and response page in the API reference:

* [`find_people`](https://docs.datalayer.so/api-reference/search-people)
* [`get_person_profile`](https://docs.datalayer.so/api-reference/get-person)
* [`find_work_email`](https://docs.datalayer.so/api-reference/find-work-email)
* [`validate_email`](https://docs.datalayer.so/api-reference/validate-email)
* [`find_companies`](https://docs.datalayer.so/api-reference/search-companies)
* [`get_company_profile`](https://docs.datalayer.so/api-reference/get-company)
* [`find_job_postings`](https://docs.datalayer.so/api-reference/search-jobs)
* [`get_tech_stack`](https://docs.datalayer.so/api-reference/get-tech-stack)
* [`find_sites_using_tech`](https://docs.datalayer.so/api-reference/find-sites-using-tech)
* [`list_technologies`](https://docs.datalayer.so/api-reference/list-tech-tags)
* [`get_list_filters`](https://docs.datalayer.so/api-reference/find-segment-features)
* [`preview_list`](https://docs.datalayer.so/api-reference/preview-segment)
* [`build_list`](https://docs.datalayer.so/api-reference/export-segment)
* [`get_list_results`](https://docs.datalayer.so/api-reference/get-segment-export)
* [`get_account_details`](https://docs.datalayer.so/api-reference/get-account)

Earlier names that still run are listed only in the
[REST quickstart](https://docs.datalayer.so/quickstart.md#public-names-and-earlier-names).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.