Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Leadfeeder connector

OAuth2.1/DCRCRM & SalesAnalyticsMarketing

Connect to Leadfeeder's MCP server to identify website visitors, track B2B leads, and surface company-level intent data directly from your AI workflows.

Leadfeeder connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'leadfeedermcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Leadfeeder:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'leadfeedermcp_get_account_info',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Usage records — Retrieve current API usage and credit consumption for a Leadfeeder account
  • Update web visits custom feed, tag, list — Update the configuration of an existing web visit custom feed
  • Company unassign tags from, assign tags to — Remove one or more tags from a Leadfeeder company
  • Search web visits, contacts, companies signals — Search and filter web visit records to identify companies that visited your website
  • Lists remove contact from, remove company from, add contact to — Allows the removal of this contact from one or more lists
  • Companies match — Find matching companies based on the provided input parameters

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

leadfeedermcp_add_company_to_lists#Allows the addition of this company to one or more lists. Since lists are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Lists and Get List Details endpoints. Adding a company to lists does not consume credits.3 params

Allows the addition of this company to one or more lists. Since lists are a separate entity, the IDs that you must pass in this endpoint come from the Retrieve Lists and Get List Details endpoints. Adding a company to lists does not consume credits.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of list references to add the company to.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_add_contact_to_lists#Add a contact to one or more Leadfeeder lists.3 params

Add a contact to one or more Leadfeeder lists.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of list references to add the contact to.
idstringrequiredThe contact's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_assign_tags_to_company#Assign one or more tags to a Leadfeeder company.3 params

Assign one or more tags to a Leadfeeder company.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of tag references to assign to the company.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_create_company_enrichment_job#Start an async job to enrich a batch of companies with additional data. Returns a job ID to track progress.2 params

Start an async job to enrich a batch of companies with additional data. Returns a job ID to track progress.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredEnrichment job creation parameters. Provide exactly one of company_ids or list_id, plus a custom_field_id identifying the AI field to enrich.
leadfeedermcp_create_custom_field#Create a new custom field in a Leadfeeder account.2 params

Create a new custom field in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredThe request body containing the custom field definition.
leadfeedermcp_create_find_contact_data_job#CRITICAL: CREDIT-CONSUMING TOOL Using this tool MAY consume Leadfeeder credits. You MUST follow this protocol: 1. PAUSE: Do not execute this tool automatically. 2. INFORM: Tell the user this action may consume credits. 3. CONFIRM: Ask the user for an explicit Yes/No confirmation to proceed. 4. EXECUTE: Only call this tool after receiving clear, affirmative consent. Trigger an asynchronous job to enrich the given contacts with email and phone data. Accepts either explicit `contact_ids` or a `list_id` to target an entire list. The job runs in the background; poll the status endpoint to check progress. Credit Note: Credits are consumed as contacts are enriched. Requires the `contacts:read` OAuth2 scope.2 params

CRITICAL: CREDIT-CONSUMING TOOL Using this tool MAY consume Leadfeeder credits. You MUST follow this protocol: 1. PAUSE: Do not execute this tool automatically. 2. INFORM: Tell the user this action may consume credits. 3. CONFIRM: Ask the user for an explicit Yes/No confirmation to proceed. 4. EXECUTE: Only call this tool after receiving clear, affirmative consent. Trigger an asynchronous job to enrich the given contacts with email and phone data. Accepts either explicit `contact_ids` or a `list_id` to target an entire list. The job runs in the background; poll the status endpoint to check progress. Credit Note: Credits are consumed as contacts are enriched. Requires the `contacts:read` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredJob definition object. Must include an 'attributes' field with either contact_ids or list_id.
leadfeedermcp_create_list#Create a new list in the account. Requires the `lists:write` OAuth2 scope.2 params

Create a new list in the account. Requires the `lists:write` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredList definition object with required type and attributes fields.
leadfeedermcp_create_tag#Create a new tag in a Leadfeeder account.2 params

Create a new tag in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredThe request body containing the tag definition.
leadfeedermcp_create_web_visits_custom_feed#Create a new custom feed to filter and segment web visit data.2 params

Create a new custom feed to filter and segment web visit data.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredThe custom feed object to create, including type and attributes.
leadfeedermcp_delete_custom_field#Permanently delete a custom field from a Leadfeeder account.2 params

Permanently delete a custom field from a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe custom field internal name.
leadfeedermcp_delete_list#Delete a list from the account. Once removed, the list will no longer be accessible. Credit Note: Deleting list does not consume credits. Requires the `lists:write` OAuth2 scope.2 params

