Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the PredictLeads MCP server

Vendor MCP
Open markdown

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

Tools
35
What they doRead · write · destructive
33 · 1 · 133 read1 write1 destructive
Users sign in with
OAuth app
Your own PredictLeads 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 PredictLeads MCP connection

    In AgentKit > Connections, create a PredictLeads 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

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

    Then enter the app's Client ID and Client Secret on the PredictLeads 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 = 'predictleadsmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize PredictLeads 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: 'predictleadsmcp_get_api_v3_api_access',
    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
  • predictleadsmcp_get_api_v3_api_accessReturns the API access the request is made with, along with the monthly credits of its meter and of its subscription.Read-only

    PredictLeads Get API access information

    Returns the API access the request is made with, along with the monthly credits of its meter and of its subscription.

    Inputs

    This tool takes no inputs.

  • predictleadsmcp_get_api_v3_api_access_logsReturns a paginated list of API access log entries for the current subscription.Read-only

    PredictLeads Get API access logs

    Returns a paginated list of API access log entries for the current subscription.

    Inputs

    limitinteger
    Limit the number of shown items per page.default 100
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
    requested_at_fromstring
    Only return `ApiAccessLogs` requested after the given date (ISO 8601).
    requested_at_untilstring
    Only return `ApiAccessLogs` requested before the given date (ISO 8601).
  • predictleadsmcp_get_api_v3_companies_connectionsReturns a list of company's Connections.Read-only

    PredictLeads Get Connections

    Returns a list of company's Connections.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    categoriesarray
    One or more valid categories.
    first_seen_at_fromstring
    Only return `Connections` first seen after given date (ISO 8601).
    first_seen_at_untilstring
    Only return `Connections` first seen before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
  • predictleadsmcp_get_api_v3_companies_financing_eventsReturns a list of company's Financing Events.Read-only

    PredictLeads Get Financing Events

    Returns a list of company's Financing Events.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    first_seen_at_fromstring
    Only return `FinancingEvents` first seen after given date (ISO 8601).
    first_seen_at_untilstring
    Only return `FinancingEvents` first seen before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
  • predictleadsmcp_get_api_v3_companies_github_repositoriesReturns a list of company's Github Repositories.Read-only

    PredictLeads Get Github Repositories

    Returns a list of company's Github Repositories.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    first_seen_at_fromstring
    Only return `GithubRepositories` first seen after given date (ISO 8601).
    first_seen_at_untilstring
    Only return `GithubRepositories` first seen before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
  • predictleadsmcp_get_api_v3_companies_job_openingsReturns a list of company's Job Openings.Read-only

    PredictLeads Get Job Openings

    Returns a list of company's Job Openings.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    active_onlyboolean
    Set to true if you'd like to receive JobOpenings that are not closed, have last_seen_at more recent than 5 days and were found in the last year.
    categoriesarray
    One or more valid categories.
    first_seen_at_fromstring
    Only return `JobOpenings` first seen after given date (ISO 8601).
    first_seen_at_untilstring
    Only return `JobOpenings` first seen before given date (ISO 8601).
    last_seen_at_fromstring
    Only return `JobOpenings` last seen after given date (ISO 8601).
    last_seen_at_untilstring
    Only return `JobOpenings` last seen before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    locationstring
    The response will include only results in the given country name or state name/abbreviation.
    not_closedboolean
    Similar to `active_only`, but without considering `last_seen_at` timestamp.
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
    with_description_onlyboolean
    Only return JobOpenings that have description.
    with_location_onlyboolean
    Only return JobOpenings that have location.
  • predictleadsmcp_get_api_v3_companies_news_eventsReturns a list of company's News Events.Read-only

    PredictLeads Get News Events

    Returns a list of company's News Events.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    categoriesarray
    One or more valid categories.
    found_at_fromstring
    Only return `NewsEvents` found after given date (ISO 8601).
    found_at_untilstring
    Only return `NewsEvents` found before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    locationstring
    The response will include only results in the given country name or state name/abbreviation.
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
  • predictleadsmcp_get_api_v3_companies_productsReturns a list of company's Products.Read-only

    PredictLeads Get Products

    Returns a list of company's Products.

    Inputs

    company_id_or_domainstringrequired
    Company's ID or domain.
    categoriesarray
    One or more valid categories.
    first_seen_at_fromstring
    Only return `Products` first seen after given date (ISO 8601).
    first_seen_at_untilstring
    Only return `Products` first seen before given date (ISO 8601).
    limitinteger
    Limit the number of shown items per page.default 100
    pageinteger
    Page number of shown items. <br> **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. default 1
    subcategoriesarray
    One or more valid subcategories.