# Iran Earthquakes (pypi · iran-quake-mcp)

Unofficial read-only Iran earthquakes: latest, search, strongest, detail, stats (USGS, EMSC, IRSC).

- Trust score: 79/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-22

## Components

- pypi · `iran-quake-mcp`: 79/100 (this document), [markdown](https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp.md), [page](https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp)

## Channel facts

- Registry: `pypi`
- Package: `iran-quake-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-22.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 1 of 35 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to sepehr071/iran-quake-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1952 tokens (~390/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Iran Earthquakes MCP server?

Iran Earthquakes runs locally as a PyPI package, launched with uvx iran-quake-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add sepehr071-iran-quake-mcp -- uvx iran-quake-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "sepehr071-iran-quake-mcp": {
      "command": "uvx",
      "args": [
        "iran-quake-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "sepehr071-iran-quake-mcp": {
      "command": "uvx",
      "args": [
        "iran-quake-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add sepehr071-iran-quake-mcp -- uvx iran-quake-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sepehr071-iran-quake-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "iran-quake-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add sepehr071-iran-quake-mcp --command uvx --arg iran-quake-mcp
```

### Hermes

```yaml
mcp_servers:
  sepehr071-iran-quake-mcp:
    command: "uvx"
    args: ["iran-quake-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "sepehr071-iran-quake-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "iran-quake-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add sepehr071-iran-quake-mcp -t stdio -c uvx -a iran-quake-mcp
```

### Other

```json
{
  "mcpServers": {
    "sepehr071-iran-quake-mcp": {
      "command": "uvx",
      "args": [
        "iran-quake-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-22 (score 79, +16)

- [security regression] Tool safety: pass → unverified
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Stability: unverified → 0.07
- [functional] First check of Schema quality: unverified
- [functional] Package version: 0.1.0 → 0.1.1

### 2026-10-20 (score 63)

First indexed and scored.

## MCP tools (5)

### `eq_latest` (~277 tokens)

Latest earthquakes

List the most recent earthquakes in Iran, newest first.

Use for "was there an earthquake today?". Times: time_utc and time_tehran (UTC+03:30); depth_km in km;
magnitude type in mag_type (mb, ml, mw...). Call eq_detail with an id for more, eq_stats for counts.

Input parameters:

- `hours` (integer): Look back this many hours, e.g. 24.
- `iran_only` (boolean): True (default): keep only events inside a coarse Iran outline (lat/lon, includes Iranian waters) whose place text names Iran (or Persian Gulf, Gulf of Oman, Caspian Sea); neighbours across the border…
- `limit` (integer): Max events to return, 1-50 (a reply stays under 15 KB), e.g. 20.
- `min_magnitude` (number): Minimum magnitude, e.g. 3.0.
- `source` (string): Data source: 'usgs' (USGS ComCat, default), 'emsc' (EMSC via SeismicPortal) or 'irsc' (Iranian Seismological Center, only its latest ~20 events, with province names). Magnitudes and locations differ…

### `eq_search` (~616 tokens)

Search earthquakes

Search earthquakes in Iran by date range, magnitude, bounding box and place text.

Use for history ("M5+ in 2026", "quakes near Bam"). USGS and EMSC have no province field: USGS gives the nearest
town ('70 km NNE of Minab, Iran'), EMSC a region ('SOUTHERN IRAN'); filter by `place` (a province name works) or
\`bbox`. source='irsc' only knows its latest ~20 events, so older dates give `more`=true with few rows.
Times: time_utc and time_tehran (UTC+03:30); depth_km in km. `more` = more results may exist beyond `limit`
(or beyond the newest 500 events scanned when filtering by place/iran_only: narrow the dates or bbox).

Input parameters:

