Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Leadfeeder MCP server

Vendor MCP
Open markdown

The Leadfeeder MCP connector routes your AI agent's tool calls to Leadfeeder's own MCP server through Scalekit. Each user signs in to Leadfeeder once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 58 tools.

Tools
58
What they doRead · write · destructive
37 · 17 · 437 read17 write4 destructive
Users sign in with
OAuth app
Your own Leadfeeder MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. 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. Create the Leadfeeder MCP connection

    In AgentKit > Connections, create a Leadfeeder MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Leadfeeder MCP server connections use your own OAuth app. Register one with Leadfeeder MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Leadfeeder MCP connection.

  5. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_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 MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'leadfeedermcp_get_current_user_info',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • leadfeedermcp_enrich_ipLook up company information associated with a given IP address.Read-only

    EnrichIp

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

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    ipstringrequired
    A valid IPv4 or IPv6 address to enrich with company information.
  • leadfeedermcp_estimate_company_enrichment_jobEstimate the credit cost of a company enrichment job before running it.Read-only

    EstimateCompanyEnrichmentJob

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

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    dataobjectrequired
    Enrichment job estimate parameters including attributes that specify the target companies and custom field to enrich.
  • leadfeedermcp_estimate_find_contact_data_jobEstimate the credit cost for enriching contacts with email and phone data.Read-only

    EstimateFindContactDataJob

    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.

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    dataobjectrequired
    Job definition object. Must include an 'attributes' field with either contact_ids or list_id.
  • leadfeedermcp_get_account_infoRetrieves a list of Leadfeeder accounts associated with this API key.Read-only

    GetAccountInfo

    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.

    Inputs

    account_idstring
    The 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_personaRetrieve a specific buyer persona by ID.Read-only

    GetBuyerPersona

    Retrieve a specific buyer persona by ID.

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    idstringrequired
    The buyer persona ID.
  • leadfeedermcp_get_buyer_personasRetrieve all buyer personas defined in a Leadfeeder account.Read-only

    GetBuyerPersonas

    Retrieve all buyer personas defined in a Leadfeeder account.

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
  • leadfeedermcp_get_campaignRetrieve details of a specific campaign by ID.Read-only

    GetCampaign

    Retrieve details of a specific campaign by ID.

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    idstringrequired
    The campaign ID.
    includestring
    Comma-separated list of related resources to inline. Supported: campaign_summary, campaign_settings, campaign_locations, list, custom_feed.
  • leadfeedermcp_get_campaign_statsRetrieve performance statistics for a specific campaign.Read-only

    GetCampaignStats

    Retrieve performance statistics for a specific campaign.

    Inputs

    account_idstringrequired
    The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
    end_periodstringrequired
    Inclusive end of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or after start_period.
    frequencystringrequired
    Bucket granularity for the returned stats series.one of dayweekmonth
    idstringrequired
    The campaign ID.
    start_periodstringrequired
    Inclusive start of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or before end_period.
    page_numinteger
    Page of results to fetch.
    page_sizeinteger
    The number of items per page. Maximum is 100.default 20
All 97 in CRM & Sales