Delete a list from the account. Once removed, the list will no longer be accessible. Credit Note: Deleting list does not consume credits. Requires the `lists:write` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe list ID.
leadfeedermcp_delete_tag#Permanently delete a tag from a Leadfeeder account.2 params

Permanently delete a tag from a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe tag ID.
leadfeedermcp_delete_web_visits_custom_feed#Permanently delete a web visit custom feed.2 params

Permanently delete a web visit custom feed.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
custom_feed_idstringrequiredThe ID of the custom feed to delete.
leadfeedermcp_enrich_ip#Look up company information associated with a given IP address. Returns firmographic data for the organization behind the IP.2 params

Look up company information associated with a given IP address. Returns firmographic data for the organization behind the IP.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
ipstringrequiredA valid IPv4 or IPv6 address to enrich with company information.
leadfeedermcp_estimate_company_enrichment_job#Estimate the credit cost of a company enrichment job before running it.2 params

Estimate the credit cost of a company enrichment job before running it.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredEnrichment job estimate parameters including attributes that specify the target companies and custom field to enrich.
leadfeedermcp_estimate_find_contact_data_job#Estimate the credit cost for enriching contacts with email and phone data. Accepts either explicit `contact_ids` or a `list_id` to target an entire list. Returns the number of eligible contacts and the estimated total credits that would be consumed. Credit Note: This endpoint does not consume credits. Requires the `contacts:read` OAuth2 scope.2 params

Estimate the credit cost for enriching contacts with email and phone data. Accepts either explicit `contact_ids` or a `list_id` to target an entire list. Returns the number of eligible contacts and the estimated total credits that would be consumed. Credit Note: This endpoint does not consume credits. Requires the `contacts:read` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredJob definition object. Must include an 'attributes' field with either contact_ids or list_id.
leadfeedermcp_get_account_info#Retrieves a list of Leadfeeder accounts associated with this API key. When listing all accounts, only the account names are returned. Detailed credit information is accessible only when querying a specific account.1 param

Retrieves a list of Leadfeeder accounts associated with this API key. When listing all accounts, only the account names are returned. Detailed credit information is accessible only when querying a specific account.

NameTypeRequiredDescription
account_idstringoptionalThe Leadfeeder Account ID. When provided, the response returns a single account including credit details. If omitted, it returns a list of all accessible accounts without credit information.
leadfeedermcp_get_buyer_persona#Retrieve a specific buyer persona by ID.2 params

Retrieve a specific buyer persona by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe buyer persona ID.
leadfeedermcp_get_buyer_personas#Retrieve all buyer personas defined in a Leadfeeder account.1 param

Retrieve all buyer personas defined in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
leadfeedermcp_get_campaign#Retrieve details of a specific campaign by ID.3 params

Retrieve details of a specific campaign by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe campaign ID.
includestringoptionalComma-separated list of related resources to inline. Supported: campaign_summary, campaign_settings, campaign_locations, list, custom_feed.
leadfeedermcp_get_campaign_stats#Retrieve performance statistics for a specific campaign.7 params

Retrieve performance statistics for a specific campaign.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
end_periodstringrequiredInclusive end of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or after start_period.
frequencystringrequiredBucket granularity for the returned stats series.
idstringrequiredThe campaign ID.
start_periodstringrequiredInclusive start of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or before end_period.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_campaigns#Retrieve all campaigns in a Leadfeeder account.4 params

Retrieve all campaigns in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
includestringoptionalComma-separated list of related resources to inline. Supported: campaign_summary, campaign_settings, campaign_locations, list, custom_feed.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_companies_by_ids#Fetch one or more companies by their Leadfeeder IDs in a single call. Pass IDs comma-separated in the ids parameter (up to 100 IDs). Accessing company data consumes credits.3 params

Fetch one or more companies by their Leadfeeder IDs in a single call. Pass IDs comma-separated in the ids parameter (up to 100 IDs). Accessing company data consumes credits.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idsstringrequiredComma separated list of company IDs. A maximum of 100 IDs can be passed to this endpoint.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_company#Fetch detailed information about a specific company, including firmographics and hierarchy information. Accessing full deep data consumes 1 credit, unless the company was already accessed within the last 12 months.3 params

Fetch detailed information about a specific company, including firmographics and hierarchy information. Accessing full deep data consumes 1 credit, unless the company was already accessed within the last 12 months.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_company_enrichment_job#Check the status and results of a company enrichment job.2 params

