Neutrino API provides a suite of general-purpose APIs for various tasks, including data validation, geolocation, and security.
Neutrino API provides a suite of general-purpose APIs for various tasks, including data validation, geolocation, and security. On Nagent, Neutrino is exposed as a fully-configurable developer tools integration that any agent can call — 24 actions, and API key authentication. No code is required to wire Neutrino into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Neutrino to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Neutrino into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Neutrino, with input parameters and output schema. Drop these into any step of an agent built in Helix.
NEUTRINO_ADD_WATERMARK_TO_IMAGEAdd a watermark to an image with customizable position, opacity, and output format. Use when you need to overlay a logo, text image, or branding on photos or graphics. Supports resizing the output and multiple positioning options.
Input parameters
If set, resize the resulting image to this width (in pixels). Used with resize-mode.
Output image format options.
If set, resize the resulting image to this height (in pixels). Used with resize-mode.
The opacity of the watermark from 0 (transparent) to 100 (opaque). Defaults to 50.
Background color in hexadecimal notation (e.g. '#0000ff') or 'transparent' for PNG. Used when resize-mode is 'pad'. For JPG output the default is black (#000000).
Position options for watermark placement.
The URL or Base64 encoded Data URL for the source image. You can encode an image to Base64 if needed.
Resize mode options when resizing the output image.
The URL or Base64 encoded Data URL for the watermark image. This will be overlaid on the source image.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_BAD_WORD_FILTERTool to detect bad words and profanity in text. Use when scanning content for swear words.
Input parameters
Which catalog of bad words to use. 'strict' is the largest database including profanity, obscenity, sexual, rude, cuss, dirty, swear words (suitable for all audiences). 'obscene' excludes mild profanities and is suitable for adult environments.
The content to scan (plain text or HTML).
Optional JSONP callback function name.
ISO 639 language code, default is 'en'.
The character to use for censoring bad words, default is '*'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_BIN_LOOKUPPerform a BIN (Bank Identification Number) lookup to retrieve comprehensive card issuer information. This tool identifies the card brand (VISA, MASTERCARD, AMEX, etc.), card type (debit/credit), issuer details, and issuer country from the first 6-8 digits of a card number. Optionally performs fraud detection by comparing the customer's IP geolocation with the card issuer country. Use cases: - Payment fraud detection and prevention - Card validation before processing transactions - Geographic risk assessment for e-commerce - Card type identification for routing payments The database contains ~2.5 million BIN records covering all major card issuers globally and is updated weekly.
Input parameters
The BIN (Bank Identification Number) or IIN (Issuer Identification Number) - typically the first 6-8 digits of a credit/debit card number. Supports 6, 8, and 10-digit BINs.
Optional customer IP address (IPv4 or IPv6) for additional fraud detection. When provided, the response includes IP geolocation data and checks if the IP country matches the BIN issuer country.
Response field name casing style. Use 'camelCase' for JavaScript/JSON standard format or 'snake_case' for Python-friendly format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_CHECK_IP_BLOCKLISTCheck if an IP address is on a blocklist. Detect IPs associated with malware, anonymous proxies, TOR exit nodes, botnets, spam sources and malicious servers. Use when you need to verify if an IP address is known to be malicious or part of a threat network.
Input parameters
An IPv4 or IPv6 address. Accepts standard IP notation (with or without port number), CIDR notation and IPv6 compressed notation. If multiple IPs are passed using comma-separated values the first non-bogon address on the list will be checked
Include public VPN provider IP addresses. NOTE: For more advanced VPN detection including the ability to identify private and stealth VPNs use the IP Probe API
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_CONVERTTool to perform unit and currency conversions. Use when you need to convert a value from one unit or currency to another. Example: convert 100 USD to EUR.
Input parameters
The unit or currency code to convert to (e.g., 'EUR', 'm', 'gram').
The unit or currency code of the input value (e.g., 'USD', 'kg', 'mile').
The numeric value (as a string) to convert from.
Optional date for historical exchange rates. Formats: YYYY-MM-DD, YYYY-MM, or YYYY. If not provided, uses current rates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_EMAIL_VALIDATEValidates and analyzes email addresses for syntax, domain validity, DNS/MX records, and detects freemail/disposable providers. This tool performs comprehensive email validation including: - RFC822/RFC2822 syntax compliance checking - Domain existence and DNS verification - Mail exchange (MX) record validation - Detection of free email providers (Gmail, Yahoo, etc.) - Identification of disposable/temporary email services - Optional automatic typo correction for common domain mistakes Important: This does NOT verify if a specific email address/mailbox actually exists with the provider. For mailbox verification, use the EMAIL_VERIFY action instead. Use this tool when you need to validate email addresses before sending, check email quality, or filter out disposable addresses.
Input parameters
The email address to validate (e.g., 'user@example.com').
Whether to automatically fix common typos in domain names (e.g., 'gmial.com' -> 'gmail.com'). Defaults to false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_EMAIL_VERIFYTool to verify and analyze the deliverability of an email address. Use when you need SMTP-based validation before sending emails.
Input parameters
The email address to verify.
Automatically attempt to fix common typos in the address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_GEOCODE_ADDRESSTool to geocode an address. Use when you need geographic coordinates for an address or place name.
Input parameters
The full address or place name to geocode
ISO 2-letter country code to limit results
Enable enhanced matching for misspelled addresses
ISO 2-letter language code for result translation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_GEOCODE_REVERSEConvert geographic coordinates (latitude/longitude) into real-world address information. Returns comprehensive location data including formatted addresses, administrative boundaries, timezone information, and location metadata. Useful for translating GPS coordinates into human-readable locations or enriching location data with regional details. The zoom parameter controls detail level: 'address' returns building-level precision, while 'city' or 'country' returns broader geographic information.
Input parameters
The zoom level to control address detail precision. Options: 'address' (most detailed, default), 'street', 'city', 'state', or 'country' (least detailed)
The location latitude in decimal degrees format
The location longitude in decimal degrees format
Limit results to a specific country using ISO 2-letter country code
The language to display results in (ISO 639-1 code). Supported: ar, de, en, es, fr, it, ja, nl, pt, ru, zh. Default is 'en'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_HLR_LOOKUPPerform real-time HLR (Home Location Register) lookup to validate mobile numbers and retrieve detailed network information. This tool connects to the global mobile cellular network to check if a mobile number is active, registered, and reachable. It provides comprehensive details including carrier information, porting status, roaming status, and network identifiers (MCC, MNC, IMSI). Use this tool to: - Validate that a mobile number is currently active and registered on a network - Determine the current carrier and check if a number has been ported - Check device reachability and roaming status in real-time - Retrieve mobile network identifiers (MCC, MNC, IMSI) for telecom operations Note: Numbers must be in international format (e.g., +447911123456) or provide a country-code parameter.
Input parameters
Optional IP address to provide additional geographic context for the lookup. Can enhance location data in the response.
Phone number to lookup. Should be in international format with + prefix (e.g., +447911123456). If not in international format, must provide country-code parameter.
ISO 2-letter country code (e.g., 'GB', 'US', 'FR'). Required only if number is not in international format (without + prefix). Helps the API determine the correct country for non-international numbers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_HOST_REPUTATIONCheck if an IP address, domain, or URL is listed on DNS-based Blackhole Lists (DNSBLs). DNSBLs track IPs and domains associated with spam, malware, proxies, and other malicious activity. This action queries 150+ DNSBLs to determine if a host has a bad reputation. Useful for: - Email spam filtering and sender reputation checks - Security threat assessment - Identifying compromised or malicious hosts Note: This performs realtime DNS lookups and may take 5-20 seconds to complete.
Input parameters
The IP address, domain name, or URL to check.
Comma-separated list of DNSBL zones to check. If omitted all relevant zones are checked.
Filter to DNSBLs with this quality rating or better. Rating scale: 1 (most reliable/reputable), 2 (moderate), 3 (all lists). Default is 3 if omitted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_HTML_CLEANTool to clean and sanitize untrusted HTML. Use when you need to strip or neutralize unwanted tags and attributes before rendering.
Input parameters
The HTML content to clean. This can be a URL to load HTML from or an HTML content string.
The output format: 'plain-text' (text only, no HTML tags), 'simple-text' (basic text formatting like b, em, i, strong, u), 'basic-html' (advanced text formatting and hyperlinks), 'basic-html-with-images' (basic-html plus image tags), 'advanced-html' (includes tables, lists, pre tags, etc.).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_HTML_RENDERRender HTML content to PDF, PNG, or JPG format. Converts HTML strings or URLs into downloadable files with extensive customization options including page size, margins, headers/footers, and JavaScript execution.
Input parameters
Inject custom CSS into the HTML before rendering.
Execute custom JavaScript before rendering. Supports functions: click(), focus(), keys(), sleep(), enter(), tab().
Zoom factor for rendering. 2.0 doubles the size, 0.5 halves it. Default is 1.0.
Delay in seconds to wait before rendering (useful for JavaScript-heavy pages). Default is 0.
The document title.
Footer HTML for each page. Supports variables: {date}, {title}, {url}, {pageNumber}, {totalPages}.
Output format: PDF, PNG, or JPG. Values are case-sensitive and must be uppercase. Default is 'PDF'.
Header HTML for each page. Supports variables: {date}, {title}, {url}, {pageNumber}, {totalPages}.
Document margin in millimeters for all sides. Default is 0.
The HTML content to render. Can be a URL to load from, a file upload, or an HTML content string.
Timeout in seconds for loading the content. Default is 300 seconds.
Background color in hex notation (e.g., '#FFFFFF'). Use 'transparent' for PNG with transparency.
Render the final document in grayscale. Default is false.
Enable landscape orientation for the document. Default is false (portrait).
Page size for PDF output. Options: A0-A9, B0-B10, Comm10E, DLE, or Letter. Default is 'A4'.
Top margin in millimeters. Default is 0.
PDF page width in millimeters. Overrides page-size width if specified.
Override the default browser User-Agent string.
Image width in pixels for PNG/JPG output. Default is 1024 pixels.
Left margin in millimeters. Default is 0.
PDF page height in millimeters. Overrides page-size height if specified.
Image height in pixels for PNG/JPG output. If not specified, height is calculated automatically.
Right margin in millimeters. Default is 0.
Bottom margin in millimeters. Default is 0.
Ignore TLS/SSL certificate errors when loading content. Default is false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_IMAGE_RESIZEResize, crop, and convert images to PNG or JPG format. Supports multiple resize modes (scale to preserve aspect ratio, pad with background color, or crop). Use when you need to adjust image dimensions, change format, or prepare images for specific size requirements. Supports GIF, ICO, JPEG, PNG, and TIFF input formats.
Input parameters
Raw image file bytes (max 10 MB). Supports GIF, ICO, JPEG, PNG, TIFF formats. Required if not providing 'image-url'.
Target width in pixels for the resized image (1-5000).
Output image format. Either 'png' or 'jpg'. Defaults to 'png'.
Target height in pixels for the resized image (1-5000). If not specified, height is auto-calculated to preserve aspect ratio.
Background color in hexadecimal notation (e.g. '#ffffff') or 'transparent' for PNG. Used when resize-mode is 'pad'. Defaults to 'transparent'.
The URL or Base64 encoded Data URL for the source image. Supports GIF, ICO, JPEG, PNG, TIFF formats (max 10 MB). Required if not providing 'image'.
Resize mode: 'scale' (preserve aspect ratio), 'pad' (fill space with bg-color), or 'crop' (centered crop). Defaults to 'scale'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_IP_INFOGet comprehensive geolocation and network information for an IPv4 or IPv6 address. Returns location data (country, region, city, coordinates), timezone information, and optionally reverse DNS hostname. Does NOT include VPN/proxy detection or user-agent parsing. For VPN detection, use the IP Probe action instead.
Input parameters
IPv4 or IPv6 address to look up (supports CIDR notation)
Enable reverse DNS (PTR) lookup to get hostname. May add latency to the request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_IP_PROBEAnalyzes an IPv4 or IPv6 address to extract detailed network intelligence including geolocation, ISP/hosting provider information, ASN details, and security flags (VPN, proxy, TOR detection). Performs live network scanning and service probes. Use when you need comprehensive IP address analysis beyond basic geolocation.
Input parameters
The IPv4 or IPv6 address to analyze
User-Agent string for device and browser detection
For domains, perform a DNS A record lookup
Perform a reverse DNS lookup to get hostname
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_LOOKUP_DOMAINTool to perform a domain lookup to retrieve WHOIS, DNS records, domain registration information and detect potentially malicious or dangerous domains. Use when you need to assess domain reputation, check for security threats, or gather comprehensive domain intelligence.
Input parameters
A domain name, hostname, FQDN, URL, HTML link or email address to lookup
For domains that we have never seen before then perform various live checks and realtime reconnaissance. NOTE: this option may add additional non-deterministic delay to the request, if you require consistently fast API response times or just want to check our domain blocklists then you can disable this option
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_PHONE_VALIDATETool to validate and lookup phone numbers. Use when you need to confirm number format and fetch location, carrier, and type details.
Input parameters
User's IP address to help with number location.
The phone number to validate in international format.
ISO 2-letter country code (required if number not in international format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_QR_CODEGenerate a QR code or Code 128 barcode as a PNG image. Use when you need to encode URLs, text, phone numbers, or other data into a scannable code. Examples: Create QR code for a website URL, encode contact information, generate barcode for product tracking.
Input parameters
The width of the QR code in pixels; default is 256
The height of the QR code in pixels; default is 256
The content to encode into the QR code (e.g. a URL or a phone number)
The QR code background color as hex value; default is #ffffff (white)
The QR code foreground color as hex value; default is #000000 (black)
The barcode format to output: 'qr' for QR code or 'c128' for Code 128 barcode; default is 'qr'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_RUN_BROWSER_BOTTool to automate browser interactions using a real Chromium browser. Use when you need to extract content, fill forms, capture screenshots, or navigate complex JavaScript-heavy websites.
Input parameters
The URL to load
Execute JavaScript on the website. This parameter accepts JavaScript as either a string containing JavaScript or for sending multiple separate statements a JSON array. If a statement returns any value it will be returned in the 'exec-results' response. You can also use the following specially defined user interaction functions: sleep(seconds); click('selector'); focus('selector'); keys('characters'); enter(); tab();
Delay in seconds to wait before capturing any page data, executing selectors or JavaScript. Default is 3.
Timeout in seconds. Give up if still trying to load the page after this number of seconds. Default is 30.
Extract content from the page DOM using this CSS selector. You can find a good reference at https://www.w3schools.com/cssref/css_selectors.asp
Override the browser's default user-agent string with this one
Ignore any TLS/SSL certificate errors and load the page anyway. Default is false.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_SMS_VERIFYTool to send a unique security code via SMS. Use when verifying a user's phone number after collection.
Input parameters
The user's IP address, used for enhanced verification checks.
The phone number to send the verification code to, in international format (E.164).
Your brand name to display in the SMS (up to 30 characters).
The number of digits in the security code (4–12). Default is 5.
Country dialing code if number is in local format, e.g. '44' for the U.K.'
How long the code is valid for in minutes (1–1440). Default is 60.
ISO 639 language code for the SMS message. Default is 'en'.
Pass in your own numeric security code. Must only contain digits and match the length given by code-length.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_UA_LOOKUPParse and analyze User-Agent strings to extract detailed browser, device, and operating system information. Returns device type (desktop/phone/tablet/robot), browser name and version, OS details, device specifications (brand, model, screen resolution, price), and indicators for mobile devices, webviews, and frozen User-Agents. Supports both traditional UA strings and modern User-Agent Client Hints.
Input parameters
The User-Agent string to parse and analyze. This can be a traditional UA string from HTTP headers or a browser's navigator.userAgent value. Maximum length: 2048 characters.
Optional User-Agent Client Hints data for modern browsers (Chromium 89+). Provide as comma-separated header names or JSON object with hint values. Use this when the UA string is frozen to get detailed device information.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_URL_INFOTool to parse, analyze, and retrieve content from the supplied URL. Use when you need detailed URL metadata or to fetch page content.
Input parameters
The URL to analyze
If true, fetch and return the full content of the URL
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
NEUTRINO_VERIFY_SECURITY_CODEVerify a security code generated by SMS Verify or Phone Verify APIs. Use this after sending a security code via SMS or phone call to validate that the user provided the correct code. Codes expire after 15 minutes. The verification must use the same API credentials that generated the code.
Input parameters
Optional unique identifier (email hash, phone number, or IP) to enable brute-force protection. After ~10 failed attempts, requests are ignored.
The security code to verify (generated by SMS Verify or Phone Verify API).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 88 agents privately built on Nagent that already use Neutrino.
Build on Nagent
Connect Neutrino to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Neutrino, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Neutrino is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Neutrino is connected, you configure its 24 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Neutrino steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Neutrino event fires, the agent kicks off automatically.
Every Neutrino action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Neutrino ships with 24 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Neutrino together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Neutrino-based workflows tailored to your business.