Overview
What is Node Api?
Node Api is a machine-native spatial data processing API for AI agents and developers. It provides 25 endpoints for geospatial operations, paid via $0.01 USDC micropayments on Solana Mainnet, with no accounts, API keys, or subscriptions required.
How to use Node Api?
Send a POST request to any endpoint with your spatial file; the API returns a 402 with Solana Pay recipient details. Send exactly 0.01 USDC on Solana Mainnet (include memo nodeapi:<operation>), then retry the request with the X-PAYMENT header containing your transaction signature. Alternatively, connect any MCP client to the SSE endpoint at https://nodeapi.ai/mcp/sse for remote tool access.
Key features of Node Api
- 25 endpoints for spatial data processing (format conversion, validation, reprojection, geoprocessing, vector tiles)
- $0.01 flat fee per operation via Solana Pay (USDC on Solana Mainnet)
- MCP integration with 22 tools, accessible via SSE (remote) or stdio (local)
- No accounts, API keys, or subscriptions – pay per operation
- Supports GeoJSON, Shapefile (.zip), GeoPackage (.gpkg), KML, GDB, and DXF
- Webhooks for async jobs with HMAC-signed payloads
Use cases of Node Api
- Validate and repair geometry in GeoJSON or Shapefile datasets
- Convert between vector formats (GeoJSON, Shapefile, GeoPackage, KML)
- Buffer, clip, intersect, or union multiple spatial layers for analysis
- Extract geometry from DXF/CAD files and export as GeoJSON
- Generate vector tile packages (.mbtiles) for web mapping
FAQ from Node Api
How much does each operation cost?
Each paid endpoint costs $0.01 USDC flat, sent via Solana Pay on Solana Mainnet. The payment is per API call, regardless of file size.
Do I need an account or API key?
No. Node Api uses no accounts, API keys, or subscriptions. Pay per operation using Solana Pay.
What spatial formats does Node Api support?
Input formats: GeoJSON, Shapefile (zipped), GeoPackage, KML, GDB (read only), and DXF. Output is typically GeoJSON, but conversion endpoints accept multiple output formats.
How do I handle large files or async jobs?
For large files (e.g., DXF conversion), pass a webhook_url parameter. Node Api will process the job asynchronously and POST a result payload to your URL when complete, including a download link.
How can I integrate Node Api with an AI agent?
Node Api exposes all 25 endpoints as MCP tools. Connect any MCP client (e.g., Claude Desktop) to the remote SSE endpoint https://nodeapi.ai/mcp/sse without authentication, or run the local MCP server with a Python venv.
