How to use Whois with smolagents
Integrate Whois into your smolagents agent with SettleGrid's per-call billing. No subscriptions, no minimums — pay only for what you use.
About Whois
Domain WHOIS registration and availability lookup.
About smolagents
smolagents is Hugging Face's lightweight framework for building AI agents with minimal boilerplate. It emphasizes simplicity and tool composition.
Python
Integration Guide
1
Install smolagents
Terminal
pip install smolagents2
Get your SettleGrid API key
Purchase credits for Whois, then generate an API key from your Consumer Dashboard.
3
Register Whois in your smolagents agent
Python
from smolagents import Tool, CodeAgent, HfApiModel
import requests
class WhoisTool(Tool):
name = "whois"
description = "Whois — call via SettleGrid"
inputs = {"query": {"type": "string", "description": "Input query"}}
output_type = "string"
def forward(self, query: str) -> str:
resp = requests.post(
"https://proxy.settlegrid.ai/v1/whois",
headers={
"x-api-key": "sg_live_your_key_here",
"Content-Type": "application/json",
},
json={"query": query},
)
resp.raise_for_status()
return str(resp.json())
# Create agent with the tool
model = HfApiModel()
agent = CodeAgent(tools=[WhoisTool()], model=model)
result = agent.run("Use Whois to process this input")4
Run your agent
Execute your smolagents agent. SettleGrid automatically meters each call to Whois and deducts from your credit balance. No rate limits beyond your purchased credits.
Pricing
Cost per call3¢
No subscriptions or minimums. Credits never expire. See full pricing details.
Other Frameworks
Use Whois with other agent frameworks: