# Yanib

Yanib is the software change broadcasting layer. It reads release tags on
GitHub or GitLab and flags structural change candidates on declared code
surfaces. Surface matches retain source evidence for review, and notification
delivery follows configured routes through platform
Releases, public story pages, Slack, Discord, email subscribers, RSS,
embeddable widgets, and agent readable APIs.

Agents are an audience too: stories are served in machine readable formats
so coding agents can discover what a project shipped, for example while
performing a dependency upgrade.

## Docs

- MCP documentation: https://www.yanib.dev/docs/mcp
- REST API reference: https://www.yanib.dev/docs/api

## MCP endpoints

- Authenticated (per user, OAuth/token): https://www.yanib.dev/api/mcp
- Public (no account needed, read only): https://www.yanib.dev/api/mcp/public

## REST API (public, no auth)

- All releases for a repo: https://www.yanib.dev/api/v1/releases
- Latest release for a repo: https://www.yanib.dev/api/v1/releases/latest
- Release feed for a developer: https://www.yanib.dev/api/feed/{username}
- Story widget JSON: https://www.yanib.dev/api/stories/{slug}/embed
- System status JSON: https://www.yanib.dev/api/status

## Per story page formats

- Clean markdown for agents: https://www.yanib.dev/stories/{slug}/llms.txt
- RSS feed: https://www.yanib.dev/stories/{slug}/rss.xml

## Site discovery

- Sitemap (public story pages and developer profiles): https://www.yanib.dev/sitemap.xml