IranTools (paid)

iran_landline

Origin URL: https://irantools.johnaio281.workers.dev Origin hostname: irantools.johnaio281.workers.dev Origin brand: IranTools - paid MCP server for AI agents Provider aliases: Iranian landline validator, Area code lookup Family key: irantools.johnaio281.workers.dev::iran Endpoint: POST /api/iran/iran_landline Summary: Validate an Iranian landline number (0xx) and report its area code and city. Keyword: iranian landline Keyword: telephone area code Keyword: city dial code Keyword: fixed line iran Keyword: 021 tehran Use case: validate an Iranian landline and report its area code Use case: find which city a 021 number belongs to Use case: check a fixed-line number with a region prefix Source description: Validate an Iranian landline number (0xx) and report its area code and city. Auth mode: paid

Price: $0.003 per call (USDC on Base via x402, or USDC on Tempo via MPP).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "value": "<value>"
    },
    "name": "iran_landline"
  }
}

Input Schema

Name	Required	Description	Default
`value`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 21, 2026

TDQS

B3.2/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose non-obvious behavior: paid auth mode and exact cost ($0.003/call via x402 or MPP), plus the POST endpoint. However, it says nothing about behavior on invalid input, error responses, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The text is dominated by machine-generated metadata (origin URL, hostname, brand, family key, repeated 'Keyword:' lines that restate the same concept five times). The one sentence an agent actually needs is the Summary, which appears mid-block rather than first.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-param validator with no output schema, the description does state what is returned (area code and city) and covers cost and transport. It stops short of describing error/invalid-number behavior and the exact response shape, which is the main remaining gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

One required parameter ('value') with 0% schema description coverage, so the schema explains nothing. The description compensates partially by implying the expected input is a landline number in 0xx format, but gives no length, digit-set, or accepted-separator details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The Summary line states a specific verb and resource: 'Validate an Iranian landline number (0xx) and report its area code and city.' That is clear and distinguishable from sibling iran_mobile by the 'landline' scope, though the useful sentence is buried under origin/hostname/brand metadata rather than front-loaded.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Three 'Use case' lines give concrete scenarios (validate a landline, map 021 to a city, check a region-prefixed fixed line). That is implied usage context, but there is no explicit guidance on when to prefer this over iran_mobile or iran_city, and no exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All IranTools (paid) tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?