# info.summary
Read, comment on, and review GitHub-hosted documents through specgit.

# info.description
Agent and automation surface for reading, commenting on, and reviewing GitHub-hosted documents.

Authentication is the specgit GitHub App session cookie — there are no API keys.

Versioning: Major versions are advertised in the API-Version response header and in OpenAPI info.version. Breaking changes ship a new major version; the current /api/agent paths remain the v1 surface until a /api/v2 path is published. Deprecations are signaled with RFC 9745 Deprecation and Sunset headers plus a note on /developers.

Rate limit: 60 requests per 60 seconds on advertised agent endpoints. Responses include RateLimit and RateLimit-Policy after a real limiter check; 429 responses also include Retry-After.

Human-readable guide: https://specgit.com/developers. Auth walkthrough: https://specgit.com/auth.md.

# tags[].description
Document review tools an authenticated agent can call.

# paths./api/agent/tools.get.description
Returns the review tools and their JSON Schema input contracts.

# paths./api/agent/tools.get.parameters[].description
Optional request header. Responses always echo the current major version. Breaking changes require a new major path.

# paths./api/agent/tools.get.responses.200.headers.RateLimit.description
RFC RateLimit structured fields after a real limiter check.

# paths./api/agent/invoke.post.description
Call one review tool. Mutating tools require an active AI allowance; reads are free.

# paths./api/agent/invoke.post.parameters[].description
Optional request header. Responses always echo the current major version. Breaking changes require a new major path.

# paths./api/agent/invoke.post.responses.200.headers.RateLimit.description
RFC RateLimit structured fields after a real limiter check.

# paths./api/agent.post.description
JSON-RPC MCP transport (initialize, tools/list, tools/call, ping). tools/call requires the GitHub App session cookie.

# paths./api/agent.post.parameters[].description
Optional request header. Responses always echo the current major version. Breaking changes require a new major path.

# paths./api/agent.post.responses.200.headers.RateLimit.description
RFC RateLimit structured fields after a real limiter check.

# paths./api/agent.get.description
Short JSON description of the Streamable HTTP MCP endpoint.

# paths./api/agent.get.parameters[].description
Optional request header. Responses always echo the current major version. Breaking changes require a new major path.

# paths./api/agent.get.responses.200.headers.RateLimit.description
RFC RateLimit structured fields after a real limiter check.

# paths./api/health.get.description
Liveness probe. Always public. Not an agent endpoint and not rate-limited.

# components.securitySchemes.sessionCookie.description
Session cookie obtained via the specgit GitHub App sign-in. There are no API keys.

# components.schemas.CreateCommentInput.properties.lineEnd.description
Last line of the selection (1-based, inclusive).