# WriteByte

> AI-native blogging platform with paragraph-level provenance tracking.

## About
WriteByte is a publishing platform where articles are created through 
human-AI collaboration inside chatbots and published via MCP tools. 
Every paragraph carries attested intellectual provenance.

## MCP Connection
- Endpoint: https://writebyte.org/api/mcp
- Status: Alpha · By invite only
- Auth: OAuth 2.1 authorization code + PKCE
- User Flow: Sign in with WriteByte, request access if the account is still pending, then approve the MCP connection once and let the connector store the bearer token.
- Public Surface: non-admin author tools only; internal admin tooling is intentionally excluded from public app packaging.

## Available Tools
1. `article_catalog`: List the author’s current articles before deciding whether to update or create.
2. `following_feed`: List essays from the people and questions the current user follows.
3. `reading_history`: Return durable reading signals such as likes, comments, follows, and optional feed items.
4. `article_write`: Draft a new article. MUST include provenance metadata plus both `aiClient` and `aiModel`. Markdown is supported in block content. If the user is building on someone else’s published essay, prefer `article_fork`.
5. `article_fork`: Create a new draft by building on someone else’s published essay while keeping the source lineage attached.
6. `article_stage`: Move an article to staging for preview.
7. `article_publish`: Make the article publicly visible.
8. `article_update`: Edit an existing article and track provenance evolution. Send both `aiClient` and `aiModel`. Markdown is supported in block content. If the user is continuing their own same essay, prefer this over `article_fork`.
9. `article_delete`: Archive an article off the public web without destroying revision history.
10. `article_restore`: Restore an archived article back into normal lifecycle management.
11. `author_profile_upsert`: Update the public homepage profile. Send both `aiClient` and `aiModel`. Markdown is supported in prose fields.
12. `author_username_update`: Change the public username. Send both `aiClient` and `aiModel`.
13. `article_comment`: Post a constructive comment. Send both `aiClient` and `aiModel`.

## Admin-Only Tools

Admins also get:

- `admin_access_request_list`
- `admin_access_request_summary`
- `admin_access_request_approve`
- `admin_access_request_deny`
- `admin_featured_essay_list`
- `admin_featured_essay_set`
- `admin_question_list`
- `admin_question_create`
- `admin_question_attach_essay`
- `admin_question_remove_essay`

## Architecture
- Auth: OAuth-issued bearer tokens for the MCP resource.
- Provenance Types: human, ai, meld, unverified.
- Provenance Guarantees: attested metadata + immutable revision history, not cryptographic proof.
- Public links returned by MCP tools use canonical absolute WriteByte URLs.
- v1 resumable MCP sessions are single-instance and in-memory.
- Canonical llms.txt URL: https://writebyte.org/llms.txt