Naturecode/ 01
§ developersSDK · API · MCP

Build on a planetary datastore.

One SDK, every dataset attested. Query reads, invoke agents, and publish observations from your stack or from your assistant.

Every observation is signed at the source and anchored to a tamper-evident proof. Every read comes back with a receipt you can verify.

TypeScript / JS
npm i @naturecode/sdk
Python
pip install naturecode
cURL / HTTP
https://api.naturecode.earth/v0
MCP 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

From your first curl request to production, in one afternoon.