Check the status and results of a company enrichment job.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
job_idstringrequiredThe unique identifier of the enrichment job.
leadfeedermcp_get_company_financials#Returns all financial reports for a given company. Accessing financial data consumes 1 credit per company if not accessed within the last 12 months.2 params

Returns all financial reports for a given company. Accessing financial data consumes 1 credit per company if not accessed within the last 12 months.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_get_company_ips#Fetch known IP addresses associated with given companies. Retrieving IP data consumes 1 credit per company unless accessed within the last 12 months.4 params

Fetch known IP addresses associated with given companies. Retrieving IP data consumes 1 credit per company unless accessed within the last 12 months.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
company_idsstringrequiredA comma-separated list of company IDs. Accepts up to 100 company IDs per request.
includestringoptionalSpecify which additional data should be attached to the result. When 'company' is included, the full company attributes are inlined.
max_ip_addressesintegeroptionalMaximum number of IP addresses to return per company. Results are ordered by confidence score (highest first).
leadfeedermcp_get_contact#Fetch detailed information about a specific contact by ID.3 params

Fetch detailed information about a specific contact by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe contact's ID. Note that the older string-based ID format continues to be supported.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_contacts#Retrieve a paginated list of contacts from Leadfeeder.3 params

Retrieve a paginated list of contacts from Leadfeeder.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idsstringrequiredComma separated list of contact IDs. A maximum of 100 IDs can be passed to this endpoint.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_current_user_info#Retrieves the identity of the current API user. Unlike most endpoints, this one does not require the account_id parameter — the user's identity is independent of the account they are currently working on.0 params

Retrieves the identity of the current API user. Unlike most endpoints, this one does not require the account_id parameter — the user's identity is independent of the account they are currently working on.

leadfeedermcp_get_custom_field#Retrieve a specific custom field by ID.2 params

Retrieve a specific custom field by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe custom field internal name.
leadfeedermcp_get_custom_fields#Retrieve the list of all custom field definitions available in the account. The response includes each field's attributes. Credit Note: Retrieving custom field definitions does not consume credits. Requires the `custom_fields:read` OAuth2 scope. Pagination: use page_num to page through results, starting at 1. Increment by 1 for each subsequent page. Stop when page_num exceeds meta.pagination.page_count. page_size controls how many items are returned per page (default: 20, max: 100).5 params

Retrieve the list of all custom field definitions available in the account. The response includes each field's attributes. Credit Note: Retrieving custom field definitions does not consume credits. Requires the `custom_fields:read` OAuth2 scope. Pagination: use page_num to page through results, starting at 1. Increment by 1 for each subsequent page. Stop when page_num exceeds meta.pagination.page_count. page_size controls how many items are returned per page (default: 20, max: 100).

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
filter_scopestringoptionalFilter by entities that apply to either company or contact. If omitted, returns both kinds of entities.
filter_typestringoptionalFilter by field type. If omitted, returns all field types.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_find_contact_data_job#Retrieve the current status of a Find Contact Data job. Returns progress counters, credit consumption, and any errors. Jobs are retained for 7 days after completion. Credit Note: This endpoint does not consume credits. Requires the `contacts:read` OAuth2 scope.2 params

Retrieve the current status of a Find Contact Data job. Returns progress counters, credit consumption, and any errors. Jobs are retained for 7 days after completion. Credit Note: This endpoint does not consume credits. Requires the `contacts:read` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
job_idstringrequiredThe unique identifier of the find contact data job.
leadfeedermcp_get_icp#Retrieve a specific Ideal Customer Profile (ICP) definition by ID.2 params

Retrieve a specific Ideal Customer Profile (ICP) definition by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe ICP ID.
leadfeedermcp_get_icps#Retrieve all Ideal Customer Profile (ICP) definitions in a Leadfeeder account.1 param

Retrieve all Ideal Customer Profile (ICP) definitions in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
leadfeedermcp_get_list#Retrieve the details of a specific list using its unique ID. The response includes the list's attributes, such as its name and scope, along with any related information. Credit Note: Retrieving list definitions does not consume credits. Requires the `lists:read` OAuth2 scope.2 params

Retrieve the details of a specific list using its unique ID. The response includes the list's attributes, such as its name and scope, along with any related information. Credit Note: Retrieving list definitions does not consume credits. Requires the `lists:read` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe list ID.
leadfeedermcp_get_lists#Retrieve all lists available in the account. The response includes each list's attributes and can be filtered through query parameters. Credit Note: Retrieving list definitions does not consume credits. Requires the `lists:read` OAuth2 scope. Pagination: use page_num to page through results, starting at 1. Increment by 1 for each subsequent page. Stop when page_num exceeds meta.pagination.page_count. page_size controls how many items are returned per page (default: 20, max: 100).4 params

