# Toolbench Agent API

> Agent-first utility API. 35 deterministic tools agents need — web fetching/cleaning, data conversion, math, dates, encoding/crypto and text — as JSON HTTP endpoints with an OpenAPI schema and an MCP server. Discover tools at GET /api/v1/tools.

Base URL: https://pixelart.to
Free to use, no API key, no rate limit, CORS open.

## For agents
- Discovery (all tools + JSON input schemas): GET https://pixelart.to/api/v1/tools
- OpenAPI schema: https://pixelart.to/openapi.json
- MCP server (streamable HTTP): https://pixelart.to/mcp/
- Plugin manifest: https://pixelart.to/.well-known/ai-plugin.json
- Call a tool: POST https://pixelart.to/api/v1/<tool> with a JSON body.
  Response envelope: {"ok":true,"result":{...}}.

Example:
  curl -s https://pixelart.to/api/v1/calc -H 'content-type: application/json' -d '{"expression":"2**16"}'

## Tools
- [fetch_url](/api/v1/fetch_url) (web): Fetch a URL server-side and return cleaned markdown/text/html plus title & description.
- [html_to_markdown](/api/v1/html_to_markdown) (web): Convert an HTML string to Markdown.
- [extract_metadata](/api/v1/extract_metadata) (web): Extract title, description, Open Graph tags, headings and links from HTML or a URL.
- [json_format](/api/v1/json_format) (data): Validate and pretty-print or minify JSON.
- [json_query](/api/v1/json_query) (data): Query JSON with a JSONPath expression.
- [convert_data](/api/v1/convert_data) (data): Convert structured data between JSON, YAML, CSV and TOML.
- [text_diff](/api/v1/text_diff) (data): Unified line diff between two texts.
- [calc](/api/v1/calc) (compute): Safely evaluate an arithmetic expression (no eval); supports math functions.
- [datetime_convert](/api/v1/datetime_convert) (compute): Parse a date/time (ISO, epoch, or 'now') and convert it to a timezone.
- [date_diff](/api/v1/date_diff) (compute): Difference between two dates incl. business days.
- [date_add](/api/v1/date_add) (compute): Add an interval (incl. business days) to a date.
- [cron_next](/api/v1/cron_next) (compute): Next N run times for a cron expression.
- [unit_convert](/api/v1/unit_convert) (compute): Convert length, mass, data size or temperature.
- [base_convert](/api/v1/base_convert) (compute): Convert an integer between numeric bases (2–36).
- [base64](/api/v1/base64) (encoding): Base64 encode or decode text.
- [hash](/api/v1/hash) (encoding): Compute md5/sha1/sha256/sha512 (and more) hashes of text.
- [hmac](/api/v1/hmac) (encoding): Compute an HMAC of text with a key.
- [jwt_decode](/api/v1/jwt_decode) (encoding): Decode a JWT header & payload (signature not verified).
- [uuid](/api/v1/uuid) (encoding): Generate UUIDs.
- [url_encode](/api/v1/url_encode) (encoding): URL percent-encode or decode text.
- [regex_extract](/api/v1/regex_extract) (text): Find all regex matches (with groups) in text.
- [text_stats](/api/v1/text_stats) (text): Character/word/line/sentence counts and an approx token count.
- [slugify](/api/v1/slugify) (text): Turn text into a URL-safe slug.
- [qr_code](/api/v1/qr_code) (generate): Generate a QR code as a PNG data URI.
- [lorem](/api/v1/lorem) (generate): Generate Lorem Ipsum placeholder text.
- [dns_lookup](/api/v1/dns_lookup) (live): Resolve DNS records (A/AAAA/MX/TXT/NS/CNAME) for a domain.
- [rdap_domain](/api/v1/rdap_domain) (live): WHOIS/RDAP domain registration: registrar, dates, status, nameservers.
- [ip_info](/api/v1/ip_info) (live): Geolocate an IP (or the caller's own IP): country, city, ISP, ASN.
- [http_headers](/api/v1/http_headers) (live): Fetch a URL's HTTP status, redirect chain and response headers.
- [tls_cert](/api/v1/tls_cert) (live): Inspect a host's live TLS certificate and days until expiry.
- [fx_convert](/api/v1/fx_convert) (live): Convert currency at the latest live exchange rate.
- [geocode](/api/v1/geocode) (live): Geocode a place name to latitude/longitude.
- [weather](/api/v1/weather) (live): Current weather for a place name or lat/lon.
- [rss_fetch](/api/v1/rss_fetch) (live): Fetch and parse a live RSS/Atom feed into items.
- [unshorten_url](/api/v1/unshorten_url) (live): Reveal the final destination of a shortened/tracking URL.