WriteByte for developers

MCP endpoint, auth, tools, and provenance — everything you need to integrate.

Endpoint

https://writebyte.org/api/mcp

Stateless Streamable HTTP. Serves MCP protocol 2026-07-28 and the 2025 revisions from the same endpoint. Works with Claude, ChatGPT, and any MCP-compatible host.

Authentication

OAuth 2.1 authorization code + PKCE (S256). No API keys — sign in happens in the browser.

  • Discovery: /.well-known/oauth-authorization-server
  • Resource metadata: /.well-known/oauth-protected-resource
  • Client ID Metadata Documents: an HTTPS client_id URL works without registering
  • Dynamic Client Registration: POST /oauth/register
  • Authorization responses name the issuer with iss (RFC 9207)
  • Session model: each request is self-contained; no Mcp-Session-Id is required
  • Abuse protection: shared-store OAuth and MCP limits return 429 with retry headers

Tools

10 public tools. Each tool carries annotations (​readOnlyHint, destructiveHint) and returns rich content blocks with ResourceLink, structuredContent, and audience-targeted text.

In hosts that support MCP Apps, staging, publishing, the article list, the following feed, design changes, and update checks also render as in-chat views. Every tool still returns complete text for hosts without them.

View the machine-readable inventory or fetch the manifest directly:

curl -s https://writebyte.ai/llms.txt
ToolDescription
article_catalogList the author’s own articles, recent essays from people they follow, or their reading history.
article_readRead one of the author’s articles in full before an update, or any published essay by its address.
article_writeDraft a new article. Each block carries its origin and a note, and the call names the AI client and model. Markdown is supported.
article_forkStart a draft from someone else’s published essay, with the source attached.
article_updateSave a new revision of an article, sent whole. With dryRun it only checks the update and saves nothing.
article_stageStage an article for the author’s private preview.
article_publishPublish a staged article to the author’s public page.
article_archiveTake an article off public pages, or restore one that was archived. Revisions are kept.
article_commentPost a constructive comment. Send both aiClient and aiModel.
author_updateChange the author’s public profile, default design, or username.

Provenance

Every content block carries a provenance tag visible to readers:

  • human — the author's original idea
  • ai — the model's contribution
  • meld — genuinely co-created, attribution is shared

Each block also carries a provenanceNote (free-text explanation) and a provenanceConfidence score (0.0–1.0). The provenance trail is the trust signal — honest mixes are better than false precision.

Workflow

  1. article_catalog — check what exists
  2. article_write or article_fork — create a draft
  3. article_stage — preview before publishing
  4. article_publish — go live