{"uid":"cap_peCZ6lu4mGVarhJvkOPNx","slug":"irantools-iranian-city-lookup-eab2bab4","name":"IranTools - Iranian City Lookup","description":"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.","url":"https://irantools.johnaio281.workers.dev/api/iran/iran_city?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},"responseSchema":{"type":"object","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AuDUhj66Wso9WUIuE2lxV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up information about an Iranian city by name, returning province and city details","exampleAgentPrompt":"Look up city information for 'Tabriz' in Iran — I need to know which province it belongs to and any other available details.","exampleUseCases":[{"title":"Province lookup for Iranian address","prompt":"I have an address in 'Mashhad' — can you look it up and tell me which province it's in so I can fill out this form correctly?"},{"title":"Validate city name in form data","prompt":"A user entered 'Qom' as their city in Iran — can you look it up to confirm it's a valid Iranian city and get its province details?"},{"title":"Enrich Iranian shipping address","prompt":"I need to enrich this shipping record with province info — the destination city is 'Ahvaz' in Iran, can you find the province and any other city details?"}],"resultDescription":"Returns a JSON object containing details about the specified Iranian city, including its province association and other available metadata fields.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:48.201Z","isFirstParty":false,"canonicalSlug":"irantools-iranian-city-lookup-eab2bab4"}