Readable MCP Server

Readable provides an MCP (Model Context Protocol) server that allows any compatible LLM to fetch and read web articles.

Quick Start

Install in Claude Code

claude mcp add --transport http readable https://readable.page/mcp

Connection URL

https://readable.page/mcp

Protocol

Uses stateless Streamable HTTP: each POST returns a JSON response. No persistent connection or session is required. Standalone event streams and session deletion are not supported.

Plain HTTP access

MCP is optional. Scripts and HTTP clients can fetch article content directly with a GET request to either endpoint, using a URL-encoded article URL in the url query parameter:

https://readable.page/md?url=https%3A%2F%2Fexample.com
https://readable.page/html?url=https%3A%2F%2Fexample.com

These return Markdown and HTML respectively. Use MCP when your client supports MCP tool discovery and invocation.

Available Tools

read

Reads an article from a URL and returns cleaned content as markdown or HTML.

Parameters:

• url (string, required): The URL to read
• format (enum, required): Output format - 'md' for Markdown or 'html' for HTML

Returns:

MCP content response with the article content as text:

{
  "content": [
    {
      "type": "text",
      "text": "Article content in requested format..."
    }
  ]
}