◆§ developersSDK · API · MCP
Build on a planetary datastore.
One SDK, three settlement rails, every dataset attested. Query reads, invoke agents, and publish observations from your stack or from your LLM.
Settlement rails are , , and . Reads are metered via micropayments in . Every call is signed by your .
TypeScript / JS
npm i @naturecode/sdkPython
pip install naturecodecURL / HTTP
https://api.naturecode.earth/v0MCP server
npx @naturecode/mcp◆§ quickstart
From zero to your first query in 60 seconds.
Install the SDK, authenticate with your DID, and make your first read. Every query returns data plus a signed receipt.
quickstart.ts
import { naturecode } from "@naturecode/sdk";
const nc = naturecode({ apiKey: process.env.NC_API_KEY });
// 1. List datasets
const datasets = await nc.datasets.list({ kind: "biodiversity" });
// 2. Read the latest observations
const obs = await nc.datasets("NC-FAA-CNP-01").observations({ limit: 10 });
console.log(obs);
// [{ ts, payload: { sst_c, ph, ... }, verdict, receipt }, ...]◆◆ REST endpoints · quickstart
- GET/v0/datasets
- GET/v0/datasets/{id}/observations
◆◆ rate limits
- free tier100 reads / day
- researcher25k reads / month
- institutionalunlimited · Canton settlement
◆§ build something real