com.gadgethumans.swarm/x402-middleware

Calculate Basal Metabolic Rate (BMR) using Mifflin-St Jeor equation. Parameters: weight — Weight in kg. height — Height in cm. age — Age in years. sex — 'male' (default) or 'female'.

Calculate BMI (Body Mass Index) from weight and height. Parameters: weight — Weight (kg for metric, lbs for imperial). height — Height (cm for metric, inches for imperial). unit — 'metric' (default) or 'imperial'.

Date arithmetic and difference calculations. Use this to find days between dates, add/subtract time, or get date info (weekday, unix timestamp). Parameters: op — 'info' (default), 'diff', or 'add'. date1 — Start date (ISO format, default: today). date2 — End date (for 'diff' operation). days — Days to add (for 'add' operation). months — Months to add (for 'add' operation). years — Years to add (for 'add' operation).

Send a chat completion request to DeepSeek V4 Flash through the GadgetHumans proxy. REQUIRES an API key with credits. Get one via wallet_create or wallet_buy. Use this to get AI responses. Each call costs ~1 credit from your wallet. Accepts an OpenAI-compatible messages format. Returns response with content, token usage, and cost estimate. Parameters: messages — JSON string of messages array (e.g. '[{"role":"user","content":"Hello"}]'). Must be valid JSON with at least one message. model — Model to use (default: "deepseek-v4-flash"). temperature — Sampling temperature (0.0-1.0, default: 0.7). max_tokens — Maximum tokens in response (default: 2000). api_key — Your wallet API key (starts with 'gh_'). REQUIRED for paid access.

Check if a domain has a valid SSL/TLS certificate and is reachable. Use this to verify a website is serving over HTTPS before making requests. Returns HTTP status and server info. Parameters: domain — Domain to check (e.g. 'example.com').

{d}

Compare two products, services, or options and get a structured comparison with verdict. Use this for buying decisions, feature comparisons, or evaluating alternatives. Returns pros/cons for each, comparison points across key aspects, and a final verdict on which is better and why. Parameters: item_a — First item to compare (e.g. "Herman Miller Aeron"). item_b — Second item to compare (e.g. "Steelcase Gesture").

Parse CSV text into structured JSON array. Use this to convert CSV data from spreadsheets or exports into JSON format for programmatic use. Parameters: csv — CSV text with header row and data rows.

Convert between currencies using real-time exchange rates. Use this for currency conversion, financial calculations, or comparing prices across different currencies. Supports 160+ currencies including USD, GBP, EUR, JPY, CAD, AUD, and more. Parameters: from_ — Source currency code (default: "USD"). Three-letter ISO code. to — Target currency code (default: "GBP"). Three-letter ISO code. amount — Amount to convert (default: 1). Positive number.

Convert JSON object or array to CSV format. Use this to transform API responses or structured data into spreadsheet-compatible CSV format. Parameters: json_str — JSON string (object or array of objects) to convert.

Convert a timestamp between Unix epoch and human-readable date formats. Use this to translate Unix timestamps (e.g., 1717000000) into ISO 8601 date strings, or convert date strings back to Unix timestamps. Parameters: value — The timestamp or date string to convert (required). Accepts Unix timestamps (seconds since epoch) or various date string formats like "2025-05-29" or "May 29, 2025". format — Target output format (default: "iso"). Common values include "iso", "unix", "rfc2822", etc.

Convert timestamps between timezones. Use this when you need to express times in a different timezone. Supports common zones: UTC, EST, PST, CET, IST, JST, AEST, etc. Parameters: timestamp — ISO date string (default: current time). from_tz — Source timezone code (default: 'UTC'). to_tz — Target timezone code (default: 'UTC').

Decode a JWT token into its header, payload, and signature parts. Use this to inspect JWT tokens without verifying signatures. Returns the header (alg, typ) and payload (claims) decoded from base64. Parameters: token — The full JWT token string (3 dot-separated base64 parts).

Detect the language of provided text with confidence score. Parameters: text — Text to detect language of.

Look up DNS records and SSL information for any domain. Use this to check A, AAAA, MX, NS, TXT, and CNAME records, plus SSL certificate status and server info. Ideal for domain research, troubleshooting, and infrastructure verification. Parameters: domain — The domain name to query (e.g. "example.com").

