ask-web-fetch-mcp 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ba4b67fe027c74b1e68b80af6cd6dc83479464c936f37bb558ce4b60c8811f3
-  data.tar.gz: 86f9bf7f1bab0e3d7678a966259af096593bb665d30d4abcd3121085051f891c
+  metadata.gz: 33e377fca58f50a8e93cbe112374c0fe853dc5048505d7e7417d22d97e2c446d
+  data.tar.gz: 3aeb0347430bb21442599c38502c4d9063a9d75e3d3f88dcb812284ba5908b36
 SHA512:
-  metadata.gz: da671bda628d54eeb7cf60e573d5317c568516f16d3c547e48d6f8c813697f9ff9f3442c0578ad4dd360f6e08c9d0faac466710d1f32c882f2db736874f486ca
-  data.tar.gz: 8c53d1f55dc8dbc661538b65b3e1e76ac65121c6edcb6c57c94d28a87ecfc328ad5940a595ee452724f987497fdd8c32277a61a21238f7a6c03bd6eeae3e1ac0
+  metadata.gz: 6ff9783fb23e9b8912c4668787d64667949e69f5234dee7db4d2db52221bcf74bae27e0ce88ed3b96220516991bd3e8a0cb29b6b87da8ec81d1ffeb7a39890c7
+  data.tar.gz: aa002fe73da25c7b754941ebc27a69fa5c799e0ab5c05b1e1c65f2d58f1c9b2df617d4bd28d1231cd80dd8a9652920699752a6d97547b4154a256a6becfe2830

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [0.6.0] — 2026-08-12
+
+### Changed
+
+- **The server owns its tool shell.** `ask_web_fetch` is now a
+  duck-typed tool (`Ask::WebFetch::MCP::Tool` — `name` /
+  `description` / `params_schema` / `call`) wrapping the library entry
+  `Ask::WebFetch.fetch`, instead of a renamed `Ask::Tools::WebFetch`.
+  The MCP adapter's contract is duck-typed by design, so the server
+  gains nothing from the ask-tools machinery — and the ask-tools /
+  ask-core / ask-schema dependency chain is gone from the server
+  process entirely. `ask-web-fetch` floor raised to `>= 0.7.1` (the
+  module-level API with the failure collapse and parked-domain
+  detection on every backend).
+- **Cleaner error framing.** A failed call now surfaces as
+  `Error: Ask::WebFetch::ParkedDomainError: ...` — the class is still
+  named, without the tool layer's double wrap. Terminal verdicts
+  (parked, empty, dead 4xx) are never retried by clients; transient
+  failures raise the base `Error`.
+- **The native agent tool stays available for non-MCP consumers.**
+  `Ask::Tools::WebFetch` lives in ask-web-fetch as an optional
+  integration (registered when ask-tools is present) for agent
+  frameworks that resolve tools by name.
+
 ## [0.5.0] — 2026-08-12
 
 ### Changed

data/lib/ask/web_fetch/mcp/tool.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'ask/web_fetch'
+
+module Ask
+  module WebFetch
+    module MCP
+      # The ask_web_fetch tool, duck-typed for Ask::MCP's ToolServer
+      # adapter (name / description / params_schema / call). The tool
+      # framing lives with its consumer — this server — not in the
+      # library: the capability is Ask::WebFetch.fetch, this is the
+      # agent-facing shell around it.
+      class Tool
+        def name
+          'ask_web_fetch'
+        end
+
+        def description
+          'Fetch a URL and return its content as clean markdown for LLM consumption. ' \
+          'Use this to read web pages, articles, and documentation.'
+        end
+
+        def params_schema
+          {
+            'type' => 'object',
+            'properties' => {
+              'url' => { 'type' => 'string', 'description' => 'The URL to fetch' },
+              'max_chars' => { 'type' => 'integer', 'description' => 'Maximum number of characters to return (default 20000)' }
+            },
+            'required' => ['url']
+          }
+        end
+
+        # Returns the fetched markdown (a String is a success for the
+        # adapter) or raises. The terminal verdicts — ParkedDomainError,
+        # EmptyContentError, FetchError — reach the client as their class,
+        # so it never retries the unretryable; transient failures raise
+        # the base Error.
+        def call(args)
+          url = args['url'].to_s
+          raise ArgumentError, 'missing required parameter: url' if url.empty?
+
+          max_chars = args['max_chars']
+          Ask::WebFetch.fetch(url, max_chars: max_chars || Ask::WebFetch::DEFAULT_MAX_CHARS)
+        end
+      end
+    end
+  end
+end

data/lib/ask/web_fetch/mcp/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module WebFetch
     module MCP
-      VERSION = '0.5.0'
+      VERSION = '0.6.0'
     end
   end
 end

data/lib/ask/web_fetch/mcp.rb

@@ -2,19 +2,20 @@
 
 require 'ask/mcp'
 require 'ask/web_fetch'
+require_relative 'mcp/tool'
 require_relative 'mcp/version'
 
 module Ask
   module WebFetch
     # MCP (Model Context Protocol) server for ask-web-fetch.
     module MCP
-      # Builds the tool exposed over MCP: Ask::Tools::WebFetch renamed to
-      # "ask_web_fetch" to avoid collisions with client-side tools of the
-      # same name (ask-web-search-mcp follows the same convention).
+      # Builds the tool exposed over MCP. The tool framing lives here —
+      # ask-web-fetch is a library (Ask::WebFetch.fetch); this server
+      # owns the agent-facing shell, named "ask_web_fetch" to avoid
+      # collisions with client-side tools of the same name
+      # (ask-web-search-mcp follows the same convention).
       def self.tool
-        tool = Ask::Tools::WebFetch.new
-        tool.define_singleton_method(:name) { 'ask_web_fetch' }
-        tool
+        Tool.new
       end
 
       # Start the MCP server over stdio, exposing the ask_web_fetch tool.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-web-fetch-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 0.7.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 0.7.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -80,14 +80,15 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.26'
 description: |
-  A minimal MCP (Model Context Protocol) server that exposes Ask::Tools::WebFetch
+  A minimal MCP (Model Context Protocol) server that exposes ask_web_fetch
   as a callable tool over stdio. Designed for use with clients that support MCP
   (ZCode, Claude Code, etc.), it fetches a URL and returns clean markdown through
   the ask-web-fetch backend chain — fast pure-Ruby httpx fetch first, a real
   Chrome (launched or CDP-attached) for JS-rendered and challenge-gated pages,
   with Jina Reader and self-hosted Crawl4AI in between. Terminal failures
   (parked domains, empty pages, dead 4xx) surface as their deterministic error
-  class, so clients never retry the unretryable.
+  class, so clients never retry the unretryable. The tool shell (name, schema,
+  call) lives here, wrapping the Ask::WebFetch library.
 email:
 - kaka@myrrlabs.com
 executables:
@@ -101,6 +102,7 @@ files:
 - bin/ask-web-fetch-mcp
 - lib/ask-web-fetch-mcp.rb
 - lib/ask/web_fetch/mcp.rb
+- lib/ask/web_fetch/mcp/tool.rb
 - lib/ask/web_fetch/mcp/version.rb
 homepage: https://github.com/ask-rb/ask-web-fetch-mcp
 licenses: