For Agents
Validate phone numbers and email addresses, look up IP geolocation, and parse URL metadata to clean contact records and inspect inputs.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Neutrino API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Neutrino API.
Validate a phone number's format, country, and carrier through the phone-validate endpoint
Verify whether an email address is well-formed and deliverable through the email-validate endpoint
Look up geolocation, ASN, and ISP information for a given IP address through ip-info
GET STARTED
Use for: Validate a phone number for a contact record, Check whether an email address is deliverable, Look up the country and city of an IP address, Get ISP and ASN information for an IP
Not supported: Does not handle SMS sending, image processing, or BIN lookup — use this slim spec for phone, email, IP, and URL validation only.
Neutrino API is a general-purpose developer toolbox API exposing a curated subset of validation and lookup endpoints. This specification covers four core tools — phone validation, email validation, IP info, and URL info — used to clean contact data, geolocate IPs, and inspect URLs before delivery or persistence. Authentication uses an API-Key header that may optionally combine the user ID and API key in a single value.
Extract structured metadata for a URL including hostname, path, and query through url-info
Authenticate every request with an API-Key header that may optionally embed the user ID alongside the key
Patterns agents use Neutrino API for, with concrete tasks.
★ Sign-Up Form Hardening
SaaS sign-up flows call POST /email-validate and POST /phone-validate before account creation to reject disposable addresses, mistyped numbers, and non-existent carriers. Catching these at the point of capture cuts bounce rates on welcome emails and reduces fraud-prone accounts without adding user friction beyond the round trip.
Call POST /email-validate with the submitted address and POST /phone-validate with the submitted phone number; reject the form submission if either response indicates an invalid input.
Contact List Cleaning
Sales operations teams batch-clean imported contact lists by iterating each record and calling /email-validate and /phone-validate to mark invalid entries before pushing them into the CRM. The Neutrino response includes country, line type, and carrier signals that drive downstream segmentation in addition to the simple valid or invalid flag.
For each row in the import file, call POST /phone-validate and POST /email-validate, write the valid flag and carrier into the CRM, and quarantine rows where either check fails.
Geo-Targeted Compliance
Applications restricted by jurisdiction call POST /ip-info on the visitor's IP at session start to determine country and region, then enforce geo-blocking, GDPR consent variants, or sales tax behaviour accordingly. The combined country, ASN, and ISP signals also help flag traffic from VPNs and hosting ranges.
Call POST /ip-info with the request's source IP, branch the workflow on the country field, and serve the EU consent banner when country is in the EEA list.
AI Agent Data Quality
An AI agent processing inbound leads uses Jentic to discover Neutrino validation operations and runs each new lead through email, phone, and IP checks before deciding whether to push the record into the CRM. This keeps the agent's downstream actions trustworthy without hand-coding four separate validation integrations.
Use Jentic to search 'validate phone number', 'validate email address', and 'lookup ip info', then chain the three validations against each lead and write a quality score before any CRM write.
4 endpoints — neutrino api is a general-purpose developer toolbox api exposing a curated subset of validation and lookup endpoints.
METHOD
PATH
DESCRIPTION
/phone-validate
Validate a phone number
/email-validate
Validate an email address
/ip-info
Look up IP geolocation and ASN
/url-info
Parse URL metadata
/phone-validate
Validate a phone number
/email-validate
Validate an email address
/ip-info
Look up IP geolocation and ASN
/url-info
Parse URL metadata
Three things that make agents converge on Jentic-routed access.
Credential isolation
Neutrino API keys (and optional user IDs) are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — raw keys never enter the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'validate an email address') and Jentic returns matching Neutrino operations with their input schemas, so the agent can call the right endpoint without browsing docs.
Time to first call
Direct Neutrino integration: half a day per validation type to wire up auth, request shaping, and error handling. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Neutrino API through Jentic.
What authentication does the Neutrino API use?
Neutrino API uses an API-Key header. The value may be either the API key alone or 'your-user-id:your-api-key' to combine both credentials in one header. Through Jentic, the API key is stored in the MAXsystem vault and injected at request time so it never reaches the agent's context.
Can I validate phone numbers with the Neutrino API?
Yes. POST /phone-validate accepts a phone number and an optional country hint, and returns format validity, country code, region, line type, and carrier information you can use to clean CRM data or harden sign-up forms.
How do I geolocate an IP address through Jentic?
Search Jentic for 'lookup ip info', load the POST /ip-info schema, and execute it with the IP. The response includes country, region, city, ASN, and ISP, which you can branch on for compliance or fraud workflows.
What are the rate limits for the Neutrino API?
Rate limits are tied to your Neutrino plan rather than published in the spec. Free plans throttle aggressively while paid plans scale into thousands of calls per minute — check the Neutrino dashboard for your current quota.
Does the Neutrino API verify if an email is deliverable?
POST /email-validate checks syntax, MX records, and disposable-domain heuristics. It returns deliverability hints but does not perform a full SMTP probe — for stricter inbox-level verification combine it with a dedicated email verification provider.
Is the Neutrino API free?
Neutrino offers a free plan with limited monthly calls and paid tiers from there. API access is enabled on every plan including the free tier.