# ProbeLine

> Pay-per-call dental reference API for AI agents. Periodontal diagnosis from a de-identified 6-point chart (2017 AAP/EFP stage, extent, grade, ICD-10-CM suggestions) and a sourced dental implant database (connections, platforms, abutment screw torque). Payment is USDC on Base via x402: no account, no API key.

Base URL: https://probeline.io
Payment: x402 v2, scheme "exact", network eip155:8453 (Base mainnet), asset USDC. A paid route without payment returns HTTP 402 with a PAYMENT-REQUIRED header; sign the payment and retry with PAYMENT-SIGNATURE. Any x402 client library (e.g. @x402/fetch, x402 Python) handles this automatically.

Rules for callers:
- Send no patient identifiers (no names, dates of birth, record numbers, dates of service). Request bodies are never logged.
- Output is clinical decision support for licensed dental professionals. Every result includes the criteria behind it; the clinician makes the diagnosis.
- Implant values are sourced from manufacturer documents; unknown values are null, never estimated. Verify torque against the current IFU before use.

## Endpoints

- [POST /v1/perio/diagnose](https://probeline.io/openapi.json) ($0.25): Body `{ patient: { age, smoking: { status, cigarettes_per_day }, diabetes: { diagnosed, hba1c } }, teeth_lost_to_perio, chart: [ { tooth (1-32 Universal), pd[6], rec[6], bop[6], mobility, furcation, rbl_pct } ] }`. Site order for 6-value arrays: distofacial, facial, mesiofacial, distolingual, lingual, mesiolingual. Returns stage, extent, grade with rationale, ICD-10-CM suggestions (K05.2x/K05.3x), documentation checklist and per-tooth findings.
- [GET /v1/implants](https://probeline.io/v1/implants) (free): List or search implant systems. Query: `q`, `manufacturer`, `connection`, `status`. Returns ids for the detail route.
- [GET /v1/implants/{id}](https://probeline.io/openapi.json) ($0.05): Full spec for one system, e.g. `/v1/implants/straumann-bl`: connection, platforms, implant diameters and lengths, abutment screw torque, multi-unit abutment torque, driver, with a source URL for each value.
- [POST /v1/implants/identify](https://probeline.io/openapi.json) ($0.10): Rank likely implant systems from observed features. Body `{ connection_type, platform_diameter_mm, body_diameter_mm, body_shape (tapered|parallel|hybrid), level (bone|tissue), manufacturer_hint, limit }`. Returns ranked candidates with reasons.

## MCP

- Remote MCP server: `https://probeline.io/mcp` (Streamable HTTP, stateless, POST only). Tools: `search_implants` (free), `get_implant` ($0.05), `identify_implant` ($0.10), `diagnose_periodontitis` ($0.25). Paid tools use x402 over MCP: an unpaid call returns a PaymentRequired result; x402-aware MCP clients (e.g. @x402/mcp) pay and retry automatically.

## Docs

- [OpenAPI spec](https://probeline.io/openapi.json): Full request and response schemas.
- [Service info](https://probeline.io/): Current prices, network and implant database coverage.

## Optional

- [Health](https://probeline.io/health): Liveness check.