Extract email addresses, social media links, and phone numbers from any URL. Use this for lead generation, finding contact information on company websites, or researching business contacts. Returns emails, social links (LinkedIn, Twitter, GitHub, etc.), and phone numbers found in the page content. Parameters: url — The full URL to scan for contacts (e.g. "https://example.com/contact").

Generate one or more secure random passwords. Use this when a user needs a strong, random password — for account creation, temporary credentials, API keys, or any security-sensitive use case. Parameters: length — Length of each password (4-256, default: 16). count — Number of passwords to generate (1-50, default: 1). numbers — Include digits 0-9 (default: True). symbols — Include special characters like !@#$%^&* (default: True). uppercase — Include A-Z (default: True). lowercase — Include a-z (default: True).

Generate a QR code image and return it as Base64-encoded data. Use this when you need to encode a URL, text, or other data into a QR code image that can be displayed or embedded in documents/web pages. Parameters: text — The text or URL to encode in the QR code (required). format — Output image format: "png", "svg", or "gif" (default: "png"). size — Image size in pixels (100-1000, default: 300). color — Foreground hex color (without #, default: "000000"). bgcolor — Background hex color (without #, default: "FFFFFF"). ecc — Error correction level: "L", "M", "Q", or "H" (default: "M"). Higher levels allow more damage before the code becomes unreadable. margin — Margin in modules (0-20, default: 4).

Generate SEO-optimized title, meta description, keywords, and slug. Use this when publishing content — get an SEO title (55-60 chars), meta description (150-160 chars), relevant keywords, and a URL-friendly slug. Provide a URL to analyze or a topic directly. Parameters: url — Optional URL of existing content to base metadata on. topic — Optional topic/keyword to generate metadata for. At least one of url or topic is required.

Generate one or more UUID v4 (random) identifiers. Use this when you need unique identifiers for database records, API resources, session IDs, or anywhere a globally unique ID is required. Parameters: count — Number of UUIDs to generate (1-100, default: 1). format — Output format: "standard" (xxxxxxxx-xxxx-...), "json", or "array" (default: "standard").

Forward geocode an address or place name to coordinates. Uses Nominatim (free, no key). Returns lat, lon, display_name, type, and importance for up to 5 results. Parameters: query — Address or place name to geocode (required), e.g. "London" or "10 Downing Street".

Get geolocation data for an IP address. Use this to determine the geographical location, ISP, and timezone associated with an IP address. Helpful for fraud detection, analytics, geo-targeting, or debugging network issues. Parameters: ip_address — The IP address to look up (e.g., "8.8.8.8"). If empty or omitted, returns data for the requester's own IP.

Get current air quality data for any city. Uses Open-Meteo Air Quality API (free, no key) after geocoding the city. Returns European AQI, US AQI, PM2.5, PM10, and ozone levels. Parameters: city — City name to check air quality for (required), e.g. "London".

Get real-time cryptocurrency prices from Binance. Use this to check current crypto prices, 24-hour price changes, and market data for major cryptocurrencies. Supports common names (bitcoin, ethereum, solana) and direct ticker symbols. Parameters: symbol — Comma-separated cryptocurrency names or tickers (default: "bitcoin,ethereum"). Examples: "bitcoin", "ethereum,solana", "BTC,ETH,SOL".

Get a 7-day weather forecast for any city. Uses Open-Meteo (free, no key) after geocoding the city via Nominatim. Returns daily high/low temps, precipitation, and weather codes. Parameters: city — City name to get forecast for (required), e.g. "London".

Extract Open Graph metadata, title, description, and favicon from any URL. Use this when an agent needs to preview a link — get the page title, description, OG image, favicon, and content type. Ideal for link previews, content summarization, and social media card extraction. Parameters: url — The full URL to scrape metadata from (e.g. "https://example.com/page").

Get current weather conditions for any city. Uses Open-Meteo (free, no key) after geocoding the city via Nominatim. Returns temperature, wind speed, weather code, and conditions. Parameters: city — City name to get weather for (required), e.g. "London".

{d}

Generate a cryptographic hash of input text. Use this for password hashing, data integrity checks, digital signatures, or any scenario requiring a one-way hash of a string. Parameters: text — The text to hash (required). algorithm — Hashing algorithm: "md5", "sha1", "sha256", or "sha512" (default: "sha256"). SHA-256 and SHA-512 are recommended for security-sensitive use. encoding — Output encoding: "hex" or "base64" (default: "hex").

Calculate target heart rate zones for exercise. Parameters: age — Age in years. resting_hr — Resting heart rate in bpm (default: 60).

{d}

Get a list of all countries with ISO codes, calling codes, and continent. Parameters: (no parameters needed)

Get a list of all currencies with ISO codes, symbols, and country usage. Parameters: (no parameters needed)

Get a list of all languages with ISO codes and native names. Parameters: (no parameters needed)

Calculate monthly mortgage payments, total interest, and amortization. Parameters: principal — Loan principal amount. rate — Annual interest rate (e.g. 5.5 for 5.5%). years — Loan term in years.

{d}

Parse RSS or Atom XML feeds into clean JSON with entries. Use this to monitor news feeds, blog updates, or any RSS/Atom source. Returns feed metadata (title, URL) and up to 20 latest entries with title, link, description, and publication date. Parameters: url — The full URL of the RSS or Atom feed to parse (e.g. "https://example.com/feed.xml").

Prettify, validate, or minify a JSON string. Use this for debugging, formatting API responses, cleaning up configuration files, or verifying that a string is valid JSON. Parameters: json_string — The JSON string to process (required). Pass the raw JSON text. mode — Operation: "prettify" (indent + sort keys), "validate" (check syntax only), or "minify" (compact, no whitespace) (default: "prettify").

Research any topic and return a structured report with key findings and recommendations. Use this when you need a quick research briefing on any subject. Returns title, overview, key findings, and recommendations. Saves tokens compared to doing the research yourself. Parameters: query — The topic or question to research (e.g. "best ergonomic office chairs 2026").

Reverse geocode coordinates to a human-readable address. Uses Nominatim (free, no key). Returns display name, structured address components (road, city, country, postcode), and OSM identifiers. Parameters: lat — Latitude coordinate (required), e.g. 51.5. lon — Longitude coordinate (required), e.g. -0.12.

Rewrite content with AI — change tone, length, audience, or format. Use this to repurpose content for different channels. Takes any text and rewrites it according to your specifications. Powered by DeepSeek V4 Flash. Great for SEO content creation, social media adaptation, or making technical content accessible. Parameters: text — The text content to rewrite (required). tone — Desired tone: "professional", "casual", "persuasive", "formal", "friendly", or "humorous". Default: "professional". length — Target word count (default: 300). audience — Target audience (default: "general"). format — Output format: "paragraph", "bullet_points", or "single_sentence". Default: "paragraph".

{d}

{d}

Encode or decode URL/URI strings. Use this to safely encode special characters for URLs or decode percent-encoded URL strings back to readable text. Parameters: text — The string to encode or decode. mode — 'encode' (default) or 'decode'.

Validate IBAN format and check digit for international bank accounts. Parameters: iban — IBAN number to validate.

Validate a VAT number format for EU countries. Parameters: vat — VAT number to validate.

Verify whether an email address is valid and deliverable. Use this to validate user-provided email addresses during sign-up, form submission, or contact list cleaning. Checks syntax, domain validity, and whether the address is from a disposable email provider. Parameters: email — The email address to verify (required).

Check your wallet credit balance. Use this to see how many credits you have remaining. Credits are used to power AI tools (chat, rewrite, analyze). Buy more via wallet_buy. Parameters: api_key — Your API key (starts with 'gh_'). Create one at api.gadgethumans.com.

Get a link to buy credits for your wallet. Use this to purchase credits that power AI tools. $10 = 1000 credits. Each AI call costs ~1 credit. After purchasing, use your API key with the AI tools.

Create a new wallet and get an API key. Use this to get started with the GadgetHumans credit system. Your API key starts with 'gh_' and is used to authenticate AI tool calls. Parameters: email — Optional email address for payment receipts.

Count words, characters, sentences, paragraphs, and average word length. Parameters: text — Text to count words in.