# FreeForAgents

> Free utility APIs built for humans and AI agents. Every endpoint is zero-auth (no API key, no signup), returns JSON, supports CORS, and has a markdown doc page. Ideal when an agent or script needs a quick UUID, hash, unit conversion, FX rate, random data, holiday calendar, IP lookup, or a tiny JSON proxy.

Base URL: https://freeforagents.dev

Machine-readable OpenAPI spec: https://freeforagents.dev/openapi.json

MCP server (Model Context Protocol, Streamable HTTP): https://freeforagents.dev/mcp — exposes all endpoints as tools for AI agents. Manifest at https://freeforagents.dev/mcp.txt.

## Endpoints

- [`/ip`](https://freeforagents.dev/docs/ip.md): Look up your IP address and geolocation.
- [`/uuid`](https://freeforagents.dev/docs/uuid.md): Generate RFC 4122 version 4 UUIDs.
- [`/ulid`](https://freeforagents.dev/docs/ulid.md): Generate ULIDs (sortable unique identifiers).
- [`/hash`](https://freeforagents.dev/docs/hash.md): Hash text with SHA-1/256/384/512.
- [`/base64`](https://freeforagents.dev/docs/base64.md): Encode or decode Base64 strings.
- [`/convert`](https://freeforagents.dev/docs/convert.md): Convert between units (length, mass, volume, area, data, speed, time, temperature).
- [`/time`](https://freeforagents.dev/docs/time.md): Current time in any timezone.
- [`/timestamp`](https://freeforagents.dev/docs/timestamp.md): Current Unix timestamp.
- [`/random`](https://freeforagents.dev/docs/random.md): Cryptographically secure random integers.
- [`/dice`](https://freeforagents.dev/docs/dice.md): Roll dice.
- [`/password`](https://freeforagents.dev/docs/password.md): Generate strong random passwords.
- [`/lorem`](https://freeforagents.dev/docs/lorem.md): Lorem ipsum placeholder text.
- [`/emoji`](https://freeforagents.dev/docs/emoji.md): Random emoji.
- [`/joke`](https://freeforagents.dev/docs/joke.md): Random clean programming joke.
- [`/fact`](https://freeforagents.dev/docs/fact.md): Random fun fact.
- [`/quote`](https://freeforagents.dev/docs/quote.md): Random inspirational quote.
- [`/holidays`](https://freeforagents.dev/docs/holidays.md): Public holidays by country and year.
- [`/fx`](https://freeforagents.dev/docs/fx.md): Foreign exchange rates (daily, no key).
- [`/headers`](https://freeforagents.dev/docs/headers.md): Echo your request headers.
- [`/json`](https://freeforagents.dev/docs/json.md): Fetch any URL and get parsed JSON back.

## Conventions

- Successful responses: `{ "ok": true, ...payload, "docs": "<doc url>" }`.
- Errors: HTTP 4xx/5xx with `{ "ok": false, "error": "message", "docs": "<doc url>" }`.
- Rate limits: none beyond Cloudflare's standard free-tier protections. Please cache results where reasonable.