Neutrino | Composio Docs

Overview

SLUG: NEUTRINO

Description

Neutrino API provides a suite of general-purpose APIs for various tasks, including data validation, geolocation, and security.

Authentication Details

API Key

generic_api_key

stringRequired

generic_id

stringRequired

Connecting to Neutrino

Create an auth config

Use the dashboard to create an auth config for the Neutrino toolkit. This allows you to connect multiple Neutrino accounts to Composio for agents to use.

Select App

Navigate to Neutrino.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Neutrino Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 neutrino_auth_config_id = "ac_YOUR_NEUTRINO_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Neutrino for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, neutrino_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Neutrino toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["NEUTRINO"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

NEUTRINO_BAD_WORD_FILTER

Tool Name: Bad Word Filter

Description

Tool to detect bad words and profanity in text. Use when scanning content for swear words.

Action Parameters

callback

string

catalog

stringDefaults to strict

catalog-custom

string

censor-character

stringDefaults to *

content

stringRequired

language-code

stringDefaults to en

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_BIN_LOOKUP

Tool Name: BIN Lookup

Description

Tool to perform a BIN (Bank IIN) lookup. Use when you need card details for a BIN prefix.

Action Parameters

bin-number

stringRequired

customer-ip

string

output-case

stringDefaults to camelCase

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_CONVERT

Tool Name: Convert Value

Description

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.

Action Parameters

from-type

stringRequired

from-value

stringRequired

to-type

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_EMAIL_VALIDATE

Tool Name: Validate and analyze an email address

Description

Tool to parse, validate, and clean an email address. Use after gathering the email to ensure deliverability and correct typos.

Action Parameters

stringRequired

fix-typos

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_EMAIL_VERIFY

Tool Name: Verify Email Address

Description

Tool to verify and analyze the deliverability of an email address. Use when you need SMTP-based validation before sending emails.

Action Parameters

stringRequired

fast

boolean

fix-typos

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_GEOCODE_ADDRESS

Tool Name: Geocode Address

Description

Tool to geocode an address. Use when you need geographic coordinates for an address or place name.

Action Parameters

address

stringRequired

country-code

string

fuzzy-search

boolean

language-code

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_GEOCODE_REVERSE

Tool Name: Reverse Geocode

Description

Tool to convert geographic coordinates to a physical address. Use when you have latitude and longitude and need a real-world address.

Action Parameters

country-code

string

language-code

string

latitude

numberRequired

longitude

numberRequired

zoom

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_HLR_LOOKUP

Tool Name: HLR Lookup

Description

Tool to perform real-time HLR lookup and mobile number validation. Use after confirming the number format to retrieve network, reachability, and roaming status.

Action Parameters

country-code

string

number

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_HOST_REPUTATION

Tool Name: Host Reputation

Description

Tool to check the reputation of a host against DNSBLs.

Action Parameters

host

stringRequired

list-rating

integer

zones

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_HTML_CLEAN

Tool Name: HTML Clean

Description

Tool to clean and sanitize untrusted HTML. Use when you need to strip or neutralize unwanted tags and attributes before rendering.

Action Parameters

clean-level

stringDefaults to basic

content

stringRequired

output-type

stringDefaults to html

strip-attributes

string

strip-tags

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_HTML_RENDER

Tool Name: HTML Render

Description

Tool to render HTML content into PNG or PDF. Use when you need to convert HTML snippets or pages into downloadable files.

Action Parameters

content

stringRequired

delay

integer

format

string

image-height

integer

image-width

integer

output-type

stringDefaults to png

page-height

integer

page-width

integer

user-agent

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_IMAGE_RESIZE

Tool Name: Resize Image

Description

Tool to resize, crop, and convert images. Use when you need to adjust an image to specific dimensions and format before further processing.

Action Parameters

bgcolor

string

fit

stringDefaults to scale

format

string

height

integerRequired

image

string

image-url

string

width

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_IP_INFO

Tool Name: IP Info

Description

Tool to retrieve IP location and network information. Use when you need to look up geographic data, ISP, VPN/proxy status, and hostnames for an IP address.

Action Parameters

stringRequired

reverse-lookup

boolean

user-agent

string

vpn-lookup

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_IP_LOOKUP

Tool Name: IP Lookup

Description

Tool to geolocate an IP address and retrieve ISP, ASN, blocklist, and threat metadata. Use when you need to enrich an IPv4 or IPv6 address with geolocation and security details.

Action Parameters

stringRequired

reverse-lookup

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_IP_PROBE

Tool Name: IP Probe

Description

Tool to analyze an IP address to determine its threat level and associated risk factors. Use when you need to assess IP address security context.

Action Parameters

forward-lookup

boolean

stringRequired

reverse-lookup

boolean

user-agent

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_PHONE_VALIDATE

Tool Name: Phone Validate

Description

Tool to validate and lookup phone numbers. Use when you need to confirm number format and fetch location, carrier, and type details.

Action Parameters

country-code

string

number

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_QR_CODE

Tool Name: QR Code

Description

Tool to generate a QR code image from text or URL. Use when you need a PNG or JPG QR code for embedding or download. Example: Generate a QR code for a URL after validating the link.

Action Parameters

bg-color

stringDefaults to #FFFFFF

content

stringRequired

error-correction

stringDefaults to M

fg-color

stringDefaults to #000000

format

stringDefaults to png

logo-url

string

size

integerDefaults to 256

style

stringDefaults to normal

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_SMS_VERIFY

Tool Name: SMS Verify

Description

Tool to send a unique security code via SMS. Use when verifying a user's phone number after collection.

Action Parameters

brand-name

string

code-length

integerDefaults to 5

code-validity

integerDefaults to 60

country-code

string

language-code

stringDefaults to en

number

stringRequired

security-code

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_UA_LOOKUP

Tool Name: UA Lookup

Description

Tool to parse, validate, and get detailed user-agent information. Use when you need to analyze browser, device, and OS details from a UA string or client hints.

Action Parameters

client-hints

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_URL_INFO

Tool Name: URL Info

Description

Tool to parse, analyze, and retrieve content from the supplied URL. Use when you need detailed URL metadata or to fetch page content.

Action Parameters

fetch-content

boolean

url

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

NEUTRINO_VERIFY_SECURITY_CODE

Tool Name: Verify Security Code

Description

Tool to verify a security code generated by the Generate Security Code API. Use after obtaining a code-id and security code to check validity and detect expiration.

Action Parameters

code-id

stringRequired

string

security-code

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired