# IranTools - Iranian City Lookup

> IranTools - Iranian City Lookup is a paid API for AI agents from irantools.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Looks up information about an Iranian city by name, returning province and city details

## Facts

- Endpoint: POST https://irantools.johnaio281.workers.dev/api/iran/iran_city?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/irantools-iranian-city-lookup-eab2bab4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_peCZ6lu4mGVarhJvkOPNx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability irantools-iranian-city-lookup-eab2bab4 -d '<json body>'
```

Example prompt: Look up city information for 'Tabriz' in Iran — I need to know which province it belongs to and any other available details.

## When to prefer this

Use this endpoint when you need to resolve an Iranian city name to its province or retrieve administrative metadata about cities in Iran, especially within workflows handling Iranian addresses, shipping, or geolocation enrichment. Prefer this over general geocoding APIs when you specifically need Iranian administrative hierarchy data with Persian naming support.

## Known failure modes

- City name not found returns an empty result or error
- Misspelled or non-Persian transliterated city names may not match
- Ambiguous city names shared across provinces may return unexpected results
- Network or worker timeout returns a 5xx error

## How this service works

Persian and Iranian utilities for AI agents, plus general text/Unicode tooling. Jalali (Solar Hijri) calendar conversion, Iranian national ID / SHEBA / bank card / postal code / economic code validation, province and city lookup, official public holidays, Persian text normalization, keyword extraction, sentence splitting, similarity, HTML stripping, RTL fixing, Unicode homoglyph folding, script detection, NFC/NFD normalization, grapheme counting, date description, business-day counting, slugify, FNV-1a hashing, Shannon entropy, format and encoding detection, byte sizes. Pay per call in USDC on Base via x402 - no signup, no API key, no KYC. The same tools are also exposed as MCP tools at /mcp.

## Output

Returns a JSON object containing details about the specified Iranian city, including its province association and other available metadata fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "name"
 ],
 "properties": {
  "name": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/irantools-iranian-city-lookup-eab2bab4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from irantools.johnaio281.workers.dev](https://www.zero.xyz/host/irantools.johnaio281.workers.dev/llms.txt)