Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Netcore

Scalekit connector
Open markdown

The Netcore connector lets your AI agent act in each user's Netcore account. Each user connects their own Netcore access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 33 tools.

Tools
33
What they doRead · write · destructive
14 · 13 · 614 read13 write6 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 Netcore connection

    In AgentKit > Connections, create a Netcore 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 = 'netcore'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Netcore:', 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: 'netcore_stats_get',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Netcore 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
  • netcore_domain_dns_records_getGet the DNS records (SPF, DKIM and custom envelope) you must publish to activate a sending domain.Read-only

    Get Domain DNS Records

    Get the DNS records (SPF, DKIM and custom envelope) you must publish to activate a sending domain. Returns each record's type, host and expected value. Use this while setting up DNS. Use netcore_domain_verify after publishing the records.

    Inputs

    domainstringrequired
    Sending domain. Example: mail.example.com
    on_behalf_ofstring
    Username of a subaccount to run the lookup for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
  • netcore_domain_getGet the configuration and status of one sending domain: DNS setup, tracking settings and verification status.Read-only

    Get Domain Settings

    Get the configuration and status of one sending domain: DNS setup, tracking settings and verification status. Returns the domain's settings and status flags. Use this to check a domain's state. Use netcore_domain_dns_records_get for the DNS records to publish.

    Inputs

    domain_namestringrequired
    Sending domain to look up. Example: mail.example.com
    on_behalf_ofstring
    Username of a subaccount to run the lookup for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
  • netcore_messages_listList email event logs (processed, sent, open, click, bounce, unsubscribe, spam, dropped and more) for a time range, filtered by recipient, sender, subject, tag or message ID.Read-only

    List Email Event Logs

    List email event logs (processed, sent, open, click, bounce, unsubscribe, spam, dropped and more) for a time range, filtered by recipient, sender, subject, tag or message ID. Returns event records with message_id, recipient, sender, subject, event, timestamp and details, plus a scrollid for the next page. Use this to trace what happened to specific emails. Use netcore_stats_get for aggregated counts.

    Inputs

    event_start_datestringrequired
    Event time to start from, in YYYY-MM-DD HH:mm:ss format. Example: 2026-11-12 00:00:00
    start_datestringrequired
    Send date to start from. Date in YYYY-MM-DD format. Example: 2026-11-12
    custom_argsstring
    Only return events whose send carried this custom argument. Example: campaign=diwali
    emailstring
    Only return events for this recipient address. Example: john@example.com
    end_datestring
    Send date to end at. Date in YYYY-MM-DD format. Example: 2026-11-13
    event_end_datestring
    Event time to end at, in YYYY-MM-DD HH:mm:ss format. Example: 2026-11-13 23:59:59
    eventsarray
    Only return these event types. Example: ["bounce", "dropped"]
    fromaddressstring
    Only return events for this sender address. Example: info@mail.example.com
    fromdomainstring
    Only return events for this sending domain. Example: mail.example.com
    limitinteger
    Records per page, up to 1000. Defaults to 50. Example: 100
    message_idstring
    Only return events for this message ID (from netcore_email_send). Example: a1b2c3d4e5f6
    on_behalf_ofstring
    Username of a subaccount to run the log query for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
    recipient_domainstring
    Only return events for recipients at this domain. Example: gmail.com
    scrollidstring
    Scroll ID from the previous page, to fetch the next page. Example: DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAA
    sortstring
    Sort by send time. Defaults to asc. Example: descone of ascdesc
    subjectstring
    Only return events for emails with this subject. Example: Your order has shipped
    tagsstring
    Only return events for emails with this tag. Example: order-shipped
  • netcore_stats_getGet summary email statistics (requests, delivered, opens, clicks, bounces, unsubscribes, spam reports and more) for a date range, updated hourly.Read-only

    Get Email Statistics

    Get summary email statistics (requests, delivered, opens, clicks, bounces, unsubscribes, spam reports and more) for a date range, updated hourly. Returns counts grouped by day, week, month, tag, sending domain, recipient domain, sender address or subaccount. Use this for totals and trends. Use netcore_messages_list for per-message event logs.

    Inputs

    aggregated_bystring
    How to group the numbers. Defaults to day. Example: dayone of dayweekmonthtagfromdomainrecipientdomainfromaddresssubaccount
    end_datestring
    End of the range; defaults to today. Date in YYYY-MM-DD format. Example: 2026-11-13
    on_behalf_ofstring
    Username of a subaccount to run the statistics for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
    start_datestring
    Start of the range. Date in YYYY-MM-DD format. Example: 2026-11-01
  • netcore_subaccount_credits_getGet a subaccount's current email credit balance and credit settings.Read-only

    Get Subaccount Credits

    Get a subaccount's current email credit balance and credit settings. Returns the credit type, available credits and any recurring credit settings. Use this to check whether a subaccount can still send.

    Inputs

    usernamestringrequired
    Subaccount username. Example: brand-a-subaccount
  • netcore_subaccounts_listList the subaccounts of your master account, optionally filtered by username.Read-only

    List Subaccounts

    List the subaccounts of your master account, optionally filtered by username. Returns subaccounts with username, email, status and credit type. Use this to find a subaccount's username for on_behalf_of or the other subaccount tools.

    Inputs

    limitinteger
    Records to return, up to 1000. Defaults to 10. Example: 50
    offsetinteger
    Records to skip. Defaults to 0. Example: 0
    usernamestring
    Only return the subaccount with this username. Example: brand-a-subaccount
  • netcore_suppressed_domain_getCheck whether one domain is on the suppression list.Read-only

    Get Domain Suppression Status

    Check whether one domain is on the suppression list. Returns the domain's suppression status with the date it was first added and last modified. Use this for one domain. Use netcore_suppressed_domains_list to browse all suppressed domains.

    Inputs

    domainstringrequired
    Domain to check. Example: example.org
    on_behalf_ofstring
    Username of a subaccount to run the lookup for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
  • netcore_suppressed_domains_listList domains on the suppression list, optionally filtered by the date they were last modified.Read-only

    List Suppressed Domains

    List domains on the suppression list, optionally filtered by the date they were last modified. Returns suppressed domains with their suppression dates. Use this to audit domain suppressions. Use netcore_suppressed_domain_get to check one domain.

    Inputs

    end_timestring
    Only domains modified on or before this date. Date in YYYY-MM-DD format. Example: 2026-11-13
    limitinteger
    Records to return, 1 to 1000. Example: 100
    offsetinteger
    Records to skip. Defaults to 0. Example: 0
    on_behalf_ofstring
    Username of a subaccount to run the lookup for. Only needed with a master account API key; leave empty to act on the account that owns the key. Example: brand-a-subaccount
    start_timestring
    Only domains modified on or after this date. Date in YYYY-MM-DD format. Example: 2026-10-01