# vhsgreed-mcp

MCP (Model Context Protocol) server exposing vhsgreed's data products to AI
agents. First dataset: **Nvidia Supplier Map 2026** — 29 supplier edges across
9 tiers (HBM, foundry, power, ABF substrate, …), each carrying an honesty
flag: `disclosed` / `inferred` / `estimate` / `UNVERIFIED`.

Free tier returns structure. Paid tier (access token) adds verbatim evidence
quotes, source URLs, and filing dates.

## Tools

- `dataset_info` — version, edge count, tiers, honesty flags, refresh cadence
- `search_supplier_edges` — filter by `tier`, `supplier`, `ticker`, `flag`.
  Optional `full_access_token` upgrades the response to the full tier.

## Install / run (local, stdio)

```
npm install
npm run build
node dist/index.js
```

## Claude Desktop / any MCP client config

```json
{
  "mcpServers": {
    "vhsgreed": {
      "command": "node",
      "args": ["/path/to/vhsgreed-mcp/dist/index.js"]
    }
  }
}
```

Paid tier: set `VHSGREED_TOKEN_ENDPOINT` (payment rail `/validate` URL) and
`VHSGREED_FULL_TOKEN` in the server env to your access token. Purchase:
https://vhsgreed.win/ai/products/ ($10 supplier-edges-full).

### denmark-cvr tokens

Tokens bought via the $5 "denmark-cvr agent access" payment link
(https://buy.stripe.com/eVq8wR51G2Hs6NsayHew806) carry
`product: "denmark-cvr"` from the rail's `/validate`. This server recognizes
them as valid tokens (no `invalid_token` error) but the Nvidia Supplier Map
full tier requires a `supplier-edges-full` token; a denmark-cvr token gets a
clear `wrong_product_token` message plus the free tier. A denmark-cvr token
instead grants agent access to the Apify actor
`vhsgreed/denmark-cvr-api-fresh`: run it directly on Apify or call it from
your MCP client via the vhsgreed server docs in the buyer email.

## Data

`data/supplier-edges.csv` is copied from the deterministic build in
`prod/repos/nvidia-supplier-map/` (same pipeline as the Gumroad product and
the `/ai/products/` JSON API). Refresh cadence: quarterly; next scheduled
disclosure is NVDA's 10-Q (~late Nov 2026). Bump `version` in `src/index.ts`
when the dataset updates.

## Attribution

Free-tier use requires attribution: "vhsgreed.win". Full tier: single-entity
use, redistribution prohibited.

## Honesty policy

Flags are honest. `UNVERIFIED` means we could not verify the edge; the flag
gradient exists precisely so agents (and humans) can weigh confidence
themselves. We do not blur the difference.

## License

MIT. Data itself: free tier CC-BY (attribution), full tier single-entity.

---
Karl Sundström · vhsgreed.win · Enskild firma, Org.nr 990607-1619