Overview
What IPPulse does
IPPulse turns an IP address into a structured profile that an AI agent or a security pipeline can reason over directly.
- GET /v1/lookup/{ip} returns geolocation (country, country code, region, city, latitude, longitude, timezone), ASN data (number, AS description, network operator, AS country, routed BGP prefix), the reverse DNS hostname, and two risk flags: proxy (a VPN range or Tor exit) and hosting (a datacenter or cloud range). Example: /v1/lookup/8.8.8.8.
- POST /v1/bulk accepts 1 to 50 addresses in one call and returns results in input order.
- GET /v1/reputation/{ip} returns an abuse score from 0 to 100 with the signals behind it: botnet C2 +60, Tor exit +40, VPN +25, hosting +10, capped at 100. 60 or more is high risk, 30 or more medium, otherwise low.
Every answer carries attribution, data_sources and data_build (the data build date) fields.
Where the data comes from
Only data licensed for commercial use, rebuilt weekly into range blocks on AWS; lookups call no third-party API at request time (hostnames come from a reverse DNS query). If the IP data is unavailable the API answers 503 and the call is not billed.
- IP Geolocation by DB-IP (db-ip.com), CC BY 4.0
- ASN, AS operator and routed ranges: IPtoASN (iptoasn.com), PDDL 1.0
- Timezone: tz-lookup, CC0 1.0
- Tor exit list: The Tor Project, CC0
- VPN and datacenter ranges: X4BNet lists_vpn, MIT License, Copyright (c) 2024 X4B (Mathew Heard)
- Cloud ranges: published IP range lists of AWS, Google Cloud, Oracle Cloud and Cloudflare
- Botnet C2: abuse.ch Feodo Tracker, CC0
- Hostnames: reverse DNS (PTR)
Three ways to connect
- REST with an X-API-Key header, described by an OpenAPI 3 schema (https://ippulse.waltsoft.net/openapi.json ).
- MCP: the tool ippulse___lookupIP on the Amazon Bedrock AgentCore Gateway, for Claude, Strands Agents and other MCP clients.
- A2A (Agent2Agent 0.3): the agent card at https://ippulse.waltsoft.net/.well-known/agent-card.json with skills lookupIp, bulkLookupIps and getIpReputation.
Who it is for
Fraud and abuse screening, access control agents that classify incoming IPs, log enrichment and threat intelligence pipelines that need structured IP data from one licensed source set.
Billing
On AWS Marketplace, every successful call is one unit at $0.01, except POST /v1/bulk, which uses 2 units ($0.02), billed on your AWS bill. With x402 (USDC, no subscription): single lookup $0.005, bulk batch $0.02, reputation check $0.01 per call. Only successful calls are billed; errors (400, 401, 404, 429, 5xx) are never billed. Rate limit: 50 requests per second (burst 100).
Highlights
- Full IP profile in one call: geolocation with timezone, ASN, network operator, routed BGP prefix, reverse hostname, and proxy (VPN or Tor) and hosting flags, plus a 0-100 reputation score with its factors
- Built only from commercially licensed open data (DB-IP Lite, IPtoASN, Tor exit list, X4BNet, cloud ranges, Feodo Tracker), rebuilt weekly on AWS; if the data is unavailable the API returns 503 and nothing is billed
- Agent-ready: REST with an OpenAPI 3 schema, an MCP tool on Amazon Bedrock AgentCore Gateway and an A2A agent card; pay only for successful calls on your AWS bill
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Quick Launch
Pricing
Dimension | Description | Cost/unit |
|---|---|---|
API Call | One unit per lookup or reputation call; POST /v1/bulk uses 2 units | $0.01 |
Vendor refund policy
Contact support@waltsoft.net within 30 days for refund requests.
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
- Amazon Bedrock AgentCore
API-Based Agents & Tools
API-Based Agents and Tools integrate through standard web protocols. Your applications can make API calls to access agent capabilities and receive responses.
Additional details
Usage instructions
To get started using the remote MCP server, follow the instructions below:
Available Tools This MCP server (Amazon Bedrock AgentCore Gateway) supports the following tool:
- ippulse___lookupIP - Geolocation (country, region, city, coordinates, timezone), ASN, network operator, routed BGP prefix, reverse DNS hostname and risk flags (proxy = VPN or Tor exit, hosting = datacenter or cloud) for one IPv4 or IPv6 address. Arguments: ip (e.g. 8.8.8.8), api_key
Prerequisites
- An active subscription to this product. Your API key (it starts with mp_) is stored in your AWS Secrets Manager after you choose Set up your account, and is also shown on the registration page.
- Install Node.js and npm (for mcp-remote), or Python 3.10+ (for the Strands Agents SDK).
Authentication The MCP endpoint needs no connection header. Pass your key as the api_key argument of every tool call; replace YOUR_API_KEY with your actual key below. A wrong or inactive key returns statusCode 401.
MCP endpoint: https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp
Claude Desktop Edit the configuration file at:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the below code:
{ "mcpServers": { "waltsoft-ippulse": { "command": "npx", "args": [ "mcp-remote", "https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp" ] } } }Then ask, for example: "Use ippulse___lookupIP with ip 8.8.8.8 and api_key YOUR_API_KEY".
Strands Agents (Python)
pip install strands-agents mcp from mcp.client.streamable_http import streamable_http_client from strands.tools.mcp import MCPClient URL = "https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp" with MCPClient(lambda: streamable_http_client(URL)) as mcp: result = mcp.call_tool_sync("call-1", "ippulse___lookupIP", {"ip": "8.8.8.8", "api_key": "YOUR_API_KEY"}) print(result["content"][0]["text"])Example tool result
{"statusCode": 200, "result": {"ip": "8.8.8.8", "geo": {"country": "United States", "country_code": "US", "region": "California", "city": "Mountain View", "lat": 37.422, "lon": -122.085, "timezone": "America/Los_Angeles"}, "asn": {"number": "AS15169", "org": "GOOGLE", "isp": "GOOGLE", "country": "US", "bgp_prefix": "8.8.8.0/24"}, "hostname": "dns.google", "proxy": false, "hosting": true, "attribution": "IP Geolocation by DB-IP (db-ip.com), CC BY 4.0", "data_build": "20261022"}}Bulk lookups and the reputation score are available over REST and A2A.
Rate Limits
- 50 requests per second (bursts up to 100).
- Exceeding returns HTTP 429 Too Many Requests.
- Use retry and exponential backoff to handle limits.
Learn More API Docs: https://ippulse.waltsoft.net Support: support@waltsoft.net
Support
Vendor support
Email support@waltsoft.net for API questions and integration help. Response within 24 hours.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.