Machine Web Protocol™ (MWP)

The internet, reborn for machines.

MWP is an open specification for transforming web content into clean, structured, machine-readable text optimized for AI agents, LLMs, and automation tools.

Status

Version	Status	Released	Notes
v1.0	Public Draft	2026-01-26	Open for feedback

What "Public Draft" means:

• The spec is stable enough for implementation
• We welcome feedback and real-world testing
• Breaking changes are possible but will be documented
• Target for "Final" status: Q2 2026

To provide feedback, open an issue or join discussions.

Why MWP?

The web was built for humans. AI agents struggle with:

• Cookie banners, popups, and navigation chrome
• Inconsistent HTML structures across sites
• JavaScript-rendered content they can't execute
• No standard way to signal "this content is AI-friendly"

MWP solves this by defining:

1. A simple text format — Header metadata + clean content body
2. Standard metadata fields — Source, author, title, categories
3. A discovery protocol — How AI agents find MWP-formatted content

Quick Start

For Content Publishers

1. Create a /machine/ directory on your site
2. Add MWP-formatted .txt files for each piece of content
3. Use the header format below
4. (Optional) Register with machinewebprotocol.com for discovery

For AI Agent Developers

1. Check for /machine/ path or .well-known/mwp/ on target sites
2. Parse the simple header + body format
3. Use standard HTTP — no special libraries needed

Quick Example

Input: Any URL

https://example.com/blog/ai-trends-2026

Output: MWP document (plain text)

Source-URL: https://example.com/blog/ai-trends-2026
Machine-URL: https://machinewebprotocol.com/machine/ai-trends-2026
Published: 2026-01-25T08:00:00Z
Author: Jane Smith
Title: AI Trends for 2026
Categories: ai, technology, trends
Extraction: readability-extracted

---
The landscape of artificial intelligence continues to evolve rapidly. 
This year brings several significant developments that will shape 
how we build and deploy AI systems...

Simple. Human-readable. Trivially parseable.

Specification

• MWP Spec v1.0 — Full specification document
• Examples — Sample MWP documents

Live Registry

See MWP in action: machinewebprotocol.com

Example machine-readable page:

https://machinewebprotocol.com/machine/behind-the-curtain-how-a-simple-ai-experiment-became-a-cognitive-framework

Implementations

Implementation	Type	Status
MWP Registry	Official Registry	Live
Your implementation here	—	—

Want to add your implementation? Open a PR.

Registry vs Spec

• This repo = Open specification (Apache 2.0)
• MWP Registry = Reference implementation and discovery service

Anyone can build MWP-compatible tools. The registry at machinewebprotocol.com provides discovery and a public directory of MWP-formatted content.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Spec changes follow an RFC process:

1. Open an issue describing the proposed change
2. Discussion period (minimum 14 days)
3. Pull request with spec updates
4. Maintainer review and merge

Changelog

v1.0 (2026-01-26) — Public Draft

• Initial public release
• Core header fields defined
• Discovery protocol specified
• Examples provided

License

The MWP specification is released under the Apache License 2.0.

Machine Web Protocol™ and MWP™ are trademarks of AI Cabinet Method LLC.

Links

• 🌐 MWP Registry — Discover machine-readable content
• 📋 MWP Foundation — About the standard
• 💬 Discussions — Community Q&A

---

Built for the agentic web.