pdf-table-pull-lite 1.1.0__tar.gz → 1.2.0__tar.gz

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 What changed in pdf-table-pull-lite, newest first.
 
+## 1.2.0 - 2026-11-04
+
+- MCP tool now has safety labels (tool annotations) so AI apps know what it does:
+  readOnlyHint false, destructiveHint true, idempotentHint true, openWorldHint false.
+- The tool description now says when to use it and when not to.
+- Needs mcp 1.10 or newer.
+
 ## 1.1.0 - 2026-11-04
 
 - New: a free MCP server, `pdf-table-pull-lite-mcp`. It gives AI apps one tool, `extract_pdf_tables`.

{pdf_table_pull_lite-1.1.0/pdf_table_pull_lite.egg-info → pdf_table_pull_lite-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdf-table-pull-lite
-Version: 1.1.0
+Version: 1.2.0
 Summary: Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server.
 Author: Tidy Byte Tools
 License-Expression: MIT
@@ -27,9 +27,18 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pdfplumber>=0.10
-Requires-Dist: mcp<2,>=1.2
+Requires-Dist: mcp<2,>=1.10
 Dynamic: license-file
 
+<p>
+  <a href="https://github.com/tidybytetools">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-dark.png">
+      <img alt="Tidy Byte Tools" src="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-light.png" height="44">
+    </picture>
+  </a>
+</p>
+
 # pdf-table-pull-lite
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/README.md

@@ -1,3 +1,12 @@
+<p>
+  <a href="https://github.com/tidybytetools">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-dark.png">
+      <img alt="Tidy Byte Tools" src="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-light.png" height="44">
+    </picture>
+  </a>
+</p>
+
 # pdf-table-pull-lite
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0/pdf_table_pull_lite.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdf-table-pull-lite
-Version: 1.1.0
+Version: 1.2.0
 Summary: Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server.
 Author: Tidy Byte Tools
 License-Expression: MIT
@@ -27,9 +27,18 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pdfplumber>=0.10
-Requires-Dist: mcp<2,>=1.2
+Requires-Dist: mcp<2,>=1.10
 Dynamic: license-file
 
+<p>
+  <a href="https://github.com/tidybytetools">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-dark.png">
+      <img alt="Tidy Byte Tools" src="https://raw.githubusercontent.com/tidybytetools/pdf-table-pull-lite/main/assets/tidybytetools-lockup-light.png" height="44">
+    </picture>
+  </a>
+</p>
+
 # pdf-table-pull-lite
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/pdf_table_pull_lite.egg-info/requires.txt

@@ -1,2 +1,2 @@
 pdfplumber>=0.10
-mcp<2,>=1.2
+mcp<2,>=1.10

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/pdf_table_pull_lite.py

@@ -11,7 +11,7 @@ Usage:
 """
 import argparse, csv, os, re, sys
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 PRO_URL = "https://tidybyte.gumroad.com/l/hkxqxh"
 PRO_LINE = f"Need Excel output, scanned PDFs or tables joined across pages? pdf-table-pull (paid): {PRO_URL}"
 

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/pdf_table_pull_lite_mcp.py

@@ -4,20 +4,39 @@ Run:  uvx --from git+https://github.com/tidybytetools/pdf-table-pull-lite pdf-ta
 """
 import csv, io, os
 from mcp.server.fastmcp import FastMCP
+from mcp.types import ToolAnnotations
 import pdf_table_pull_lite as lite
 
 mcp = FastMCP("pdf-table-pull-lite")
 
 
-@mcp.tool()
+@mcp.tool(
+    title="Extract PDF tables to CSV",
+    annotations=ToolAnnotations(
+        title="Extract PDF tables to CSV",
+        readOnlyHint=False,      # writes CSV files when output_dir is set
+        destructiveHint=True,    # may replace CSV files with the same names in output_dir
+        idempotentHint=True,     # same input gives the same output
+        openWorldHint=False,     # local files only, no network
+    ),
+)
 def extract_pdf_tables(path: str, pages: str = "", strategy: str = "auto", output_dir: str = "") -> list[str]:
     """Pull the tables out of a local text PDF.
 
+    Use this when you need the rows and columns of a table from a PDF on this
+    computer, for example to load them into a spreadsheet, pandas or a database.
+    Do not use it for scanned PDFs or photos (there is no OCR), for PDFs on the web
+    (download the file first), or when you want the whole document as text
+    (use a PDF-to-Markdown or text tool instead).
+
     path: full path to a PDF on this computer.
     pages: optional, like "1,3-5". Empty means all pages.
-    strategy: "auto" (default), "lines" (ruled borders) or "text" (lined up by spacing).
+    strategy: "auto" (default, tries borders first, then spacing), "lines" (tables with
+    ruled borders) or "text" (tables lined up by spacing). Try "text" if "auto" misses
+    a table that has no border lines.
     output_dir: optional. If set, each table is saved there as a CSV and the file paths
-    are returned. If empty, the CSV text of each table is returned.
+    are returned. Files named pageN_tableM.csv that already exist there are replaced.
+    If empty, nothing is written and the CSV text of each table is returned.
 
     Scanned (image-only) pages have no text and are skipped. Returns [] if no tables.
     """

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdf-table-pull-lite"
-version = "1.1.0"
+version = "1.2.0"
 description = "Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server."
 readme = "README.md"
 license = "MIT"
@@ -13,7 +13,7 @@ authors = [{name = "Tidy Byte Tools"}]
 requires-python = ">=3.10"
 dependencies = [
   "pdfplumber>=0.10",
-  "mcp>=1.2,<2",
+  "mcp>=1.10,<2",
 ]
 keywords = ["pdf", "table", "csv", "extract", "pdf-to-csv", "pdfplumber", "cli", "mcp", "mcp-server"]
 classifiers = [

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/server.json

@@ -8,13 +8,13 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/tidybytetools/pdf-table-pull-lite",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "pdf-table-pull-lite",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{pdf_table_pull_lite-1.1.0 → pdf_table_pull_lite-1.2.0}/tests/test_mcp.py

@@ -15,15 +15,23 @@ async def _run():
     async with stdio_client(params) as (r, w):
         async with ClientSession(r, w) as s:
             await s.initialize()
-            tools = [t.name for t in (await s.list_tools()).tools]
+            listed = (await s.list_tools()).tools
+            tools = [t.name for t in listed]
+            ann = listed[0].annotations
             res = await s.call_tool("extract_pdf_tables", {"path": os.path.abspath(os.path.join(HERE, "fixtures", "ruled.pdf")), "pages": "1"})
-            return tools, res
+            return tools, res, ann
 
 
 @unittest.skipIf(ClientSession is None, "mcp not installed")
 class MCP(unittest.TestCase):
     def test_lists_and_calls_tool(self):
-        tools, res = asyncio.run(_run())
+        tools, res, ann = asyncio.run(_run())
+        self.assertIsNotNone(ann)
+        self.assertIs(ann.readOnlyHint, False)
+        self.assertIs(ann.destructiveHint, True)
+        self.assertIs(ann.idempotentHint, True)
+        self.assertIs(ann.openWorldHint, False)
+
         self.assertEqual(tools, ["extract_pdf_tables"])
         self.assertFalse(res.isError)
         text = " ".join(c.text for c in res.content if getattr(c, "type", "") == "text")