# Neutrino — how to use (mcp.ai)

Connect your Neutrino account and use 24 tools for developer tools straight from your AI agent. Connect with your own API key. Neutrino API provides a suite of general-purpose APIs for various tasks, including data validation, geolocation, and security.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_neutrino?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `neutrino_add_watermark_to_image`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/neutrino`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/neutrino/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/neutrino/add/watermark/to/image` — Add 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
  - body: { width?: integer, format?: string, height?: integer, opacity?: integer, bg-color?: string, position?: string, image-url: string, resize-mode?: string, watermark-url: string }
- `POST https://api.mcp.ai/api/neutrino/bad/word/filter` — Tool to detect bad words and profanity in text. Use when scanning content for swear words.
  - body: { catalog?: string, content: string, callback?: string, language-code?: string, censor-character?: string }
- `POST https://api.mcp.ai/api/neutrino/bin/lookup` — Perform 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), issue
  - body: { bin-number: string, customer-ip?: string, output-case?: string }
- `POST https://api.mcp.ai/api/neutrino/check/ip/blocklist` — Check 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 addre
  - body: { ip: string, vpn-lookup?: boolean }
- `POST https://api.mcp.ai/api/neutrino/convert` — Tool 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.
  - body: { to-type: string, from-type: string, from-value: string, historical-date?: string }
- `POST https://api.mcp.ai/api/neutrino/email/validate` — Validates and analyzes email addresses for syntax, domain validity, DNS/MX records, and detects freemail/disposable providers. This tool performs comprehensive email validation including: - RFC822/RFC
  - body: { email: string, fix-typos?: boolean }
- `POST https://api.mcp.ai/api/neutrino/email/verify` — Tool to verify and analyze the deliverability of an email address. Use when you need SMTP-based validation before sending emails.
  - body: { email: string, fix-typos?: boolean }
- `POST https://api.mcp.ai/api/neutrino/geocode/address` — Tool to geocode an address. Use when you need geographic coordinates for an address or place name.
  - body: { address: string, country-code?: string, fuzzy-search?: boolean, language-code?: string }
- `POST https://api.mcp.ai/api/neutrino/geocode/reverse` — Convert geographic coordinates (latitude/longitude) into real-world address information. Returns comprehensive location data including formatted addresses, administrative boundaries, timezone informat
  - body: { zoom?: string, latitude: number, longitude: number, country-code?: string, language-code?: string }
- `POST https://api.mcp.ai/api/neutrino/hlr/lookup` — Perform 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 mobil
  - body: { ip?: string, number: string, country-code?: string }
- `POST https://api.mcp.ai/api/neutrino/host/reputation` — Check 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 q
  - body: { host: string, zones?: string, list-rating?: integer }
- `POST https://api.mcp.ai/api/neutrino/html/clean` — Tool to clean and sanitize untrusted HTML. Use when you need to strip or neutralize unwanted tags and attributes before rendering.
  - body: { content: string, output-type?: string }
- `POST https://api.mcp.ai/api/neutrino/html/render` — Render 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
  - body: { css?: string, exec?: string, zoom?: number, delay?: integer, title?: string, footer?: string, format?: string, header?: string, margin?: number, content: string, timeout?: integer, bg-color?: string, grayscale?: boolean, landscape?: boolean, page-size?: string, margin-top?: number, page-width?: number, user-agent?: string, image-width?: integer, margin-left?: number, page-height?: number, image-height?: integer, margin-right?: number, margin-bottom?: number, ignore-certificate-errors?: boolean }
- `POST https://api.mcp.ai/api/neutrino/image/resize` — Resize, 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
  - body: { image?: string, width: integer, format?: string, height?: integer, bg-color?: string, image-url?: string, resize-mode?: string }
- `POST https://api.mcp.ai/api/neutrino/ip/info` — Get 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
  - body: { ip: string, reverse-lookup?: boolean }
- `POST https://api.mcp.ai/api/neutrino/ip/probe` — Analyzes 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
  - body: { ip: string, user-agent?: string, forward-lookup?: boolean, reverse-lookup?: boolean }
- `POST https://api.mcp.ai/api/neutrino/lookup/domain` — Tool 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, ch
  - body: { host: string, live?: boolean }
- `POST https://api.mcp.ai/api/neutrino/phone/validate` — Tool to validate and lookup phone numbers. Use when you need to confirm number format and fetch location, carrier, and type details.
  - body: { ip?: string, number: string, country-code?: string }
- `POST https://api.mcp.ai/api/neutrino/qr/code` — Generate 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 co
  - body: { width?: integer, height?: integer, content: string, bg-color?: string, fg-color?: string, code-format?: string }
- `POST https://api.mcp.ai/api/neutrino/run/browser/bot` — Tool 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.
  - body: { url: string, exec?: string[], delay?: integer, timeout?: integer, selector?: string, user-agent?: string, ignore-certificate-errors?: boolean }
- `POST https://api.mcp.ai/api/neutrino/sms/verify` — Tool to send a unique security code via SMS. Use when verifying a user's phone number after collection.
  - body: { ip?: string, number: string, brand-name?: string, code-length?: integer, country-code?: string, code-validity?: integer, language-code?: string, security-code?: string }
- `POST https://api.mcp.ai/api/neutrino/ua/lookup` — Parse 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, devi
  - body: { ua: string, client-hints?: string }
- `POST https://api.mcp.ai/api/neutrino/url/info` — Tool to parse, analyze, and retrieve content from the supplied URL. Use when you need detailed URL metadata or to fetch page content.
  - body: { url: string, fetch-content?: boolean }
- `POST https://api.mcp.ai/api/neutrino/verify/security/code` — Verify 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 afte
  - body: { limit-by?: string, security-code: string }

## Example prompts
- "What can I do in Neutrino?"
- "Show me a summary of my Neutrino account"

## More
- Page: https://mcp.ai/neutrino
- Agent spec (llms.txt): https://mcp.ai/neutrino/llms.txt
- Postman collection: https://mcp.ai/neutrino/postman.json