- `bbox`: Box 'min_lat,min_lon,max_lat,max_lon', e.g. '35,50,36,52' (Tehran area). Default: all Iran.
- `end_date`: End, UTC, same format, e.g. '2026-10-15' (a date alone includes that whole day). Default: now.
- `iran_only` (boolean): True (default): keep only events inside a coarse Iran outline (lat/lon, includes Iranian waters) whose place text names Iran (or Persian Gulf, Gulf of Oman, Caspian Sea); neighbours across the border…
- `limit` (integer): Max events to return, 1-50 (a reply stays under 15 KB), e.g. 20.
- `max_magnitude`: Maximum magnitude, e.g. 6.
- `min_magnitude`: Minimum magnitude, e.g. 4.5.
- `order` (string): 'time' (newest first, default) or 'magnitude' (largest first).
- `place`: Text the place must contain, case and accents ignored, e.g. 'Minab' or 'southern iran' (EMSC region); IRSC places are 'Town, Province'. A province name (Tehran, Kerman, Hormozgan, Khuzestan, Fars, Si…
- `source` (string): Data source: 'usgs' (USGS ComCat, default), 'emsc' (EMSC via SeismicPortal) or 'irsc' (Iranian Seismological Center, only its latest ~20 events, with province names). Magnitudes and locations differ…
- `start_date` (string, required): Start, UTC: 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:MM:SS', e.g. '2026-10-01'.

### `eq_significant` (~241 tokens)

Significant earthquakes

List the strongest recent earthquakes in Iran, largest magnitude first.

Use for "biggest earthquakes this month/year". Times in UTC and Tehran (UTC+03:30), depth_km in km.

Input parameters:

- `days` (integer): Look back this many days, e.g. 30.
- `iran_only` (boolean): True (default): keep only events inside a coarse Iran outline (lat/lon, includes Iranian waters) whose place text names Iran (or Persian Gulf, Gulf of Oman, Caspian Sea); neighbours across the border…
- `limit` (integer): Max events to return, 1-50, e.g. 10.
- `min_magnitude` (number): Minimum magnitude, e.g. 5.0.
- `source` (string): Data source: 'usgs' (USGS ComCat, default), 'emsc' (EMSC via SeismicPortal) or 'irsc' (Iranian Seismological Center, only its latest ~20 events, with province names). Magnitudes and locations differ…

### `eq_detail` (~169 tokens)

Earthquake detail

Get one earthquake in full: location, depth_km, magnitude type and source quality fields.

The source is detected from the id format (IRSC: plain number, found only in its latest ~20 events, adds
the nearest towns). USGS adds review status, shaking (felt reports, cdi, mmi),
tsunami flag, sig (significance 0-1000), nst (stations), gap (degrees), rms; EMSC adds the contributing
agency (catalog) and last update. Times in UTC and Tehran (UTC+03:30).

Input parameters:

- `event_id` (string, required): Event id from another eq_ tool: USGS 'us6000u2w9', EMSC '20261016_0000282' or IRSC '213549'.

### `eq_stats` (~255 tokens)

Earthquake statistics

Count earthquakes in Iran over a window: by magnitude band, by place, plus the strongest event.

Use for "how active has Iran been this month". Places are USGS nearest towns or EMSC regions (no province
data). `truncated` = the source returned its full 3000 rows before the Iran filter, so the count covers only the newest.

Input parameters:

- `days` (integer): Window length in days, ending now, e.g. 30.
- `iran_only` (boolean): True (default): keep only events inside a coarse Iran outline (lat/lon, includes Iranian waters) whose place text names Iran (or Persian Gulf, Gulf of Oman, Caspian Sea); neighbours across the border…
- `min_magnitude` (number): Minimum magnitude counted, e.g. 3.0.
- `source` (string): Data source: 'usgs' (USGS ComCat, default), 'emsc' (EMSC via SeismicPortal) or 'irsc' (Iranian Seismological Center, only its latest ~20 events, with province names). Magnitudes and locations differ…

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp#diagnostics

## Score history

- 2026-10-22: 79
- 2026-10-21: 63
- 2026-10-20: 63

## Common questions

### What is the Iran Earthquakes MCP server?

Iran Earthquakes is an MCP server listed in the public MCP registry as io.github.sepehr071/iran-quake-mcp. Unofficial read-only Iran earthquakes: latest, search, strongest, detail, stats (USGS, EMSC, IRSC). This page covers its PyPI package (iran-quake-mcp).

### Is the Iran Earthquakes MCP server safe to use?

Iran Earthquakes scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Iran Earthquakes MCP server expose?

Iran Earthquakes exposes 5 tools: eq_latest, eq_search, eq_significant, eq_detail, eq_stats. Their descriptions and schemas cost roughly 1,558 tokens of context every time the server is loaded.

### Is the Iran Earthquakes MCP server still maintained?

Iran Earthquakes is still listed as active in the MCP registry. We last reached this channel on 22 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Iran Earthquakes MCP server under?

Iran Earthquakes declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/iran-quake-mcp/
- Socket report: https://socket.dev/pypi/package/iran-quake-mcp
- Repository: https://github.com/sepehr071/iran-quake-mcp
- Changelog RSS feed: https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp.json
- HTML version of this page: https://verifymcp.io/servers/sepehr071-iran-quake-mcp/iran-quake-mcp