Meridian
meridian.nodeapi.ai · v0.5.1 · 43 endpoints · API key + x402

Geospatial processing for agents, scripts, and people who want the answer fast.

Meridian is a GIS and raster processing API with 43 production endpoints — vector, topology, DEM, raster math, export formats, and Alaska elevation data. Authenticate with an API key (X-Mcp-Key header). x402 payment on Base is also supported but currently disabled by default. No subscription. No dashboard maze.

Open docs See quickstart Open operator panel
Runtime
Rust / Axum
GIS Engine
GDAL 3.8 · GEOS
Auth
API key · x402 available · disabled by default

Quickstart

This is the part an agent cares about: endpoint, payment flow, result.

# API key auth (current default)
curl -X POST https://meridianapi.nodeapi.ai/v1/reproject \
  -H "X-Mcp-Key: YOUR_API_KEY" \
  -F "file=@input.geojson" \
  -F "target_crs=EPSG:3857"

# x402 payment auth (when enabled)
# 1) Call endpoint → receive 402 with payment requirements
# 2) Sign EIP-3009 authorization with your Base wallet
# 3) Retry with X-PAYMENT header
curl -X POST https://meridianapi.nodeapi.ai/v1/reproject \
  -H "X-PAYMENT: <base64-eip3009-payload>" \
  -F "file=@input.geojson" \
  -F "target_crs=EPSG:3857"

How payment works

  • 1. Request: call any paid endpoint with a file.
  • 2. Receive 402: Meridian returns payment requirements.
  • 3. Sign: your agent signs an EIP-3009 authorization off-chain.
  • 4. Retry: send the same request with X-PAYMENT.
  • 5. Settle: facilitator submits transferWithAuthorization() on Base.
  • 6. Result: operation runs and returns data.

Operations

Current surface area: 43 production endpoints spanning vector, topology, DEM, raster math, export, and elevation.

Core GIS

  • reproject
  • buffer
  • clip
  • dissolve
  • convert
  • calculate-geometry

Schema & validation

  • schema
  • validate
  • repair

Transforms

  • erase
  • feature-to-point
  • feature-to-line
  • feature-to-polygon
  • multipart-to-singlepart
  • add-field

Topology & combine

  • union
  • intersect
  • difference
  • append
  • merge
  • spatial-join

Batch & tiles

  • batch
  • vectorize (.mbtiles)

DEM & raster

  • hillshade
  • slope
  • aspect
  • roughness
  • color-relief
  • contours
  • raster-calc
  • raster-warp
  • raster-to-vector
  • convert/raster
  • mosaic
  • reclassify

Export formats

  • export/dxf
  • export/kml
  • export/shapefile
  • export/jgw
  • package/gdb

Document & reference

  • pdf/rasterize
  • raster-georeference

Elevation (Alaska)

  • elevation/fetch-dggs (async)
  • jobs/:id/status
  • jobs/:id/result

Why this version exists

Rust/Axum rewrite with 43 endpoints, async elevation jobs, and dual auth (API key + x402 on Base).
  • API key auth: pass X-Mcp-Key header. x402 payment also available when enabled.
  • No subscriptions: pay per operation or use your API key.
  • Docs stay current: OpenAPI generated from codebase.
  • Acceptance-tested: full black-box production sweep passed 22/22 (2026-03-12).
  • Async elevation: Alaska DGGS IfSAR DTM fetch via job queue (POST → job_id → poll → result).
  • Export formats: DXF, KML, Shapefile, JGW, File Geodatabase.
  • Fast path: good fit for agents, scripts, and backend workflows.

Pricing

Simple enough to remember.

$0.01 / MB
Usage-based pricing
$0.01 min
Small files round up
$2.00 max
Hard cap per operation

Example: a 500KB GeoJSON reproject calculates to $0.005 and rounds up to the $0.01 minimum.

Useful links

  • /docs — OpenAPI reference
  • /v1/health — health endpoint
  • /metrics — Prometheus metrics
  • POST /v1/reproject — reproject vector/raster
  • POST /v1/hillshade — DEM shaded relief
  • POST /v1/raster-calc — pixel math across raster inputs
  • POST /v1/batch — multiple ops in one request
  • POST /v1/export/shapefile — GeoJSON to zipped Shapefile
  • POST /v1/package/gdb — multi-layer File Geodatabase
  • POST /v1/elevation/fetch-dggs — async Alaska IfSAR DTM

Integrate

Three ways to use Meridian, depending on your setup.

Direct API

Any HTTP client. POST a file with your API key, get your result. Full OpenAPI docs at meridianapi.nodeapi.ai/docs.

# Example: reproject a GeoJSON file to Web Mercator
curl -X POST https://meridianapi.nodeapi.ai/v1/reproject \
  -H "X-Mcp-Key: YOUR_API_KEY" \
  -F "file=@input.geojson" \
  -F "target_crs=EPSG:3857"

# Replace /v1/reproject with any of the 43 endpoints

OpenClaw Agent Skill

For agents running on OpenClaw. Install the Meridian skill and your agent gains full knowledge of the API, payment flow, and endpoint surface — no manual setup.

clawhub install meridian

Operator Panel

Meridian is built for agent-native workflows first. This manual interface uses the same production API for ad hoc runs, testing, validation, and human-operated jobs.

43 operations Quote → pay → run → download Same API agents use
Choose your main file first. The panel will auto-detect vector vs raster when possible, including by inspecting ZIP contents when it can.
Upload a file, then select an applicable operation.

This panel can only call wallets already attached to this browser session. Click a wallet icon below to select and connect it.

Run status Idle

Select an operation and enter inputs to request a quote.

0%
Request summary
Endpoint
—
Input mode
—
Files
—
Parameters
—
Quote
No quote yet.
Wallet
Not connected.
Result
No result yet.
Raw response / error
—