mcpgawk 0.1.1__tar.gz → 0.1.2__tar.gz

{mcpgawk-0.1.1 → mcpgawk-0.1.2}/CHANGELOG.md

@@ -2,7 +2,20 @@
 
 All notable changes to mcpgawk. Format: [Keep a Changelog](https://keepachangelog.com/); versioning: [SemVer](https://semver.org/).
 
-## [0.1.0] — unreleased
+## [0.1.2] — 2026-07-08
+
+### Changed
+- Plain, reader-first README and package description.
+- README images use absolute URLs so they render on PyPI (relative paths only work on GitHub).
+
+## [0.1.1] — 2026-07-08
+
+### Fixed
+- A tool declaring `destructiveHint: true` is now counted as write/mutating even when its name isn't a
+  write-verb (e.g. a `pause_job` tool). Previously the verb heuristic could leave a declared-destructive
+  tool unflagged.
+
+## [0.1.0] — 2026-07-08
 
 Initial release. Local-first MCP measurement.
 

{mcpgawk-0.1.1 → mcpgawk-0.1.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: mcpgawk
-Version: 0.1.1
-Summary: Local-first MCP measurement — gawk at an MCP server before you trust it. No inventory ever leaves your machine.
+Version: 0.1.2
+Summary: A local-first CLI that measures what an MCP server costs and what it can do. Nothing leaves your machine.
 Project-URL: Homepage, https://mcp.gawk.dev
 Project-URL: Documentation, https://mcp.gawk.dev
 Project-URL: Repository, https://github.com/gawk-dev/mcpgawk
@@ -29,11 +29,11 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/wordmark-dark.png">
-    <img alt="mcpgawk by nativerse" src="assets/brand/wordmark-light.png" width="320">
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/wordmark-dark.png">
+    <img alt="mcpgawk by nativerse" src="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/wordmark-light.png" width="320">
   </picture>
 </p>
-<p align="center"><em>gawk at it before you trust it.</em></p>
+<p align="center"><em>Make MCP lean and honest.</em></p>
 
 # mcpgawk
 
@@ -43,20 +43,18 @@ Description-Content-Type: text/markdown
 [![CI](https://github.com/gawk-dev/mcpgawk/actions/workflows/ci.yml/badge.svg)](https://github.com/gawk-dev/mcpgawk/actions/workflows/ci.yml)
 [![No egress](https://img.shields.io/badge/inventory-never%20uploaded-brightgreen.svg)](#guarantees)
 
-**gawk at an MCP server before you trust it.** A single, local-first command that connects to any
-[Model Context Protocol](https://modelcontextprotocol.io) server and measures what it will cost and
-expose — **without the server's inventory ever leaving your machine.**
+A local-first command that measures what a [Model Context Protocol](https://modelcontextprotocol.io)
+server costs and what it can do. It runs on your machine and uploads nothing.
 
 <p align="center">
-  <img src="assets/brand/demo.gif" alt="mcpgawk scanning an MCP server — tools, token cost, and capability flags, locally" width="760">
+  <img src="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/demo.gif" alt="mcpgawk scanning an MCP server — tools, token cost, and capability flags, locally" width="760">
 </p>
 <p align="center"><sub>Real output. Reproducible on your machine — no account, nothing uploaded.</sub></p>
 
 ## Why
 
-Every MCP server you connect dumps *all* its tool definitions into your model's context at connect
-time — whether you use one tool or none. That's a hidden **token tax** and an unvetted **trust
-surface**. mcpgawk measures both, **locally**, and never phones home about what it saw.
+Connect an MCP server and it loads all its tools into your AI's context. Every request. Used or not.
+You pay for those tokens, and you haven't checked what the tools can do. mcpgawk shows you both, locally.
 
 ## How it's different
 
@@ -110,7 +108,7 @@ mcpgawk scan mcp.json --json                                      # machine-read
 - **Facts ≠ heuristics.** Exact capability facts and the token index never mix with the bounded
   heuristic signals — separate in code, separate in output.
 - **Reproducible.** One command, identical numbers.
-- **Rides protocol evolution.** Built on the official `mcp` SDK, which negotiates the protocol version.
+- **Tracks the protocol.** Built on the official `mcp` SDK, which negotiates the protocol version.
 
 ## Develop
 

{mcpgawk-0.1.1 → mcpgawk-0.1.2}/README.md

@@ -1,10 +1,10 @@
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="assets/brand/wordmark-dark.png">
-    <img alt="mcpgawk by nativerse" src="assets/brand/wordmark-light.png" width="320">
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/wordmark-dark.png">
+    <img alt="mcpgawk by nativerse" src="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/wordmark-light.png" width="320">
   </picture>
 </p>
-<p align="center"><em>gawk at it before you trust it.</em></p>
+<p align="center"><em>Make MCP lean and honest.</em></p>
 
 # mcpgawk
 
@@ -14,20 +14,18 @@
 [![CI](https://github.com/gawk-dev/mcpgawk/actions/workflows/ci.yml/badge.svg)](https://github.com/gawk-dev/mcpgawk/actions/workflows/ci.yml)
 [![No egress](https://img.shields.io/badge/inventory-never%20uploaded-brightgreen.svg)](#guarantees)
 
-**gawk at an MCP server before you trust it.** A single, local-first command that connects to any
-[Model Context Protocol](https://modelcontextprotocol.io) server and measures what it will cost and
-expose — **without the server's inventory ever leaving your machine.**
+A local-first command that measures what a [Model Context Protocol](https://modelcontextprotocol.io)
+server costs and what it can do. It runs on your machine and uploads nothing.
 
 <p align="center">
-  <img src="assets/brand/demo.gif" alt="mcpgawk scanning an MCP server — tools, token cost, and capability flags, locally" width="760">
+  <img src="https://raw.githubusercontent.com/gawk-dev/mcpgawk/main/assets/brand/demo.gif" alt="mcpgawk scanning an MCP server — tools, token cost, and capability flags, locally" width="760">
 </p>
 <p align="center"><sub>Real output. Reproducible on your machine — no account, nothing uploaded.</sub></p>
 
 ## Why
 
-Every MCP server you connect dumps *all* its tool definitions into your model's context at connect
-time — whether you use one tool or none. That's a hidden **token tax** and an unvetted **trust
-surface**. mcpgawk measures both, **locally**, and never phones home about what it saw.
+Connect an MCP server and it loads all its tools into your AI's context. Every request. Used or not.
+You pay for those tokens, and you haven't checked what the tools can do. mcpgawk shows you both, locally.
 
 ## How it's different
 
@@ -81,7 +79,7 @@ mcpgawk scan mcp.json --json                                      # machine-read
 - **Facts ≠ heuristics.** Exact capability facts and the token index never mix with the bounded
   heuristic signals — separate in code, separate in output.
 - **Reproducible.** One command, identical numbers.
-- **Rides protocol evolution.** Built on the official `mcp` SDK, which negotiates the protocol version.
+- **Tracks the protocol.** Built on the official `mcp` SDK, which negotiates the protocol version.
 
 ## Develop
 

{mcpgawk-0.1.1/docs → mcpgawk-0.1.2}/assets/brand/social-preview.svg

@@ -8,8 +8,8 @@
   <text x="256" y="196" dominant-baseline="central" font-family="Sentient, Georgia, serif" font-weight="500" font-size="104" letter-spacing="-3" fill="#16160F">mcpgawk</text>
   <text x="258" y="270" font-family="Supreme, -apple-system, sans-serif" font-size="30" letter-spacing="0.5" fill="#6B6B5E">by <tspan fill="#2A33C2" font-weight="500">nativerse</tspan></text>
   <line x1="96" y1="352" x2="1184" y2="352" stroke="#E7E6E0" stroke-width="1.5"/>
-  <text x="96" y="438" font-family="Sentient, Georgia, serif" font-size="42" fill="#3A3A30">gawk at it before you trust it.</text>
+  <text x="96" y="438" font-family="Sentient, Georgia, serif" font-size="42" fill="#3A3A30">Make it lean. Make it honest.</text>
   <text x="96" y="524" font-family="Tabular, ui-monospace, Menlo, monospace" font-size="25" fill="#717166"><tspan fill="#2A9d6b">●</tspan> cli-stdio   14 tools   2061 tok@connect   4 flagged</text>
   <circle cx="102" cy="576" r="6" fill="#2A9d6b"/>
-  <text x="120" y="576" dominant-baseline="central" font-family="Tabular, ui-monospace, Menlo, monospace" font-size="24" letter-spacing="1" fill="#6B6B5E">local · no inventory ever leaves your machine</text>
+  <text x="120" y="576" dominant-baseline="central" font-family="Tabular, ui-monospace, Menlo, monospace" font-size="24" letter-spacing="1" fill="#6B6B5E">local · nothing leaves your machine</text>
 </svg>

mcpgawk-0.1.2/docs/CNAME

@@ -0,0 +1 @@
+mcp.gawk.dev

{mcpgawk-0.1.1 → mcpgawk-0.1.2}/docs/index.html

@@ -3,10 +3,10 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>mcpgawk · gawk at an MCP server before you trust it</title>
-<meta name="description" content="A local-first CLI that measures what an MCP server costs and exposes — before you trust it. Nothing ever leaves your machine.">
+<title>mcpgawk · measure any MCP server, locally</title>
+<meta name="description" content="A local-first CLI that measures what an MCP server costs and what it can do. Make MCP lean and honest. Nothing leaves your machine.">
 <meta property="og:title" content="mcpgawk by nativerse">
-<meta property="og:description" content="MCP's hidden tax — you pay it on every prompt, before you type a word. Measure it locally.">
+<meta property="og:description" content="Every MCP server loads all its tools into your AI's context, on every request. mcpgawk measures the cost and the risk, locally.">
 <meta property="og:image" content="assets/brand/social-preview.png">
 <meta name="twitter:card" content="summary_large_image">
 <link rel="icon" href="assets/brand/favicon.svg">
@@ -42,8 +42,8 @@
   <div class="wrap">
     <div class="hero-grid">
       <div class="hero-copy">
-        <p class="n-kicker n-kicker--accent">The token tax of MCP</p>
-        <h1 class="n-hero" style="margin-top:16px">gawk at an MCP server before you trust it.</h1>
+        <p class="n-kicker n-kicker--accent">MCP connects your AI to everything</p>
+        <h1 class="n-hero" style="margin-top:16px">Make it lean. Make it honest.</h1>
         <p class="n-lead" style="margin-top:20px;max-width:54ch">Connect an MCP server and it loads every tool into your AI's context. Every message. Used or not. You pay for those tokens, and you haven't checked what the tools can do. mcpgawk shows you both. <span class="n-em">Locally.</span></p>
         <div class="cta-row">
           <a class="n-btn" href="#measure">Measure your stack</a>
@@ -145,7 +145,7 @@
   <div class="foot-grid">
     <div class="foot-brand">
       <a class="brand" href="/"><img class="brand-icon" src="assets/brand/nativerse-mark.svg" alt=""><span class="brand-name">mcpgawk</span></a>
-      <p class="footer-motto">gawk at it before you trust it.<small>by nativerse · gawk.dev</small></p>
+      <p class="footer-motto">Make MCP lean and honest.<small>by nativerse · gawk.dev</small></p>
     </div>
     <div class="foot-col">
       <p class="n-kicker">Project</p>

{mcpgawk-0.1.1 → mcpgawk-0.1.2}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcpgawk"
-version = "0.1.1"
-description = "Local-first MCP measurement — gawk at an MCP server before you trust it. No inventory ever leaves your machine."
+version = "0.1.2"
+description = "A local-first CLI that measures what an MCP server costs and what it can do. Nothing leaves your machine."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "Apache-2.0"

mcpgawk-0.1.1/docs/CNAME

@@ -1 +0,0 @@
-mcp.gawk.dev