Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Validity Everest

Scalekit connector
Open markdown

The Validity Everest connector lets your AI agent act in each user's Validity Everest account. Each user connects their own Validity Everest API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 65 tools.

Tools
65
What they doRead · write · destructive
54 · 7 · 454 read7 write4 destructive
Users sign in with

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 Validity Everest connection

    In AgentKit > Connections, create a Validity Everest connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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 = 'everest'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Validity Everest:', 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: 'everest_blocklist_listings_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Validity Everest credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • everest_blocklist_listings_listList blocklist listings of your monitored IPs and domains.Read-only

    List Blocklist Listings

    List blocklist listings of your monitored IPs and domains. Returns each listing with the item, blocklist, profile, listed and delisted dates, and links to related resources. Use everest_blocklist_listings_list to see what is on a blocklist now (status current) or what was resolved. Use everest_reputation_profiles_list for per-profile issue counts.

    Inputs

    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    limitinteger
    Results per page (default 500). Example: 500.
    pageinteger
    Page number, starting at 1. Example: 1.
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
    statusstring
    all, current (still listed) or resolved (delisted). Default all. Example: current.one of allcurrentresolved
  • everest_blocklists_listList the IP and domain blocklists Everest monitors.Read-only

    List Blocklists

    List the IP and domain blocklists Everest monitors. Returns each blocklist with its ID, name, type (ip or domain) and description. Use everest_blocklists_list to pick blocklist IDs for everest_reputation_profile_create. Use everest_blocklist_listings_list for your own listings.

    Inputs

    typestring
    Only ip or domain blocklists. Leave empty for both. Example: ip.one of ipdomain
  • everest_dmarc_domain_dkimdomains_listList DMARC data for a domain: each DKIM signing domain seen with volume and DKIM results.Read-only

    List DMARC DKIM Domains

    List DMARC data for a domain: each DKIM signing domain seen with volume and DKIM results. Returns each DKIM signing domain seen with volume and DKIM results for the date range, paginated. Use everest_dmarc_domain_dkimdomains_list to check which DKIM signatures align with the domain. Use everest_dmarc_domain_get for the domain's overview.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    classificationarray
    Only mail with these DMARC classifications: compliant, non-compliant, unauthenticated. Example: ["non-compliant", "unauthenticated"].
    dkimdomainstring
    Only mail with this DKIM domain. Example: mail.example.com.
    dkimresultstring
    Only mail with this DKIM result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    forwardedstring
    include or exclude forwarded mail. Forwarded mail with a valid ARC chain (arc=pass) had SPF or DKIM validated before forwarding. Example: exclude.one of includeexclude
    ipstring
    Only mail from this IP. Example: 192.0.2.10.
    limitinteger
    Results per page (default 100). Example: 100.
    mailoriginstring
    Only mail from this origin (sending service domain). Example: gmail.com.
    pageinteger
    Page number, starting at 1. Example: 1.
    spfdomainstring
    Only mail with this SPF domain. Example: mail.example.com.
    spfresultstring
    Only mail with this SPF result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
  • everest_dmarc_domain_dkimresults_listList DMARC data for a domain: DKIM failures grouped by result and source.Read-only

    List DMARC DKIM Authentication Issues

    List DMARC data for a domain: DKIM failures grouped by result and source. Returns DKIM failures grouped by result and source for the date range, paginated. Use everest_dmarc_domain_dkimresults_list to find DKIM problems. Use everest_dmarc_domain_get for the domain's overview.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    classificationarray
    Only mail with these DMARC classifications: compliant, non-compliant, unauthenticated. Example: ["non-compliant", "unauthenticated"].
    dkimdomainstring
    Only mail with this DKIM domain. Example: mail.example.com.
    dkimresultstring
    Only mail with this DKIM result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    forwardedstring
    include or exclude forwarded mail. Forwarded mail with a valid ARC chain (arc=pass) had SPF or DKIM validated before forwarding. Example: exclude.one of includeexclude
    ipstring
    Only mail from this IP. Example: 192.0.2.10.
    limitinteger
    Results per page (default 100). Example: 100.
    mailoriginstring
    Only mail from this origin (sending service domain). Example: gmail.com.
    pageinteger
    Page number, starting at 1. Example: 1.
    spfdomainstring
    Only mail with this SPF domain. Example: mail.example.com.
    spfresultstring
    Only mail with this SPF result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
  • everest_dmarc_domain_geolocation_listList DMARC data for a domain: mail volume and DMARC results by country, region and city.Read-only

    List DMARC Geolocation

    List DMARC data for a domain: mail volume and DMARC results by country, region and city. Returns mail volume and DMARC results by country, region and city for the date range, paginated. Use everest_dmarc_domain_geolocation_list to see where mail claiming the domain comes from. Use everest_dmarc_domain_get for the domain's overview.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    citystring
    Only mail from this city. Example: San Francisco.
    classificationarray
    Only mail with these DMARC classifications: compliant, non-compliant, unauthenticated. Example: ["non-compliant", "unauthenticated"].
    countrystring
    Only mail from this country (code or name). Example: US.
    dkimdomainstring
    Only mail with this DKIM domain. Example: mail.example.com.
    dkimresultstring
    Only mail with this DKIM result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    forwardedstring
    include or exclude forwarded mail. Forwarded mail with a valid ARC chain (arc=pass) had SPF or DKIM validated before forwarding. Example: exclude.one of includeexclude
    ipstring
    Only mail from this IP. Example: 192.0.2.10.
    limitinteger
    Results per page (default 100). Example: 100.
    mailoriginstring
    Only mail from this origin (sending service domain). Example: gmail.com.
    pageinteger
    Page number, starting at 1. Example: 1.
    regionstring
    Only mail from this region or state. Example: California.
    spfdomainstring
    Only mail with this SPF domain. Example: mail.example.com.
    spfresultstring
    Only mail with this SPF result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
  • everest_dmarc_domain_getGet a DMARC-monitored domain's overview for a date range.Read-only

    Get DMARC Domain Overview

    Get a DMARC-monitored domain's overview for a date range. Returns the domain's DMARC, SPF and DKIM records and policy, total volume, and compliant, non-compliant and unauthenticated shares. Use everest_dmarc_domain_get for one domain's health. Use everest_dmarc_domain_mail_origins_list to see who sends as the domain.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
  • everest_dmarc_domain_ips_listList DMARC data for a domain: each sending IP with volume, reverse DNS and DMARC, SPF and DKIM results.Read-only

    List DMARC IP Addresses

    List DMARC data for a domain: each sending IP with volume, reverse DNS and DMARC, SPF and DKIM results. Returns each sending IP with volume, reverse DNS and DMARC, SPF and DKIM results for the date range, paginated. Use everest_dmarc_domain_ips_list to find the IPs sending as the domain. Use everest_dmarc_domain_get for the domain's overview.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    classificationarray
    Only mail with these DMARC classifications: compliant, non-compliant, unauthenticated. Example: ["non-compliant", "unauthenticated"].
    dkimdomainstring
    Only mail with this DKIM domain. Example: mail.example.com.
    dkimresultstring
    Only mail with this DKIM result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    forwardedstring
    include or exclude forwarded mail. Forwarded mail with a valid ARC chain (arc=pass) had SPF or DKIM validated before forwarding. Example: exclude.one of includeexclude
    ipstring
    Only mail from this IP. Example: 192.0.2.10.
    limitinteger
    Results per page (default 100). Example: 100.
    mailoriginstring
    Only mail from this origin (sending service domain). Example: gmail.com.
    pageinteger
    Page number, starting at 1. Example: 1.
    spfdomainstring
    Only mail with this SPF domain. Example: mail.example.com.
    spfresultstring
    Only mail with this SPF result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.
  • everest_dmarc_domain_mailorigins_listList DMARC data for a domain: each sending source (mail origin) with volume and DMARC, SPF and DKIM results.Read-only

    List DMARC Mail Origins

    List DMARC data for a domain: each sending source (mail origin) with volume and DMARC, SPF and DKIM results. Returns each sending source (mail origin) with volume and DMARC, SPF and DKIM results for the date range, paginated. Use everest_dmarc_domain_mailorigins_list to find services sending as the domain, authorized or not. Use everest_dmarc_domain_get for the domain's overview.

    Inputs

    domainstringrequired
    The DMARC-monitored domain, without a scheme. Example: example.com.
    classificationarray
    Only mail with these DMARC classifications: compliant, non-compliant, unauthenticated. Example: ["non-compliant", "unauthenticated"].
    dkimdomainstring
    Only mail with this DKIM domain. Example: mail.example.com.
    dkimresultstring
    Only mail with this DKIM result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    enddatestring
    End of the date range, YYYY-MM-DD (or YYYY-MM-DD HH:MM:SS, UTC). Defaults to today. Example: 2026-10-31.
    forwardedstring
    include or exclude forwarded mail. Forwarded mail with a valid ARC chain (arc=pass) had SPF or DKIM validated before forwarding. Example: exclude.one of includeexclude
    ipstring
    Only mail from this IP. Example: 192.0.2.10.
    limitinteger
    Results per page (default 100). Example: 100.
    mailoriginstring
    Only mail from this origin (sending service domain). Example: gmail.com.
    pageinteger
    Page number, starting at 1. Example: 1.
    spfdomainstring
    Only mail with this SPF domain. Example: mail.example.com.
    spfresultstring
    Only mail with this SPF result: none, pass, fail, softfail, temperror or permerror. Example: fail.one of nonepassfailsoftfailtemperrorpermerror
    startdatestring
    Start of the date range, YYYY-MM-DD (a time can follow, YYYY-MM-DD HH:MM:SS, UTC). Defaults to 30 days ago. Example: 2026-10-01.