# Context

> The papers and videos Hacker News keeps recommending — 1,060 arXiv papers (DAIR.AI's Hacker Papers) and 6,454 YouTube videos (HackerTube, ODC-By) — joined into one knowledge graph of 150 topics, HN mentions and connections. Humans are what they consume; agents are what they're given: the library people browse at https://context.shipwith.si is the same one agents get here.

Everything is public, read-only and keyless. Ids: videos `v:<youtube id>`, papers `p:<arxiv id>`, topics `c:<topic id>` (graph calls). "signal" is a 0-100 percentile of HN recommendation strength.

## For agents

- [MCP server](https://context.shipwith.si/mcp): streamable HTTP, stateless. Tools: search_library, get_item, related_items, graph_neighbors, find_connection, list_topics, topic_items, context_pack, random_pick. Add to Claude Code: `claude mcp add --transport http context https://context.shipwith.si/mcp`
- [API reference](https://context.shipwith.si/docs): interactive docs for the REST API
- [OpenAPI 3.1 spec](https://context.shipwith.si/openapi.json): machine-readable schema of every endpoint

## Key endpoints

- [Context pack](https://context.shipwith.si/api/v1/context?q=distributed%20systems): `GET /api/v1/context?q=` — markdown brief of the best papers and videos for a question, with why HN recommends each, a quote and connections (`format=json` for structured)
- [Search](https://context.shipwith.si/api/v1/search?q=rust%20ownership): `GET /api/v1/search?q=&kind=&mode=hybrid|keyword|semantic`
- [Item](https://context.shipwith.si/api/v1/items/p:1706.03762): `GET /api/v1/items/{id}` — full record, HN mentions, related items
- [Related](https://context.shipwith.si/api/v1/items/v:fNk_zzaMoSs/related): `GET /api/v1/items/{id}/related`
- [Browse](https://context.shipwith.si/api/v1/items?sort=gems&kind=video): `GET /api/v1/items?kind=&area=&category=&sort=top|gems|recent|oldest`
- [Topics](https://context.shipwith.si/api/v1/topics): `GET /api/v1/topics`, `GET /api/v1/topics/{id}`
- [Graph neighbourhood](https://context.shipwith.si/api/v1/graph/neighbors/p:1706.03762): `GET /api/v1/graph/neighbors/{id}?depth=1|2`
- [Find a connection](https://context.shipwith.si/api/v1/graph/path?from=p:1706.03762&to=v:fNk_zzaMoSs): `GET /api/v1/graph/path?from=&to=`
- [Stats](https://context.shipwith.si/api/v1/stats): `GET /api/v1/stats`

## Optional

- [Full index](https://context.shipwith.si/llms-full.txt): this file plus all 150 topics and the top 50 papers and videos
- [DAIR.AI Hacker Papers](https://academy.dair.ai/papers/collections/hacker-papers): source of the papers
- [HackerTube](https://hackertube.org): source of the videos (ODC-By)