Retrieve all lists available in the account. The response includes each list's attributes and can be filtered through query parameters. Credit Note: Retrieving list definitions does not consume credits. Requires the `lists:read` OAuth2 scope. Pagination: use page_num to page through results, starting at 1. Increment by 1 for each subsequent page. Stop when page_num exceeds meta.pagination.page_count. page_size controls how many items are returned per page (default: 20, max: 100).

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
filter_scopestringrequiredFilter by entities that apply to either company or contact.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_tag#Retrieve details of a specific tag by ID.2 params

Retrieve details of a specific tag by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
idstringrequiredThe tag ID.
leadfeedermcp_get_tags#Retrieve all tags defined in a Leadfeeder account.3 params

Retrieve all tags defined in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_web_visits_companies#Retrieve companies identified from web visits, with details about their visit activity.7 params

Retrieve companies identified from web visits, with details about their visit activity.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
end_datestringrequiredEnd of the date range (ISO 8601).
start_datestringrequiredStart of the date range (ISO 8601).
custom_feed_idstringoptionalFilter results to companies matching a specific custom feed.
includestringoptionalSpecify which additional data should be attached to the result.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_get_web_visits_custom_feed#Retrieve details of a specific web visit custom feed by ID.3 params

Retrieve details of a specific web visit custom feed by ID.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
custom_feed_idstringrequiredThe ID of the custom feed.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_web_visits_custom_feed_folders#Retrieve all folder groupings for web visit custom feeds in a Leadfeeder account.2 params

Retrieve all folder groupings for web visit custom feeds in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_web_visits_custom_feeds#Retrieve all custom feeds for web visits in a Leadfeeder account.2 params

Retrieve all custom feeds for web visits in a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
includestringoptionalSpecify which additional data should be attached to the result.
leadfeedermcp_get_web_visits_tracker#Retrieve tracking script configuration and status for web visit tracking.1 param

Retrieve tracking script configuration and status for web visit tracking.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
leadfeedermcp_match_companies#Find matching companies based on the provided input parameters. Returns matching company IDs and basic company information. Each company object must include at least one of: company_name, url, vat_id, or register_id. Matches do not consume credits.3 params

Find matching companies based on the provided input parameters. Returns matching company IDs and basic company information. Each company object must include at least one of: company_name, url, vat_id, or register_id. Matches do not consume credits.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
companiesarrayrequiredArray of company objects to match (up to 200). Each must include at least one of: company_name, url, vat_id, or register_id.
max_results_per_companynumberoptionalNumber of maximum results per company match input object.
leadfeedermcp_remove_company_from_lists#Remove a company from one or more Leadfeeder lists.3 params

Remove a company from one or more Leadfeeder lists.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of list references to remove the company from.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_remove_contact_from_lists#Allows the removal of this contact from one or more lists. Credit Note: Removing a contact from lists does not consume credits. Requires the `contacts:write` OAuth2 scope.3 params

Allows the removal of this contact from one or more lists. Credit Note: Removing a contact from lists does not consume credits. Requires the `contacts:write` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of list references to remove the contact from.
idstringrequiredThe contact's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_search_companies#Search companies by name, location, industry, size, and other filters. Returns matching company IDs and basic company info. Searches do not consume credits. Pagination: pass page_cursor from meta.pagination.next_cursor to fetch the next page. Stop when next_cursor is null.10 params

Search companies by name, location, industry, size, and other filters. Returns matching company IDs and basic company info. Searches do not consume credits. Pagination: pass page_cursor from meta.pagination.next_cursor to fetch the next page. Stop when next_cursor is null.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
employee_rangesarrayoptionalList of employee count ranges to filter companies by size.
filtersobjectoptionalObject containing additional boolean filters to refine search results. All filters are combined using AND.
icp_idsarrayoptionalList of Ideal Customer Profile (ICP) IDs. Returns companies matching at least one ICP (OR logic).
industriesobjectoptionalObject specifying industry classification filters. Use the internal classification by default.
locationsarrayoptionalSearch in the company address. Multiple locations are combined as OR.
page_cursorstringoptionalCursor for pagination. Use this value to fetch the next page of results.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
revenueobjectoptionalDefines a revenue range filter. Specify at least one of min or max.
search_termsarrayoptionalList of strings to match against company name, alternative names, trade name and domain(s).
leadfeedermcp_search_companies_signals#Retrieve signals for a specified set of company IDs. The response returns the signals linked to the provided companies. Credits are charged 1 per company if the company has signals and there was no active deep data access within the last 12 months. Pagination: pass page_cursor from meta.pagination.next_cursor to fetch the next page.7 params

Retrieve signals for a specified set of company IDs. The response returns the signals linked to the provided companies. Credits are charged 1 per company if the company has signals and there was no active deep data access within the last 12 months. Pagination: pass page_cursor from meta.pagination.next_cursor to fetch the next page.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
company_idsarrayrequiredArray of company IDs to filter signals for (mandatory).
categoriesarrayoptionalFilter to search for signals in specific categories.
event_dateobjectoptionalFilter signals by event date (YYYY-MM-DD). If both from and to are provided, from must be earlier than or equal to to.
page_cursorstringoptionalCursor for pagination. Use this value to fetch the next page of results.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
publication_dateobjectoptionalFilter signals by publication date (YYYY-MM-DD). If both from and to are provided, from must be earlier than or equal to to.
leadfeedermcp_search_contacts#Search for contacts using filters such as name, email, company, or other attributes.12 params

Search for contacts using filters such as name, email, company, or other attributes.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
affiliationstringoptionalDetermines how the contact is related to the company.
buyer_persona_idsarrayoptionalList of buyer persona IDs to use as a filter.
company_idsarrayoptionalFilter contacts by Leadfeeder company IDs.
departmentsarrayoptionalThe departments the contact works in within the company.
emailsarrayoptionalFilter contacts by email addresses.
filtersobjectoptionalFilter down search results (combined with AND).
hierarchy_levelsarrayoptionalFilter contacts by hierarchy level within the company.
page_cursorstringoptionalCursor for pagination. Use this value to fetch the next page of results.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
positionsarrayoptionalSearch in orig and en fields.
search_termsarrayoptionalSearch in contact fullname and title fields.
leadfeedermcp_search_web_visits#Search and filter web visit records to identify companies that visited your website.7 params

Search and filter web visit records to identify companies that visited your website.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
end_datestringrequiredThe end of the date range to search (inclusive). Must be a valid ISO 8601 date.
start_datestringrequiredThe start of the date range to search (inclusive). Must be a valid ISO 8601 date.
filtersobjectoptionalOptional filters to narrow visit records by company ID or visitor location.
includestringoptionalSpecify which additional data should be attached to the result.
page_numintegeroptionalPage of results to fetch.
page_sizeintegeroptionalThe number of items per page. Maximum is 100.
leadfeedermcp_unassign_tags_from_company#Remove one or more tags from a Leadfeeder company.3 params

Remove one or more tags from a Leadfeeder company.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataarrayrequiredArray of tag references to unassign from the company.
idstringrequiredThe company's ID. Note that the older string-based ID format continues to be supported.
leadfeedermcp_update_campaign#Update the settings or configuration of an existing campaign.3 params

Update the settings or configuration of an existing campaign.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredCampaign update payload containing attributes and optional relationships to modify.
idstringrequiredThe campaign ID.
leadfeedermcp_update_custom_field#Update the definition of an existing custom field.3 params

Update the definition of an existing custom field.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredThe request body containing updated custom field attributes.
idstringrequiredThe custom field internal name.
leadfeedermcp_update_list#Update the name of a list. Credit Note: Updating list name does not consume credits. Requires the `lists:write` OAuth2 scope.3 params

Update the name of a list. Credit Note: Updating list name does not consume credits. Requires the `lists:write` OAuth2 scope.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredList update payload with required type and attributes fields.
idstringrequiredThe list ID.
leadfeedermcp_update_tag#Update the name or settings of an existing tag.3 params

Update the name or settings of an existing tag.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
dataobjectrequiredThe request body containing updated tag attributes.
idstringrequiredThe tag ID.
leadfeedermcp_update_web_visits_custom_feed#Update the configuration of an existing web visit custom feed.3 params

Update the configuration of an existing web visit custom feed.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
custom_feed_idstringrequiredThe ID of the custom feed to update.
dataobjectrequiredThe update payload containing type and attributes to modify.
leadfeedermcp_usage#Retrieve current API usage and credit consumption for a Leadfeeder account.3 params

Retrieve current API usage and credit consumption for a Leadfeeder account.

NameTypeRequiredDescription
account_idstringrequiredThe Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
end_periodstringrequiredThe ending month for the usage period, formatted as YYYY-MM. Must be greater than or equal to start_period.
start_periodstringrequiredThe starting month for the usage period, formatted as YYYY-MM.