com.sibfly/ground-motion

Official9 tools

by james-sib

Measured ground motion per US address (NASA InSAR). Self-register, $0.40/report, misses free.

Provides measured ground motion data (sinking or uplift rates) for US addresses using NASA satellite imagery.

Topics

apiclimate-riskgeospatialground-motioninsarmcpnasa-operareal-estatesentinel-1subsidence

Captured live from the server via tools/list.

check_ground_motion

Measured ground motion (sinking/uplift) for a US address or lat/lon, in mm/year AND in/year, from NASA OPERA Sentinel-1 InSAR. Costs $0.40 from your SibFly credits; out-of-coverage / too-stale / too-low-confidence / fuzzy-geocode return FREE. Use the gate params to avoid paying for data you'd reject. dry_run=true is a FREE coverage+cost preview.

Parameters (10)

addressstring
US street address
latnumber
lonnumber
explainboolean
add ground_brief: ~600 tokens of plain-English narration + FAQ (engine GL52 free tier / CL46 paying). Adds ~10s latency. Only set when a human will read the output; use ask_inspector for follow-up Q&A.
dry_runboolean
FREE preview: coverage + would_cost + data age, no rate, no charge
max_age_daysinteger
if data older than this, return free instead of billing
min_confidencenumber
0-1; below this, return free instead of billing
sincestring
YYYY-MM-DD; if no new data since this date, return free
require_significantboolean
if the rate would be no_clear_trend (within its error bar), return FREE instead of billing — never pay for statistical noise
compactboolean
lean payload (fewer tokens)

check_portfolio

Batch ground-motion for many US addresses in one call. Only covered addresses are billed ($0.40 each); misses and duplicate cells are free. If credits run out mid-batch the response status is 'insufficient_credits' and unbilled items are marked — top up (buy_credits) and retry them.

Parameters (2)

addressesarrayrequired
up to 1000 US addresses (must be an ARRAY, not one string)
max_spend_usdnumber
hard budget cap: billing stops at this total; over-budget items come back skipped_for_budget

get_coverage

FREE pre-flight: is a US address/point covered, how stale is the data (data_age_days), and what a report would cost. Accepts ONE address/lat+lon, OR addresses[] (up to 1000, needs your Bearer key) to size a whole job before spending. Call this before spending.

Parameters (4)

addressstring
latnumber
lonnumber
addressesarray
batch mode: size a whole job in one free call

get_motion_history

Multi-year cumulative motion history for an address. Pass from_date and to_date (YYYY-MM-DD) to get the movement between two dates. Costs $0.40 (misses free). dry_run=true is a FREE preview (points + dates + cost, no data); max_age_days returns free instead of billing for stale data.

Parameters (7)

addressstring
latnumber
lonnumber
from_datestring
to_datestring
dry_runboolean
FREE preview: coverage + n_points + would_cost, no series, no charge
max_age_daysinteger
if data older than this, return free instead of billing

get_account

FREE: your SibFly credit balance, price per report, reports remaining, and top-up URL.

No parameters.

register_agent

FREE: create a new SibFly account and get an API key + free starter credits in ONE call — no human, no captcha, no card. Use this when you have no API key. SAVE the returned api_key and pass it as the Bearer token on later calls (MCP clients: set it as the Authorization header).

Parameters (2)

emailstringrequired
a durable email address (disposable domains rejected)
passwordstring
optional; auto-generated and returned if omitted

buy_credits

Get a machine-usable payment link to top up credits (requires your Bearer API key). method 'stripe' returns a card checkout_url; 'crypto' returns a BTC invoice_url + txn_id. Open/relay the URL to complete payment; credits land automatically afterwards — confirm with get_account.

Parameters (2)

amount_usdnumberrequired
1 to 10000 (USD)
methodstring
default stripe (card)

ask_inspector

FREE follow-up Q&A with the SibFly Inspector about a report you ALREADY BOUGHT (buy via check_ground_motion first). Ask what the numbers mean for foundations, staleness, seasonal swings, etc. It answers only from the report's numbers (never invents), and won't give buy/walk-away advice. Per-account message allowance applies.

Parameters (2)

questionstringrequired
your question about the report
addressstringrequired
the address of a report already purchased on this account

get_usage

FREE: your recent billed calls (line-item ledger with request_id, endpoint, address, cost) so you can reconcile spend against reports.

Parameters (1)

limitinteger
max rows, default 100, max 1000

README.md2 KBView on GitHub

SibFly — measured ground subsidence API (mm/year) for any US address

Is the ground under an address sinking? SibFly returns measured vertical ground motion — subsidence and uplift, in millimeters per year and inches per year — for any US address, from NASA OPERA Sentinel-1 InSAR satellite radar. Measured, not modeled.

Live API: https://sibfly.com
Docs (human + agent): https://sibfly.com/docs
Agent docs: https://sibfly.com/llms.txt · OpenAPI: https://sibfly.com/openapi.json · Machine schema: https://sibfly.com/api/v1/schema
MCP server: https://sibfly.com/mcp (Streamable HTTP)

Quickstart

bash

# 1) an AI agent can register itself — no human, no captcha
curl -X POST https://sibfly.com/api/v1/autonomous/register \
  -H "Content-Type: application/json" -d '{"email":"YOUR_EMAIL"}'

# 2) measure the ground under an address
curl "https://sibfly.com/api/v1/motion?address=1100+Congress+Ave+Austin+TX" \
  -H "Authorization: Bearer sf_live_..."

Returns velocity_vertical_mm_yr / _in_yr, an uncertainty range, assessment_code, confidence, provenance, and cost. Flat $0.40 per covered report; misses are free; free coverage/cost preflight via ?dry_run=1.

What it is

Data: NASA OPERA DISP-S1 (Copernicus Sentinel-1 C-band InSAR), 30 m grid, 2016–present.
Vertical mm/year of ground movement (not elevation), measured, per exact 30 m cell, with uncertainty.
Coverage: US (expanding). Not real-time (source refreshes ~every 12 days); a screening estimate, not survey-grade.

For AI agents

Self-registration, free coverage/cost preflight, idempotency keys, per-key spend caps, scoped browser-safe keys, batch, and a hosted MCP server (tools: check_ground_motion, check_portfolio, get_coverage, get_motion_history, get_account). The full, authoritative contract lives at https://sibfly.com/llms.txt and https://sibfly.com/openapi.json — always current.

Use cases

Real-estate due diligence · "is my house sinking?" for home buyers · insurance & mortgage underwriting screening · infrastructure and portfolio subsidence monitoring · geotechnical pre-screening.

A product of SIB Scientific. Screening estimate from satellite radar (NASA OPERA / Sentinel-1 InSAR) — not an engineering, survey, or hazard determination.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "ground-motion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://sibfly.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.