# FreeForAgents MCP Server

Transport: Streamable HTTP
URL: https://freeforagents.dev/mcp

Stateless JSON-RPC 2.0 endpoint implementing MCP methods:
initialize, ping, tools/list, tools/call.

## Tools

- `ip_lookup` — Get your public IP address and geolocation (country, city, coordinates, timezone, ASN). Takes no arguments.
- `uuid_generate` — Generate one or more cryptographically random RFC 4122 v4 UUIDs.
- `ulid_generate` — Generate ULIDs — lexicographically sortable unique identifiers.
- `hash_text` — Compute the SHA hex digest of text.
- `base64` — Encode text to Base64 or decode Base64 to UTF-8 text.
- `convert_units` — Convert values between units of length, mass, volume, area, data size, speed, time and temperature. Examples: kg->lb, mi->km, c->f, gb->mib.
- `current_time` — Current time in any IANA timezone, e.g. America/New_York.
- `unix_timestamp` — Current Unix epoch seconds, milliseconds and ISO 8601 time.
- `random_numbers` — Cryptographically secure random integers or floats in [min, max].
- `roll_dice` — Roll dice with any number of sides.
- `generate_password` — Generate strong random passwords containing upper/lowercase letters, digits and symbols.
- `lorem_ipsum` — Generate lorem ipsum placeholder paragraphs.
- `random_emoji` — Random emoji characters with names.
- `random_joke` — A clean programming joke.
- `random_fact` — A fun verified fact.
- `random_quote` — An inspirational quote with author.
- `public_holidays` — List public holidays for a country and year. Supported countries: US, GB, CA, AU, NZ, IN.
- `fx_rates` — Latest foreign exchange rates against a base currency, e.g. USD, EUR, JPY.
- `request_headers` — Echo back all HTTP headers of this MCP request as seen by the server.
- `fetch_json` — Fetch an https:// URL and return its parsed JSON body. https only, private hosts blocked, 8s timeout, 500KB limit.

## Example (initialize)

```bash
curl -s https://freeforagents.dev/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}}'
```