{"schemaVersion":"markgit.tool-docs/v1","tool":{"kind":"tool","id":"bfd220c7-2bfd-4d1d-8701-e737636b22f0","slug":"usgs-earthquake-search","name":"Earthquake Search","description":"Search the official USGS earthquake catalog and receive GeoJSON suitable for maps and agent analysis. Upstream docs: https://earthquake.usgs.gov/fdsnws/event/1/","category":"Data","tags":["earthquakes","geospatial","geojson","science","free","usgs"],"provider":{"id":"200c75ab-f76c-4457-b8f0-d2694de41c12","name":"Open-Meteo","trustTier":"unverified"},"version":{"number":1,"manifestDigest":"a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41","immutable":true},"trust":{"provider":{"tier":"unverified","paymentVerified":false},"endpoint":{"status":"unverified","origin":"https://earthquake.usgs.gov","verifiedAt":null},"version":{"status":"versioned","manifestDigest":"a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41"},"behavior":{"status":"new","evidence":"markgit_calls"}},"risk":{"level":"medium","capabilities":{"declared":true,"readOnly":true,"destructive":false,"idempotent":false,"openWorld":true,"readsPrivateData":false,"seesUntrustedContent":false,"writesExternalData":false,"sendsMessages":false,"spendsMoney":false,"executesCode":false,"requiresUserCredential":false,"allowedOutboundDomains":["earthquake.usgs.gov"],"dataRetention":"unknown"}},"policy":{"callable":true,"monetizationEligible":true,"eligibleForAutoCall":false,"riskLevel":"medium","approval":{"requirement":"explicit_unverified","manifestDigest":"a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41"},"reasons":["endpoint origin is not verified"]},"pricing":{"type":"free","currency":"USD","amount":"0.0000"},"usage":{"count":0,"uniqueUsers":0,"tracked":true,"coverage":"markgit_calls","invocationsLabel":"Under 1K invokes","usersLabel":"Under 100 users"},"updatedAt":"2026-08-01T15:51:47.677Z"},"documentation":{"metadata":"https://api.markgit.com/v1/registry/tools/usgs-earthquake-search","json":"https://api.markgit.com/v1/registry/tools/usgs-earthquake-search/docs","openapi":"https://api.markgit.com/v1/registry/tools/usgs-earthquake-search/openapi.json","llms":"https://api.markgit.com/v1/registry/tools/usgs-earthquake-search/llms.txt"},"invocation":{"flow":["POST /v1/tools/usgs-earthquake-search/quote to receive the exact price and spend-control decision.","Inspect policy.approval and obtain the required user approval for this exact manifest digest and quote total.","POST /v1/tools/usgs-earthquake-search/call with the quote ID, input object, approval manifest digest when required, Bearer API key, and a unique Idempotency-Key."],"quote":{"method":"POST","url":"https://api.markgit.com/v1/tools/usgs-earthquake-search/quote","authentication":"Bearer API key","requestBody":{},"responseSchema":{"type":"object","required":["quote","tool","controls"],"properties":{"quote":{"type":"object","required":["id","priceUsd","feeUsd","totalUsd","expiresAt"],"properties":{"id":{"type":"string","format":"uuid"},"priceUsd":{"type":"string"},"feeUsd":{"type":"string"},"totalUsd":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"controls":{"type":"object","properties":{"approved":{"type":"boolean"},"violations":{"type":"array","items":{"type":"string"}}}}}}},"call":{"method":"POST","url":"https://api.markgit.com/v1/tools/usgs-earthquake-search/call","authentication":"Bearer API key","requiredHeaders":{"Authorization":"Bearer mkgt_...","Content-Type":"application/json","Idempotency-Key":"A unique value for this logical call"},"requestSchema":{"type":"object","required":["quoteId","input"],"properties":{"quoteId":{"type":"string","format":"uuid"},"input":{"type":"object","required":["starttime"],"properties":{"limit":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum number of events to return."},"endtime":{"type":"string","format":"date","example":"2026-07-24","description":"Optional latest event date in YYYY-MM-DD format."},"orderby":{"enum":["time","time-asc","magnitude","magnitude-asc"],"type":"string","default":"time"},"starttime":{"type":"string","format":"date","example":"2026-07-20","description":"Earliest event date in YYYY-MM-DD format."},"minmagnitude":{"type":"number","default":4,"maximum":10,"minimum":-1,"description":"Minimum event magnitude."}}},"approval":{"type":"object","description":"Required unless policy.approval.requirement is covered_by_user_policy.","properties":{"manifestDigest":{"type":"string","const":"a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41"}}}}},"requestExample":{"quoteId":"approved-quote-id","input":{"limit":10,"endtime":"2026-07-24","orderby":"time","starttime":"2026-07-20","minmagnitude":4},"approval":{"manifestDigest":"a00a937bc6f6535133cdabe741b4247d1a69bf4a4abc4af195007e3070985b41"}},"responseSchema":{"type":"object","required":["id","tool","status","cost","output","error"],"properties":{"id":{"type":"string","description":"Execution identifier"},"tool":{"type":"object","properties":{"id":{"type":"string"},"slug":{"const":"usgs-earthquake-search"},"name":{"const":"Earthquake Search"}}},"status":{"type":"string","enum":["completed","failed"]},"cost":{"type":"object","properties":{"priceUsd":{"type":"string"},"feeUsd":{"type":"string"},"totalUsd":{"type":"string"},"currency":{"const":"USD"}}},"output":{"type":"object","required":["type","metadata","features"],"properties":{"type":{"const":"FeatureCollection"},"features":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"geometry":{"type":"object","properties":{"type":{"const":"Point"},"coordinates":{"type":"array","items":{"type":"number"}}}},"properties":{"type":"object","properties":{"mag":{"type":["number","null"]},"url":{"type":"string","format":"uri"},"time":{"type":"integer"},"place":{"type":["string","null"]}}}}}},"metadata":{"type":"object","properties":{"count":{"type":"integer"},"title":{"type":"string"},"status":{"type":"integer"}}}}},"error":{"anyOf":[{"type":"null"},{"type":"object","properties":{"message":{"type":"string"}}}]}}},"responseExample":{"id":"execution-id","tool":{"id":"bfd220c7-2bfd-4d1d-8701-e737636b22f0","slug":"usgs-earthquake-search","name":"Earthquake Search"},"status":"completed","cost":{"priceUsd":"0.0000","feeUsd":"0.0000","totalUsd":"0.0000","currency":"USD"},"output":{"type":null,"features":[{"id":"string","geometry":{"type":null,"coordinates":[1.5]},"properties":{"mag":null,"url":"https://example.com","time":1,"place":null}}],"metadata":{"count":1,"title":"string","status":1}},"error":null}},"direct":null}}