Neutrino

Learn how to use Neutrino with Composio

Overview

SLUG: NEUTRINO

Description

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

Authentication Details

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.

1

Select App

Navigate to Neutrino.

2

Configure Auth Config Settings

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

3

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

1from composio import Composio
2
3# Replace these with your actual values
4neutrino_auth_config_id = "ac_YOUR_NEUTRINO_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def 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
27connection_id = authenticate_toolkit(user_id, neutrino_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(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

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["NEUTRINO"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def 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
33invoke_llm()

Tool List

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

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
Required
customer-ip
output-case
stringDefaults to camelCase

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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

email
Required
fix-typos
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

email
Required
fast
boolean
fix-typos
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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

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
ip
number
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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

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

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

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

ip
stringRequired
reverse-lookup
boolean
user-agent
string
vpn-lookup
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

ip
stringRequired
reverse-lookup
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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
ip
stringRequired
reverse-lookup
boolean
user-agent
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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
ip
number
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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
ip
string
language-code
stringDefaults to en
number
stringRequired
security-code
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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
ua
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

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
ip
string
security-code
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired