pordl-mcp 🚪

MCP server for pordl — lets any MCP client (Claude Desktop, Cursor, etc.) read open-content web pages as clean markdown.

One tool: read_open_source(url, max_age?) → markdown + source license. Allowlisted open sources only (US public-domain gov, Creative Commons, permissive OSS docs). It refuses paywalled / access-controlled / non-allowlisted URLs by design.

By default it calls pordl's free tier — no wallet, no key, install and go. This server is the adoption channel; high-volume autonomous agents pay per call by hitting pordl's x402 endpoint directly.

Build & run locally

npm install
npm run build        # emits dist/
npm start            # runs over stdio

Use in Claude Desktop

Add to claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "pordl": {
      "command": "node",
      "args": ["C:\\Users\\dell\\Documents\\pordl-mcp\\dist\\index.js"]
    }
  }
}

Restart Claude Desktop, then try: "Use pordl to read https://docs.python.org/3/library/json.html".

Point at a different endpoint with an env var if needed:

"env": { "PORDL_API_URL": "https://api.pordl.dev/free/read" }

Deploy to Smithery

smithery.yaml is a stdio starter. Align it with the exact format your Spraay MCP uses on Smithery — that's the authoritative, known-good path.

Config

| Env | Default | Purpose | |---|---|---| | PORDL_API_URL | https://api.pordl.dev/free/read | Which pordl endpoint to call |

Roadmap

• list_open_sources tool once pordl exposes GET /sources, so agents can discover what's readable.
• Optional API-key tier so MCP users can pay without wiring x402 themselves.