# Orrery

> Skills you point at, not install.
> Gaze to discover, resolve to lock the record, call for a verified result.
> Public discovery and aggregated MCP — no bearer mint on the dogfood host.
> Do not install or clone for live truth — point at the teaching trio below.

## Connect

- [Connect guide](https://orrery.lol/connect): point an MCP client at Orrery
- [MCP endpoint](https://orrery.lol/mcp): streamable HTTP; no Authorization header
- [Skill discovery](https://orrery.lol/skills): Chirp JSON skill list
- [Health](https://orrery.lol/health): liveness probe

## Teaching trio (cohort A)

Point — don't clone. Offline copies cannot mint fresh UTC or re-observe upstream.

- [`orrery/world-time`](https://orrery.lol/stars?name=orrery/world-time): Live truth — seal a fresh UTC instant at call time
- [`orrery/source-watch`](https://orrery.lol/stars?name=orrery/source-watch): Observe/diff — re-check an allowlisted official source
- [`orrery/html-to-pdf`](https://orrery.lol/stars?name=orrery/html-to-pdf): Faucet + Envelope — tangible convert with a signed receipt
- [`orrery/stale-proof`](https://orrery.lol/constellations?name=orrery/stale-proof): composite that seals now + observe/diff (+ optional PDF receipt)

## Discovery

- [llms.txt](https://orrery.lol/llms.txt): this file
- [llms-full.txt](https://orrery.lol/llms-full.txt): tools, direct stars, curl recipe
- [MCP server card](https://orrery.lol/.well-known/mcp/server-card.json): SEP-1649-shaped catalog
- [MCP manifest](https://orrery.lol/.well-known/mcp): SEP-1960-shaped connect

## Product

- [Gaze](https://orrery.lol/gaze): discover / match intent
- [Resolve](https://orrery.lol/resolve): Skill DNS lock (endpoint, digest, key, price)
- [Stars](https://orrery.lol/stars): callable hosted skills
- Skill DNS: `mcp://orrery.lol/…` (override host with `ORRERY_MCP_HOST`)

## Optional

- [Source](https://github.com/lbliii/orrery)
- [Home](https://orrery.lol/)

## MCP tools (aggregate /mcp)

- `gaze_match`: Rank skills that match an intent against a gaze node.
- `gaze_search`: Search the public sky / namespace for skills by query.
- `gaze_describe`: Describe a skill or constellation for an agent.
- `gaze_list_constellations`: List drawn policy graphs (constellations).
- `resolve_name`: Resolve a Skill DNS name to endpoint, digest, key, price.
- `convert`: Convert HTML to PDF (html-to-pdf star; aggregate alias).
- `health`: Health check for the html-to-pdf star.
- `fetch`: Fetch a live UTC reading (world-time star).
- `get`: Get the last sealed world-time reading.
- `answer`: Answer with a sealed live UTC reading (world-time).
- `observe`: Observe an allowlisted official source (source-watch).
- `diff`: Diff a prior source-watch observation against live content.
- `source_watch_answer`: Extractive answer from source-watch (aggregate name).
- `run`: Run a constellation policy graph.
- `status`: Status for a constellation run.
- `explain_policy`: Explain a constellation policy for an agent.

## Direct star endpoints

Resolve records prefer these; canonical tool names without aggregate collisions:

- `orrery/html-to-pdf` → `https://orrery.lol/stars/html-to-pdf/mcp` (convert, health)
- `orrery/world-time` → `https://orrery.lol/stars/world-time/mcp` (fetch, get, answer)
- `orrery/source-watch` → `https://orrery.lol/stars/source-watch/mcp` (observe, diff, answer)

## Cursor snippet

Paste:

```json
{
  "mcpServers": {
    "orrery": {
      "url": "https://orrery.lol/mcp"
    }
  }
}
```

## Smoke test

```bash
BASE="https://orrery.lol"

curl -sS "$BASE/mcp" \
  -H 'Content-Type: application/json' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -H 'mcp-method: tools/list' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -sS "$BASE/mcp" \
  -H 'Content-Type: application/json' \
  -H 'mcp-protocol-version: 2025-06-18' \
  -H 'mcp-method: tools/call' \
  -H 'mcp-name: gaze_match' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"gaze_match",
        "arguments":{"intent":"html pdf convert","node":"public"}
      }}'
```

## Do not

- Treat Orrery as a proxy — Call goes agent → publisher MCP (ADR 0004)
- Expect a bearer mint on the public dogfood host
- Install or clone for live truth — resolve `orrery/world-time` / `orrery/source-watch` and call; offline clones go stale by definition