Endpoint
https://writebyte.org/api/mcpStateless 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_idURL 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-Idis required - Abuse protection: shared-store OAuth and MCP limits return
429with 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| Tool | Description |
|---|---|
article_catalog | List the author’s own articles, recent essays from people they follow, or their reading history. |
article_read | Read one of the author’s articles in full before an update, or any published essay by its address. |
article_write | Draft a new article. Each block carries its origin and a note, and the call names the AI client and model. Markdown is supported. |
article_fork | Start a draft from someone else’s published essay, with the source attached. |
article_update | Save a new revision of an article, sent whole. With dryRun it only checks the update and saves nothing. |
article_stage | Stage an article for the author’s private preview. |
article_publish | Publish a staged article to the author’s public page. |
article_archive | Take an article off public pages, or restore one that was archived. Revisions are kept. |
article_comment | Post a constructive comment. Send both aiClient and aiModel. |
author_update | Change 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
article_catalog— check what existsarticle_writeorarticle_fork— create a draftarticle_stage— preview before publishingarticle_publish— go live
Links
- llms.txt — machine-readable tool inventory
- manifest.json — OAuth Client dynamic registration configuration
- Install guides — two-minute walkthroughs for Claude and ChatGPT
- Privacy
- Terms
- Security