# Caliper

> Geometry and CAD file metadata extraction. Accepts geometry files by URL or base64, returns structured statistics as JSON. Payment required via x402 (USDC on Base).

## API

- [MCP Endpoint](https://caliper.fit/mcp/): Streamable HTTP MCP transport for tool discovery and invocation
- [MCP Manifest](https://caliper.fit/mcp/manifest): JSON manifest with tool schemas
- [Health Check](https://caliper.fit/health): Service status endpoint

## Tools

- caliper_detect_format: Detect the geometry file format from a filename or URL.
- caliper_auto_stats: Auto-detect geometry file format and extract metadata statistics.
- caliper_stl_stats: Extract metadata from an STL file (ASCII or binary).
- caliper_obj_stats: Extract metadata from an OBJ file.
- caliper_ply_stats: Extract metadata from a PLY file (ASCII or binary).
- caliper_pcd_stats: Extract metadata from a PCD point cloud file.
- caliper_las_stats: Extract metadata from a LAS or LAZ point cloud file.
- caliper_gltf_stats: Extract metadata from a glTF or GLB file.
- caliper_batch_stats: Analyze multiple geometry files in a single batch request.

## Usage

Each tool accepts either `file_url` (HTTP/S URL, preferred for large files) or `file_b64` (base64-encoded, max 200KB decoded), plus an optional `filename` for format detection. Use `caliper_batch_stats` to analyze up to 10 files with a single payment.

REST API endpoints at `/tools/caliper_*_stats` require x402 payment (USDC on Base). The MCP transport at `/mcp/` provides direct access for tool discovery.

## Supported Formats

STL, OBJ, PLY, PCD, LAS / LAZ, glTF / GLB. STEP, IGES support is planned.