# Hydrometric — agents.txt
# UK flood hydrology (FEH statistical, ReFH2, DDF, climate allowances). This file tells agents how to use the service.

Name: Hydrometric
Description: AI-native UK flood hydrology platform. Runs the full FEH2025 default-route assessment (QMED, pooling, growth curve, design flows) against the frozen NRFA Peak Flow Dataset.
Homepage: https://www.hydrometric.io
Contact: https://www.hydrometric.io/waitlist

## MCP
Endpoint: https://www.hydrometric.io/api/mcp
Transport: Streamable HTTP (JSON-RPC 2.0 over POST; GET for server-initiated streams).
Protocol: Model Context Protocol. Tools only (no resources/prompts yet).

## Auth
Bearer-only. No cookies.
  Authorization: Bearer hm_live_...   (per-user API key — create at https://www.hydrometric.io/account/api-keys)
Request a key: https://www.hydrometric.io/waitlist
Legacy service integrations may instead send the shared HYDROMETRIC_API_KEY plus x-hydrometric-user-email.

## Tools
- search_stations: Search the frozen NRFA Peak Flow Dataset by id, river or location. Free.
- get_station: Descriptors, record length, suitability for one station. Free.
- run_gauged_assessment: Full default-route FEH2025 assessment for a gauged station. 1 credit (free on cache hit).
- run_ungauged_assessment: FEH statistical estimate from descriptors + BNG location. 1 credit.
- get_qmed: Recommended QMED (m³/s) view over a cached run.
- get_growth_curve: Adopted growth curve + pooling summary over a cached run.
- get_design_flows: Design flows (m³/s) by return period over a cached run.
- get_report: FEH report as Markdown; PDF/DOCX as signed-in URLs.
- list_saved_analyses: The caller's saved analyses. Read-only.
- get_saved_analysis: One saved analysis, adopted route resolved. Read-only.
- get_catchment_map: Map figures for a station from the caller's saved analyses.
- run_method_space: Method Space: every method-valid variant of an analysis (station, saved analysis or descriptors) — P10/P50/P90 + FSE per metric, named variants, compare your numbers, qmedRoute filter (all|amax|descriptors), PNG figure. £20 per run credit (free re-run of a paid analysis; admins/grantees exempt).
- get_method_space_credits: Method Space credit balance + purchase URL. Free.

## Limits
Rate limit: 60 requests/minute per key (HTTP 429 with Retry-After).
Credits: run_gauged_assessment / run_ungauged_assessment consume 1 assessment credit each; free tier includes 5 assessments, paid tiers are unlimited. Exhausted quota returns a tool error with code "quota_exhausted".
Method Space: run_method_space costs one £20 run credit per distinct analysis (bought at https://www.hydrometric.io/account/usage). No credit ⇒ tool error code "method_space_credit_required" with a purchaseUrl to hand to the user. REST equivalent: POST https://www.hydrometric.io/api/v1/method-space (same bearer key, same body).
Units: flows m³/s, areas km², rainfall mm, coordinates British National Grid metres.

## Skill
Claude Code skill: https://www.hydrometric.io/agent/SKILL.md
Human docs: https://www.hydrometric.io/llms.txt