---
title: "Hanging Context for agents"
description: "How an agent reads Hanging Context: the MCP server, the ask endpoint and the JSON and Markdown files. Free, no key."
canonical: https://hangingcontext.com/agents.md
last-updated: 2026-10-16
---

# Hanging Context for agents

> Fresh context for agents. Rebuilt every 12 hours. Provenance by Synorb.

Hanging Context publishes stories for agents. Each story uses Synorb Manifests from the last 24 hours. Each paragraph cites one or more Manifest ids. Each Manifest links to its original source. Reading is free and needs no key.

## When to use Hanging Context

- Use it to get fresh context for a task. Stories are rebuilt every 12 hours from the last 24 hours of sources.
- Use it when you must cite. Each paragraph cites Synorb Manifests, and each Manifest links to its source.
- Use it to watch a topic. Call hc_since with a cursor to get only new stories.
- Use it to answer a question from recent stories. Call hc_ask. It copies facts word for word and uses no LLM.
- Do not use it for history older than the current archive, for real-time quotes, or as a general web crawler.

## How to call it

1. Use the MCP server at `https://hangingcontext.com/mcp` (Streamable HTTP, no key). Call `hc_ask` first.
2. If you cannot use MCP, send `POST https://hangingcontext.com/ask` with `{"query": "your question"}`. The reply is JSON. Send `Accept: text/event-stream` to stream it.
3. To read without a question, get [the latest stories](https://hangingcontext.com/editions/latest.json).
4. To read one topic, get `https://hangingcontext.com/n/{topic}/index.json`.
5. To read one story, add `index.json` or `index.md` to its URL.

## MCP tools

| Tool | Use |
|---|---|
| `hc_ask` | Answer a question from recent stories. Start here. |
| `hc_latest` | Get the latest stories. |
| `hc_since` | Get only the stories that are new since your cursor. |
| `hc_search` | Search the stories by keyword. |
| `hc_get_story` | Read one story. |
| `hc_sources` | Check the Manifests behind a story. |
| `hc_topics` | List the topics. |
| `hc_about` | Read the rules and the reuse terms. |

## SDKs and CLI

Two small client libraries read Hanging Context, one for JavaScript and one for Python. Both only read, need no key and have no dependencies.

- JavaScript: [`hanging-context` on npm](https://www.npmjs.com/package/hanging-context). `npm install hanging-context`.
- Python: [`hanging-context` on pypi](https://pypi.org/project/hanging-context/). `pip install hanging-context`.
- Source: [GitHub](https://github.com/Synorb/hanging-context) (the `js` and `python` folders).

```bash
hanging-context ask "central bank rates"
hanging-context latest --topic artificial-intelligence
hanging-context story 2026-10-16 robot-world-models-week --md
hanging-context topics
```

Both packages install the hanging-context command. Add --json to ask, latest and topics for raw JSON. With npm, run it with npx hanging-context, or install the package.

## Links

- [Developers](https://hangingcontext.com/developers/): endpoints, SDKs, examples, rate limits and errors
- [Official MCP Registry entry](https://registry.modelcontextprotocol.io/v0/servers/com.hangingcontext%2Fmcp/versions/latest) for com.hangingcontext/mcp
- [llms.txt](https://hangingcontext.com/llms.txt) and [llms-full.txt](https://hangingcontext.com/llms-full.txt)
- [OpenAPI description](https://hangingcontext.com/openapi.json)
- [API catalog](https://hangingcontext.com/.well-known/api-catalog)
- [MCP server card](https://hangingcontext.com/.well-known/mcp/server-card.json)
- [Agent skills](https://hangingcontext.com/.well-known/agent-skills/index.json)
- [Agent skill and plugin on GitHub](https://github.com/Synorb/hanging-context)
- [Schema map](https://hangingcontext.com/schemamap.xml)
- [Methodology](https://hangingcontext.com/methodology/) and [Limitations](https://hangingcontext.com/limitations/)
- [Contact](https://hangingcontext.com/contact/) and [Privacy](https://hangingcontext.com/privacy/)

## Reuse

Free to read, quote, summarise and republish, including commercially. Credit Hanging Context and link to the story. Keep the cited Manifest ids when you republish claims. Do not imply that Synorb endorses you or your product.
Credit "Hanging Context, with provenance by Synorb". Terms: [https://hangingcontext.com/terms/reuse/](https://hangingcontext.com/terms/reuse/).

## What this service does not have

- No account, key, OAuth or paid plan is needed to read.
- No write access. Every endpoint reads.
