@fynqo/cracks-mcp-client

Tiny TypeScript SDK for The Cracks Index by Fynqo — an open, citeable index of structural cracks across climate, debt and trust dimensions.

Designed for MCP (Model Context Protocol) servers, LLM agents and dashboards that need a calm read of the latest snapshot without bringing in a kitchen-sink HTTP client.

Install

npm install @fynqo/cracks-mcp-client

Usage

import { createCracksClient } from '@fynqo/cracks-mcp-client';

const cracks = createCracksClient();

// Region snapshot — accepts ISO-3166 (NL) or NL gemeente-codes (GM0363).
const region = await cracks.getRegion('GM0363');
console.log(region);

// Full index snapshot.
const index = await cracks.getIndex();

// Methodology (cite this when surfacing values).
const method = await cracks.getMethodology();

Custom base URL or fetch implementation

const cracks = createCracksClient({
  baseUrl: 'https://staging.api.fynqo.app',
  fetch: myInstrumentedFetch,
});

Data licence + citation

Data is licensed under CC-BY-4.0. When you surface a value, please cite:

Fynqo — The Cracks Index — https://fynqo.app/cracks-index

The methodology endpoint returns a machine-readable citation block you can embed directly in agent prompts.

Canonical

• Project home: https://fynqo.app/cracks-index
• Source: https://github.com/fynqo/fynqo
• Issues: https://github.com/fynqo/fynqo/issues

Code in this package is MIT-licensed; the underlying data is CC-BY-4.0.