USGS Earthquake API
USGS Earthquake Catalog API for searching earthquake events, retrieving catalog and contributor lists, and checking service metadata.
Connect this API to an AI agent Browse all specs
What you can do with USGS Earthquake API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /query |
get_query | Query earthquake events Method: GET Path: /query IMPORTANT: This function has 1 REQUIRED parameter(s) and 4 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: REQUIRED: - format: Response format OPTIONAL: - starttime: Start time - endtime: End time - minmagnitude: Minimum magnitude - limit: Maximum events |
| GET | /catalogs |
get_catalogs | List available earthquake catalogs Method: GET Path: /catalogs |
| GET | /contributors |
get_contributors | List earthquake data contributors Method: GET Path: /contributors |
| GET | /version |
get_version | Get FDSN event service version Method: GET Path: /version |
Usage guide
The USGS FDSN event service is publicly readable and does not require an API key or bearer token. Use the documented `format`, time, magnitude, geographic, and pagination parameters, identify your client with a descriptive `User-Agent`, and respect service limits. Official documentation: https://earthquake.usgs.gov/fdsnws/event/1/
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “USGS Earthquake API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.