@url2md-io/mcp 0.1.3 → 0.1.4

package/README.md

@@ -7,12 +7,16 @@
 > key. Give the key only to `@url2md-io/mcp`. If the name you are about to install has no scope in
 > front of it, it is the wrong one.
 
-An MCP server that gives your agent one tool: **turn any URL into clean Markdown**.
+An MCP server that gives your agent one tool: **PDFs and pages that charge for access, as clean
+Markdown**.
 
-It handles ordinary pages, JavaScript-rendered pages (a headless browser is used only when the page
-needs one) and PDFs. There is no account, no sign-up and no API key. Each call is paid for on-chain,
-from a wallet you control, at **$0.005** — half a cent — in USDC on Base. The settlement receipt
-comes back with the Markdown.
+One conversion engine handles every kind, so the output is the same shape whichever it was: PDFs,
+pages that only appear once JavaScript has run (a headless browser is used only when the page needs
+one), and ordinary HTML. robots.txt is honoured per RFC 9309. There is no account, no sign-up and no API
+key. Each call is paid for on-chain, from a wallet you control, at **$0.005** — half a cent — in USDC
+on Base, and the settlement receipt comes back with the Markdown. When the page itself demands an
+x402 payment before it will hand anything over, url2md pays that for you and the cost is included in
+what you pay.
 
 ---
 
@@ -127,7 +131,7 @@ The server prints one line to stderr when it starts, naming the deployment, **th
 whether it is real money**, the wallet address it will pay from, and the per-call limit:
 
 ```
-@url2md-io/mcp 0.1.3 → https://url2md.io; eip155:8453 (real money); paying from 0x0972…7a36, at most $0.10 per call and $1.00 in total
+@url2md-io/mcp 0.1.4 → https://url2md.io; eip155:8453 (real money); paying from 0x0972…7a36, at most $0.10 per call and $1.00 in total
 ```
 
 Your private key is never printed, logged, or sent anywhere except as the signature on a payment.
@@ -391,11 +395,19 @@ The testnet deployment is the same code as production, on the test network. Set
 
 ---
 
-## Why this is a local server and not a hosted one
+## This local server, or the hosted connector
 
-Because a hosted server would have no wallet of yours to pay with. It would pay from its own and
-then have to bill you some other way — an account, an API key, an invoice — which is the exact thing
-x402 removes. Running it beside your client keeps the key on your machine and the payment yours.
+This package is the local lane: it runs beside your client, holds your wallet key, and pays each call
+itself, which is what lets it pay a page's own x402 toll too (quoted up front, settled after your
+payment). Running it beside your client keeps the key on your machine and the payment yours.
+
+The service also serves a hosted connector on its own origin — `POST /mcp`, Streamable HTTP behind
+OAuth 2.1 with a GitHub sign-in — for clients that hold no wallet, such as claude.ai's custom
+connectors. It is free to the signed-in account within a published allowance, and it never pays a
+toll: a page that charges one comes back as an error pointing at this package and at the paid HTTP
+endpoint. Where a deployment has it switched on, `GET /` lists it under `clients.mcp.remote` with the
+URL and the allowance. Use this package when you want a toll paid, when you want no account in the
+loop, or when you need more than the allowance.
 
 The key is read once at startup and used for one thing: signing
 [EIP-3009](https://eips.ethereum.org/EIPS/eip-3009) USDC transfer authorizations for the exact

package/dist/index.js

@@ -18,7 +18,7 @@ import { Budget, ceilingLooksWrong, CEILING_WORTH_MENTIONING_USD, convert, disco
  * message or into a tool result.
  */
 export const SERVER_NAME = "url2md";
-export const SERVER_VERSION = "0.1.3";
+export const SERVER_VERSION = "0.1.4";
 export const TOOL_NAME = "fetch_markdown";
 export const inputSchema = z.object({
     url: z.string().describe("The absolute http(s) URL to convert. Public hosts only: private, loopback and link-local addresses are refused, and the origin's robots.txt is obeyed."),
@@ -155,9 +155,9 @@ export function toolDescription(config, pricing) {
         : pricing?.model === "free"
             ? `This deployment (${config.baseUrl}) is not charging: calls are free.`
             : `Calls are paid per call over x402 from your own wallet; the live price is published at ${config.baseUrl}/.`;
-    return ("Fetch any web page or PDF and return it as clean Markdown, ready to read. Handles JavaScript-rendered pages (a headless browser is used when the page needs one) and PDFs. " +
+    return ("Return a web page or PDF as clean Markdown: PDFs, pages that only render once JavaScript has run (a headless browser is used when the page needs one), and ordinary HTML, all through one conversion engine. robots.txt is obeyed per RFC 9309. " +
         `${cost} This server refuses to sign more than $${config.maxPriceUsd} for one call, or $${config.maxSpendUsd} in total for as long as it is running. ` +
-        "If the page itself charges an x402 toll, url2md pays it and the cost is included in what you pay. " +
+        "If the page itself demands an x402 payment of its own, url2md pays that for you and the cost is included in what you pay. " +
         "Errors, including a payment that could not be made, come back as an error result whose text is a JSON object with a stable `code`.");
 }
 const isTestNetwork = (network) => network === "eip155:84532" || (network ?? "").includes("sepolia");

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@url2md-io/mcp",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "mcpName": "io.url2md/mcp",
-  "description": "MCP server for url2md — any URL in, clean Markdown out. Pays per call over x402 from your own wallet.",
+  "description": "MCP server for url2md: PDFs and x402-tolled pages as clean Markdown, JavaScript rendering included, paid per call from your own wallet.",
   "keywords": [
     "mcp",
     "model-context-protocol",