# Charter

> OAuth setup and launch guidance for developers and coding agents.

Context: external audience; read capability; exploring stage.

## Guide library
### GitHub
Choose the right app model first.
- Origin: reviewed; status: complete; checked: 2026-10-21.
- [Markdown](https://charter-oauth-guide.vercel.app/guides/github.md?audience=external&capability=read&stage=exploring)
- [JSON](https://charter-oauth-guide.vercel.app/api/guides/github?audience=external&capability=read&stage=exploring)
- [Human view](https://charter-oauth-guide.vercel.app/?guide=github&audience=external&capability=read&stage=exploring&mode=human)

### Gmail
Reading email changes the review path.
- Origin: reviewed; status: complete; checked: 2026-10-21.
- [Markdown](https://charter-oauth-guide.vercel.app/guides/gmail.md?audience=external&capability=read&stage=exploring)
- [JSON](https://charter-oauth-guide.vercel.app/api/guides/gmail?audience=external&capability=read&stage=exploring)
- [Human view](https://charter-oauth-guide.vercel.app/?guide=gmail&audience=external&capability=read&stage=exploring&mode=human)

### Slack
Distribution is a product decision.
- Origin: reviewed; status: complete; checked: 2026-10-21.
- [Markdown](https://charter-oauth-guide.vercel.app/guides/slack.md?audience=external&capability=read&stage=exploring)
- [JSON](https://charter-oauth-guide.vercel.app/api/guides/slack?audience=external&capability=read&stage=exploring)
- [Human view](https://charter-oauth-guide.vercel.app/?guide=slack&audience=external&capability=read&stage=exploring&mode=human)

### Linear External Read OAuth Integration
Live research · verify before launch
- Origin: generated; status: partial; checked: 2026-10-21T04:57:16.134Z.
- [Markdown](https://charter-oauth-guide.vercel.app/guides/r_1c9eedc0-9b6f-4529-bf51-48f839f1ab45.md?audience=external&capability=read&stage=exploring)
- [JSON](https://charter-oauth-guide.vercel.app/api/guides/r_1c9eedc0-9b6f-4529-bf51-48f839f1ab45?audience=external&capability=read&stage=exploring)
- [Human view](https://charter-oauth-guide.vercel.app/?guide=r_1c9eedc0-9b6f-4529-bf51-48f839f1ab45&audience=external&capability=read&stage=exploring&mode=human)

## Machine interfaces
- [Discovery index](https://charter-oauth-guide.vercel.app/llms.txt)
- [OpenAPI contract](https://charter-oauth-guide.vercel.app/openapi.json)
- [Research status](https://charter-oauth-guide.vercel.app/api/status)
- Stateless MCP: POST https://charter-oauth-guide.vercel.app/mcp
- Tools: search_guides, get_guide, research_app, get_research_status.

## Interpretation
Guides preserve applicability conditions, sources, responsible actors and unresolved questions. Do not treat missing evidence as an approval exemption. Curated guides adapt to the selected context; generated guides preserve their saved context.
Read/write is a coarse scenario profile; confirm exact provider endpoints, scopes and data handling before implementation.

## Live research
Submit POST /api/research with {input, context}. Input may be an app name or public HTTPS documentation URL. No credentials or private documentation.
Research has durable hourly limits: 8 requests per caller and 40 across this deployment. If RESEARCH_ACCESS_TOKEN is configured, include Authorization: Bearer <research token> for POST /api/research and the MCP research_app tool. The token is a deployment secret, never guide content.
Without a configured model, research retrieves public documentation and saves a partial evidence guide. It does not claim a completed AI synthesis.

## Access
This Vercel guide and demo surface exposes direct HTML, Markdown, JSON and stateless MCP URLs. Vercel deployment protection may require access before a client can reach them. Reading mode does not change permissions; research has separate optional bearer authorization and quotas.