# steward.foo

> Question-based PR review for your repositories

## What is Steward?

Steward reviews every pull request and push to main by scoring them against yes/no review questions (Jev-scored, flag-first). Questions are grouped by the context they need and backtested against historical PRs for calibration. Repository owners approve questions before they go live.

## Install

The canonical install and onboarding guide:
https://www.steward.foo/install

This page covers:
- GitHub App installation (grants read access to code and PRs, write access for review comments)
- MCP server connection for coding agents (Claude Code, Cursor, and others)
- Agent authentication via the short-code flow (request_installation_code / poll_installation_claim)
- What happens after install (shadow scoring, PR review with check runs, push-to-main digests)

## MCP Server

MCP endpoint: https://mcp.steward.foo
OAuth protected resource metadata: https://mcp.steward.foo/.well-known/oauth-protected-resource

Agents connect using HTTP transport. The short-code flow lets agents authenticate without browser OAuth when the GitHub App is already installed.

## Discovery

- Robots policy: https://www.steward.foo/robots.txt