aperture-announce

[](./LICENSE) [](https://golang.org/) [](https://github.com/TheCryptoDonkey/aperture-announce/actions/workflows/ci.yml)

Announce your Aperture L402 services on Nostr for decentralised discovery.

Reads Aperture's YAML config, extracts service definitions, and publishes kind 31402 events to Nostr relays. AI agents using 402-mcp can then discover your services via l402_search.

go install github.com/TheCryptoDonkey/aperture-announce/cmd/aperture-announce@latest

aperture-announce \
  --config /path/to/aperture.yaml \
  --relays wss://relay.damus.io,wss://nos.lol \
  --public-urls https://api.example.com

If you already run Aperture, this is the simplest way to make your services discoverable by AI agents. Unlike 402-announce (TypeScript), aperture-announce:

• Reads your existing `aperture.yaml` directly — no separate config to maintain
• Single binary, zero runtime dependencies — no Node.js required
• Built for Aperture operators — understands Aperture's service format natively

aperture-announce [flags]

Required:
  --config <path>         Path to Aperture YAML config
  --relays <urls>         Comma-separated Nostr relay URLs
  --public-urls <urls>    Comma-separated public URLs agents will use to reach your service (1–10)

Optional:
  --public-url <url>      Alias for --public-urls (single URL; backwards-compatible)
  --announce-key <hex>    Nostr signing key (auto-generated if omitted)
  --interval <duration>   Re-publish