# Earthquake Intelligence MCP (`red.cars/earthquake-intelligence-mcp`) Actor

Real-time seismic intelligence for AI agents. Query USGS earthquake data, track significant events, assess site and port risk scores.

- **URL**: https://apify.com/red.cars/earthquake-intelligence-mcp.md
- **Developed by:** [AutomateLab](https://apify.com/red.cars) (community)
- **Categories:** AI, Automation, Developer tools
- **Stats:** 0 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Earthquake Intelligence MCP Server

> Real-time seismic data for AI agents. Query USGS earthquake data, track significant events, assess site risk, and evaluate port vulnerability — no API key required.

**[View on Apify](https://apify.com/red.cars/earthquake-intelligence-mcp)** | **[MCP Endpoint](https://earthquake-intelligence-mcp.apify.actor/mcp)**

---

### What It Does

Give AI agents direct access to USGS FDSN earthquake data for real-time seismic intelligence, disaster risk assessment, and emergency response workflows.

- **Earthquake queries** — search earthquakes near any location with custom magnitude, time, and radius filters
- **Significant events** — track M4.5+ seismic events for news alerts and trading signals
- **Site risk scoring** — multi-factor seismic risk assessment for facilities, campuses, and infrastructure
- **Port risk scoring** — evaluate seismic vulnerability of shipping ports and maritime infrastructure

100% free USGS data. No API key required.

---

### Quick Start

Add to your MCP client:

```json
{
  "mcpServers": {
    "earthquake-intelligence-mcp": {
      "url": "https://earthquake-intelligence-mcp.apify.actor/mcp"
    }
  }
}
````

***

### Tools

| Tool | Price | Description |
|------|-------|-------------|
| `get_earthquakes` | $0.03 | Query recent earthquakes near a location with time, magnitude, and radius filters |
| `get_significant_events` | $0.03 | Get significant M4.5+ events from the past 24 hours for news/trading use cases |
| `get_site_risk_score` | $0.05 | Multi-factor seismic risk assessment for a site location |
| `get_port_risk_score` | $0.05 | Seismic risk scores for multiple ports based on recent activity |

#### get\_earthquakes

**When to call:** AI agent assessing seismic activity near a facility, construction site, or investment property.

**Example AI prompt:** "Show me all earthquakes magnitude 2.5+ within 50km of Tokyo in the past week."

#### get\_significant\_events

**When to call:** AI agent monitoring breaking seismic events for news aggregation, commodity trading, or emergency alerting.

**Example AI prompt:** "What significant earthquakes happened in the past 24 hours globally? Focus on M5.0+ events near population centers."

#### get\_site\_risk\_score

**When to call:** AI agent evaluating seismic risk for a facility, data center, or supply chain node during due diligence or emergency planning.

**Example AI prompt:** "What's the seismic risk profile for a data center in San Jose, California over the last 5 years?"

#### get\_port\_risk\_score

**When to call:** AI agent assessing maritime infrastructure risk for shipping logistics, insurance underwriting, or supply chain resilience planning.

**Example AI prompt:** "Assess seismic risk for ports in Yokohama, Singapore, and Rotterdam for the past 48 hours."

***

### Who It's For

#### Emergency Response & Public Safety

Real-time seismic data for disaster coordination, evacuation planning, and first responder routing. Integrate with emergency management systems to auto-trigger alerts when M5.0+ events occur near populated areas.

#### Supply Chain & Logistics

Assess seismic risk for manufacturing facilities, distribution centers, and shipping ports. Factor earthquake exposure into supplier evaluation, inventory positioning, and route optimization decisions.

#### Financial & Commodity Trading

Monitor significant seismic events as inputs for commodity pricing models — earthquakes near mining regions, oil terminals, and manufacturing hubs can disrupt supply chains and move markets.

#### Insurance & Risk Underwriting

Quantify seismic exposure for portfolio risk assessment. Evaluate site-level and regional earthquake risk for policy pricing, catastrophe modeling, and reinsurance decisions.

***

### Data Source

| Source | Coverage | What's Available |
|--------|----------|-----------------|
| USGS FDSN Earthquake API | Global | Real-time earthquake data, magnitude, depth, location, tsunami warnings |

***

### Pricing

| Tool | Per Call |
|------|----------|
| `get_earthquakes` | $0.03 |
| `get_significant_events` | $0.03 |
| `get_site_risk_score` | $0.05 |
| `get_port_risk_score` | $0.05 |

No subscription. Pay per use via Apify PPE.

***

### Example Calls

#### Query earthquakes near a location

```
get_earthquakes(latitude=35.6762, longitude=139.6503, minmagnitude=2.5, maxradiuskm=50, limit=20)
```

Returns:

```json
{
  "count": 8,
  "query": {
    "latitude": 35.6762,
    "longitude": 139.6503,
    "starttime": "2026-05-11",
    "endtime": "2026-05-18",
    "minmagnitude": 2.5,
    "maxradiuskm": 50,
    "limit": 20
  },
  "earthquakes": [
    {
      "id": "us7000abcd",
      "magnitude": 3.8,
      "place": "4km NE of Tokyo, Japan",
      "location": {
        "latitude": 35.702,
        "longitude": 139.758,
        "depth_km": 48.3
      },
      "time": "2026-05-17T14:32:00.000Z",
      "tsunami": false,
      "significance": 120
    }
  ]
}
```

#### Get site risk score

```
get_site_risk_score(latitude=37.3861, longitude=-122.0839, years=5)
```

Returns:

```json
{
  "location": { "latitude": 37.3861, "longitude": -122.0839 },
  "analysis_period_years": 5,
  "total_events": 34,
  "max_magnitude": 4.2,
  "seismic_energy_released_joules": 2.4e12,
  "risk_tier": "moderate",
  "recommendation": "Moderate seismic risk. Conduct periodic structural inspections, secure unsecured furnishings, and review insurance coverage for earthquake damage.",
  "magnitude_distribution": {
    "m2_3": 18,
    "m3_4": 12,
    "m4_5": 3,
    "m5_plus": 1
  }
}
```

#### Get port risk scores

```
get_port_risk_score(ports=[{"name":"Yokohama","latitude":35.4437,"longitude":139.638},{"name":"Singapore","latitude":1.2644,"longitude":103.8198}], hours=48)
```

Returns:

```json
{
  "query": {
    "hours": 48,
    "minmagnitude": 4.0,
    "starttime": "2026-05-16",
    "endtime": "2026-05-18"
  },
  "port_count": 2,
  "ports": [
    {
      "name": "Yokohama",
      "location": { "latitude": 35.4437, "longitude": 139.638 },
      "total_events": 2,
      "max_magnitude": 4.1,
      "seismic_energy_released_joules": 3.1e11,
      "risk_tier": "moderate",
      "recommendation": "Moderate seismic risk. Conduct periodic structural inspections..."
    },
    {
      "name": "Singapore",
      "location": { "latitude": 1.2644, "longitude": 103.8198 },
      "total_events": 0,
      "max_magnitude": 0,
      "seismic_energy_released_joules": 0,
      "risk_tier": "low",
      "recommendation": "Low seismic risk. Maintain general emergency preparedness..."
    }
  ]
}
```

***

### Connect to AI Agents

#### Claude Desktop / Cursor / Windsurf

```json
{
  "mcpServers": {
    "earthquake-intelligence-mcp": {
      "url": "https://earthquake-intelligence-mcp.apify.actor/mcp"
    }
  }
}
```

***

### SEO Keywords

earthquake API, USGS earthquake data, seismic risk assessment, port risk scoring, site risk analysis, real-time earthquake data, AI agent seismic data, disaster risk intelligence, emergency response API, supply chain earthquake risk, commodity trading seismic signals, insurance earthquake risk, seismic data for AI agents

# Actor input Schema

## Actor input object example

```json
{}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("red.cars/earthquake-intelligence-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("red.cars/earthquake-intelligence-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call red.cars/earthquake-intelligence-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=red.cars/earthquake-intelligence-mcp",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Earthquake Intelligence MCP",
        "description": "Real-time seismic intelligence for AI agents. Query USGS earthquake data, track significant events, assess site and port risk scores.",
        "version": "1.0",
        "x-build-id": "U3vLLuCmSyw5bwnS8"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/red.cars~earthquake-intelligence-mcp/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-red.cars-earthquake-intelligence-mcp",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/red.cars~earthquake-intelligence-mcp/runs": {
            "post": {
                "operationId": "runs-sync-red.cars-earthquake-intelligence-mcp",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/red.cars~earthquake-intelligence-mcp/run-sync": {
            "post": {
                "operationId": "run-sync-red.cars-earthquake-intelligence-mcp",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {}
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
