Skip to main content

ip_to_hem

Resolve an IP address (with optional user agent) to hashed email addresses (MD5), ranked by confidence score.

Updated this week

Parameters

Field

Type

Required

Description

params.name

string

Must be "ip_to_hem"

params.arguments.ip_address

string

IPv4 or IPv6 address

params.arguments.user_agent

string

Browser User-Agent string — improves matching accuracy

params.arguments.fingerprint

string

Pre-computed fingerprint (overrides ip + user agent fingerprinting)

params.arguments.include_sha256

boolean

Include SHA-256 hashes in results

Passing user_agent alongside ip_address significantly improves match accuracy. Capture both from your web server or analytics layer.

user_agent is not included in batch keys for the ip_to_hem tool.

Request

curl --request POST \
--url https://app.moltsets.com/mcp/ \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "ip_to_hem",
"arguments": {
"ip_address": "8.8.8.8",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)", // not required but improves match accuracy
"include_sha256": true
}
}
}'

Response

{
"jsonrpc": "2.0",
"id": null,
"result": {
"content": [
{
"type": "text",
"text": "{\"results\":[{\"md5\":\"43132e2f7752aafbc18d0ff97bbXXXXX\",\"sha256\":\"9adcf8496de590e61c733352fdcafae57cc1669a67095a575b32dcbfacXXXXX\",\"score\":\"0.928\"},{\"md5\":\"43132e2f7752aafbc18d0ff97bbXXXXX\",\"sha256\":\"9adcf8496de590e61c733352fdcafae57cc1669a67095a575b32dcbfac4XXXXX\",\"score\":\"0.852\"},{\"md5\":\"43132e2f7752aafbc18d0ff97bbXXXXX\",\"sha256\":\"9adcf8496de590e61c733352fdcafae57cc1669a67095a575b32dcbfac4XXXXX\",\"score\":\"0.849\"}]}"
}
],
"isError": false
}
}
Did this answer your question?