1. AI & MCP (Beta)
Leadfeeder API
  • Leadfeeder API
  • Authentication
  • Getting Started
  • Rate Limits
  • Relationships
  • Company ID Lifecycle
  • OpenAPI Specification Access
  • List of NACE / WZ codes
  • List of Industries
  • AI & MCP (Beta)
    • Overview of the Leadfeeder MCP Server
    • Quickstart
    • Connect your AI tool
    • Authentication and permissions
  • Account
    • List Accounts
  • Companies
    • Get Company Details
    • Create Company Enrichment Job
    • Estimate Company Enrichment Job
    • Retrieve Companies
    • Company Financial Reports
    • Get Company Enrichment Job Status
    • Retrieve Company IPs
    • Match Companies
    • Search Companies
    • Search Company Signals
    • Update a Company
    • Remove Company from Lists
    • Add Company to Lists
    • Unassign Tags from Company
    • Assign Tags to Company
  • Contacts
    • Get Contact Details
    • Create Find Contact Data Job
    • Estimate Find Contact Data Job
    • Retrieve Contacts
    • Get Find Contact Data Job Status
    • Search Contacts
    • Update a Contact
    • Remove Contact from Lists
    • Add Contact to Lists
  • Web Visits
    • How to Create Custom Feed
    • Custom Feed - Filter Reference
    • Search Web Visits
    • Retrieve Custom Feeds
    • Retrieve Visitor Companies
    • Create a Custom Feed
    • Get Custom Feed Details
    • Update Custom Feed
    • Delete a Custom Feed
    • Retrieve Custom Feeds Folders
    • Retrieve Web Visits Tracker Script
  • Campaigns
    • Retrieve Campaigns
    • Get Campaign Details
    • Update Campaign
    • Retrieve Campaign Stats
  • IP
    • Enrich Company IP Address
  • Buyer Personas
    • Retrieve Buyer Personas
    • Create a Buyer Persona
    • Get Buyer Persona Details
    • Update a Buyer Persona
    • Delete a Buyer Persona
  • Ideal Customer Profiles
    • Retrieve Ideal Customer Profiles
    • Create an Ideal Customer Profile
    • Retrieve Company ICP Matches
    • Delete an Ideal Customer Profile
    • Get Ideal Customer Profile Details
    • Update an Ideal Customer Profile
  • Tags
    • Retrieve Tags
    • Create Tag
    • Create Batch Add Tags Job
    • Get Batch Add Tags Job
    • Create Batch Remove Tags Job
    • Delete Tag
    • Get Batch Remove Tags Job
    • Get Tag Details
    • Update Tag
  • Lists
    • Retrieve Lists
    • Create a List
    • Create Batch Add to List Job
    • Get List Details
    • Get Batch Add to List Job
    • Delete List
    • Create Batch Remove from List Job
    • Get Batch Remove from List Job
    • Retrieve Company List Memberships
    • Retrieve Contact List Memberships
    • Update List
    • Retrieve List Items
  • Custom Fields
    • Retrieve Custom Fields
    • Create Custom Field
    • Get Custom Field Details
    • Delete Custom Field
    • Update Custom Field
  • Users
    • Get Current User
  • Usage
    • Get Endpoints Usage
  • Reference Data
    • Get Geo Suggestions
    • Get Countries with Regions
  • Settings
    • Update Cookie Consent Settings
    • Get Data Processing Settings
    • Get Cookie Consent Settings
    • Update Data Processing Settings
  • Schemas
    • AccountCompanyV1
    • AccountSummaryV1
    • AccountV1
    • ApiUsageV1
    • BatchAddTagsJobV1
    • BatchAddToListJobV1
    • BatchRemoveFromListJobV1
    • BatchRemoveTagsJobV1
    • BuyerPersonaRequestV1
    • BuyerPersonaV1
    • CampaignLocationV1
    • CampaignSettingsV1
    • CampaignStatsV1
    • CampaignSummaryV1
    • CampaignV1
    • CompaniesAdvancedSearchFilterItem
    • CompanyFinancialsV1
    • CompanyIpV1
    • CompanyLocationV1
    • CompanyMatchV1
    • CompanySummaryV1
    • CompanyV1
    • ContactFilterGroupsV1
    • ContactSummaryV1
    • ContactV1
    • CookieConsentSettingsV1
    • CountryV1
    • CustomFeedFolderV1
    • CustomFeedRequestV1
    • CustomFeedV1
    • CustomFieldV1
    • DataProcessingSettingsV1
    • CRMUserV1
    • EnrichedIpV1
    • EnrichmentJobV1
    • CRMOrganizationV1
    • ErrorObjectV1
    • CRMContactV1
    • FindContactDataJobV1
    • GeoSuggestionV1
    • ICPV1
    • CRMLeadV1
    • IcpRequestV1
    • CRMConnectionV1
    • IpAddressExtendedV1
    • CRMSuggestionV1
    • IpLocationV1
    • ListV1
    • CRMGroupConnectionV1
    • LocationV1
    • MaskedCompanySummaryV1
    • MaskedContactSummaryV1
    • NetworkV1
    • SignalV1
    • TagV1
    • UserV1
    • VisitLocationV1
    • WebVisitV1
    • WebVisitsTrackerScriptV1
  1. AI & MCP (Beta)

Authentication and permissions

🧪
Beta. The Leadfeeder MCP Server is in beta. Setup steps and the available tools may change.
The MCP Server uses your own Leadfeeder account to authenticate. When you connect from an AI tool, you sign in to Leadfeeder through a secure OAuth flow and approve access. The AI tool never sees your password, and you do not paste an API key into it.
The Leadfeeder REST API supports the same OAuth flow, alongside API key authentication. The difference is that the MCP Server handles the sign-in for you, so there is no application to register and no token exchange to implement. If you are building your own integration against the REST API, see Authentication.

What you are granting#

When you approve access, the AI tool can call Leadfeeder tools on your behalf, limited to what your account can already do. That includes reading data and, for some tools, writing data such as lists, tags, and custom fields. Actions that change data ask you to confirm before they run.

Choosing an account#

If you have access to more than one Leadfeeder account, you choose which account to use during sign-in.
You can also copy the account ID by navigating to the following link https://app.leadfeeder.com/l/settings/website/

Permissions and credits#

Access through the MCP Server follows the same permissions and credit rules as your account. The server cannot do anything your account cannot, and credit-consuming tools draw on the same credit balance as the API.
There is one access right you need before you can connect. Your user must have the "Manage API keys and use API" access right for the "Integrations" product. This is the same access right that controls API key generation and API use on the REST API. Without it, sign-in will not complete and you will not be able to call any Leadfeeder tools from your AI tool.
INFO
If connect does not complete, you are likely missing the "Manage API keys and use API" access right for the "Integrations" product. Ask your admin to grant it, then connect again.

Disconnecting#

You can disconnect at any time from your AI tool's connector settings, or revoke access in your Leadfeeder account settings.
NOTE
When you add the connector, the AI tool connects to Leadfeeder from the AI provider's cloud, not from your own computer. The server is reachable on the public internet, so this works by default. A private or VPN-only endpoint would not connect.
Connect your AI tool
Step-by-step setup for each supported tool.
MCP Server
An overview on the MCP Server.
Modified at 2026-08-24 12:19:35
Previous
Connect your AI tool
Next
List Accounts
Built with