How It Works

One page, two audiences. MAKO adds a structured layer to any website so AI agents can read, understand, and act — using standard HTTP.

One page, two audiences

Browser→example.com/product→HTML

AI Agent→example.com/product→MAKO

Same URL. Same server. Different response based on who's asking.

AI requests your page

An AI agent sends a standard HTTP request to your existing URL. A single header indicates it prefers structured content. If the server doesn't support MAKO, it responds with regular HTML — zero breaking changes.

Standard HTTP request to the same URL browsers use
Accept header signals preference for MAKO format
Graceful fallback to HTML if MAKO isn't available

Your server responds with a structured version

Instead of raw HTML with navigation, ads, and scripts, the server responds with a clean document: typed metadata, structured content, and declared capabilities.

Metadata: content type, entity name, language, token count
Clean markdown body with only the relevant content
Declared actions (buy, subscribe, book) and semantic links with context

AI reads, understands, and acts

The agent receives structured information it can process immediately — no HTML parsing, no JavaScript execution, no guessing which of 127 links matter.

Extracts information without parsing HTML or executing scripts
Navigates semantic links that carry context and purpose
Executes declared actions directly with typed parameters

What AI actually receives

Structured YAML frontmatter + optimized Markdown body. Everything an AI agent needs, nothing it doesn't.

product.mako.md

---
mako: "1.0"
type: product
entity: "Nike Air Max 90"
tokens: 280
language: en

actions:
  - name: add_to_cart
    endpoint: /api/cart/add

links:
  internal:
    - url: /category/running
      context: "Browse running shoes"
---

# Nike Air Max 90

Mid-range casual running shoe by Nike.

## Key Facts
- Price: 79.99 EUR (was 149.99, -47%)
- Rating: 4.3/5 (234 reviews)
- In stock, sizes EU 38-46

Read the full specification Check your AI Score

AI requests your page

Standard HTTP request to the same URL browsers use

Accept header signals preference for MAKO format

Graceful fallback to HTML if MAKO isn't available

Your server responds with a structured version

Instead of raw HTML with navigation, ads, and scripts, the server responds with a clean document: typed metadata, structured content, and declared capabilities.

Metadata: content type, entity name, language, token count

Clean markdown body with only the relevant content

Declared actions (buy, subscribe, book) and semantic links with context

AI reads, understands, and acts

The agent receives structured information it can process immediately — no HTML parsing, no JavaScript execution, no guessing which of 127 links matter.

Extracts information without parsing HTML or executing scripts

Navigates semantic links that carry context and purpose

Executes declared actions directly with typed parameters

--- mako: "1.0" type: product entity: "Nike Air Max 90" tokens: 280 language: en actions: - name: add_to_cart endpoint: /api/cart/add links: internal: - url: /category/running context: "Browse running shoes" --- # Nike Air Max 90 Mid-range casual running shoe by Nike. ## Key Facts - Price: 79.99 EUR (was 149.99, -47%) - Rating: 4.3/5 (234 reviews) - In stock, sizes EU 38-46