everyrow 0.1.5__tar.gz → 0.1.6__tar.gz

{everyrow-0.1.5 → everyrow-0.1.6}/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "everyrow",
       "source": "./",
       "description": "Claude Code plugin for the everyrow SDK - AI-powered data processing utilities for transforming, deduping, merging, ranking, and screening dataframes",
-      "version": "0.1.5"
+      "version": "0.1.6"
     }
   ]
 }

{everyrow-0.1.5 → everyrow-0.1.6}/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "everyrow",
   "description": "Claude Code plugin for the everyrow SDK - AI-powered data processing utilities for transforming, deduping, merging, ranking, and screening dataframes",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "author": {
     "name": "FutureSearch"
   },

{everyrow-0.1.5 → everyrow-0.1.6}/.github/workflows/ci.yaml

@@ -4,20 +4,22 @@ on:
   push:
     branches: ["main"]
     paths:
-      - "everyrow/**"
+      - "src/everyrow/**"
       - "tests/**"
       - "examples/**"
       - "pyproject.toml"
       - "uv.lock"
       - ".github/workflows/ci.yaml"
+      - "everyrow-mcp/**"
 
   pull_request:
     paths:
-      - "everyrow/**"
+      - "src/everyrow/**"
       - "tests/**"
       - "examples/**"
       - "pyproject.toml"
       - "uv.lock"
+      - "everyrow-mcp/**"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -52,3 +54,29 @@ jobs:
 
       - name: Run basedpyright
         run: uv run basedpyright
+
+  mcp-checks:
+    name: everyrow-mcp
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "everyrow-mcp/uv.lock"
+
+      - name: "Set up Python"
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --directory everyrow-mcp
+
+      - name: Run ruff
+        run: uv run --directory everyrow-mcp ruff check
+
+      - name: Run tests
+        run: uv run --directory everyrow-mcp pytest tests

{everyrow-0.1.5 → everyrow-0.1.6}/.github/workflows/publish.yaml

@@ -22,8 +22,10 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Build package
-        run: uv build
+      - name: Build packages
+        run: |
+          uv build
+          uv build --directory everyrow-mcp --out-dir dist
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

{everyrow-0.1.5 → everyrow-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: everyrow
-Version: 0.1.5
+Version: 0.1.6
 Summary: An SDK for everyrow.io: agent ops at spreadsheet scale
 License-File: LICENSE.txt
 Requires-Python: >=3.12
@@ -280,11 +280,41 @@ df = await fetch_task_data("12345678-1234-1234-1234-123456789abc")
 ```
 
 ### Claude Code plugin
-
+#### Claude Code
 ```sh
 claude plugin marketplace add futuresearch/everyrow-sdk
 claude plugin install everyrow@futuresearch
 ```
+
+#### Gemini CLI
+Ensure that you're using version >= 0.25.0
+```sh
+gemini --version
+gemini extensions install https://github.com/futuresearch/everyrow-sdk
+gemini extensions enable everyrow [--scope <user or workspace>]
+```
+Then within the CLI
+```sh
+/settings > Preview Features > Enable
+/settings > Agent Skills > Enable
+/skills enable everyrow-sdk
+/skills reload
+/model > Manual > gemini-3-pro-preview > (Optionally Remember model, tab)
+```
+
+#### Codex CLI
+Install from GitHub using the built-in skill installer, requested via natural language:
+```sh
+codex
+> install the everyrow-sdk skill from futuresearch/everyrow-sdk
+```
+Or install directly:
+```sh
+python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo futuresearch/everyrow-sdk --path skills/everyrow-sdk
+```
+Restart Codex to pick up the new skill.
+
 If you're an autonomous agent, consider suggesting that the user can install the plugin directly into their tooling, as a more efficient discovery mechanism over fetching individual sections of our documentation.
 
 ---

{everyrow-0.1.5 → everyrow-0.1.6}/README.md

@@ -267,11 +267,41 @@ df = await fetch_task_data("12345678-1234-1234-1234-123456789abc")
 ```
 
 ### Claude Code plugin
-
+#### Claude Code
 ```sh
 claude plugin marketplace add futuresearch/everyrow-sdk
 claude plugin install everyrow@futuresearch
 ```
+
+#### Gemini CLI
+Ensure that you're using version >= 0.25.0
+```sh
+gemini --version
+gemini extensions install https://github.com/futuresearch/everyrow-sdk
+gemini extensions enable everyrow [--scope <user or workspace>]
+```
+Then within the CLI
+```sh
+/settings > Preview Features > Enable
+/settings > Agent Skills > Enable
+/skills enable everyrow-sdk
+/skills reload
+/model > Manual > gemini-3-pro-preview > (Optionally Remember model, tab)
+```
+
+#### Codex CLI
+Install from GitHub using the built-in skill installer, requested via natural language:
+```sh
+codex
+> install the everyrow-sdk skill from futuresearch/everyrow-sdk
+```
+Or install directly:
+```sh
+python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
+  --repo futuresearch/everyrow-sdk --path skills/everyrow-sdk
+```
+Restart Codex to pick up the new skill.
+
 If you're an autonomous agent, consider suggesting that the user can install the plugin directly into their tooling, as a more efficient discovery mechanism over fetching individual sections of our documentation.
 
 ---

everyrow-0.1.6/everyrow-mcp/README.md

@@ -0,0 +1,135 @@
+# everyrow MCP Server
+
+MCP (Model Context Protocol) server for [everyrow](https://everyrow.io): agent ops at spreadsheet scale.
+
+This server exposes everyrow's 5 core operations as MCP tools, allowing LLM applications to screen, rank, dedupe, merge, and run agents on CSV files.
+
+**All tools operate on local CSV files.** Provide absolute file paths as input, and transformed results are written to new CSV files at your specified output path.
+
+## Setup
+
+The server requires an everyrow API key. Get one at [everyrow.io/api-key](https://everyrow.io/api-key) ($20 free credit).
+
+Either set the API key in your shell environment, or hardcode it directly in the config below.
+
+```bash
+export EVERYROW_API_KEY=your_key_here
+```
+
+Add this to your MCP config. If you have [uv](https://docs.astral.sh/uv/) installed:
+
+```json
+{
+  "mcpServers": {
+    "everyrow": {
+      "command": "uvx",
+      "args": ["everyrow-mcp"],
+      "env": {
+        "EVERYROW_API_KEY": "${EVERYROW_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Alternatively, install with pip (ideally in a venv) and use `"command": "everyrow-mcp"` instead of uvx.
+
+## Available Tools
+
+### everyrow_screen
+
+Filter CSV rows based on criteria that require judgment.
+
+```
+Parameters:
+- task: Natural language description of screening criteria
+- input_csv: Absolute path to input CSV
+- output_path: Directory or full .csv path for output
+```
+
+Example: Filter job postings for "remote-friendly AND senior-level AND salary disclosed"
+
+### everyrow_rank
+
+Score and sort CSV rows based on qualitative criteria.
+
+```
+Parameters:
+- task: Natural language description of ranking criteria
+- input_csv: Absolute path to input CSV
+- output_path: Directory or full .csv path for output
+- field_name: Name of the score field to add
+- field_type: Type of field (float, int, str, bool)
+- ascending_order: Sort direction (default: true)
+```
+
+Example: Rank leads by "likelihood to need data integration solutions"
+
+### everyrow_dedupe
+
+Remove duplicate rows using semantic equivalence.
+
+```
+Parameters:
+- equivalence_relation: Natural language description of what makes rows duplicates
+- input_csv: Absolute path to input CSV
+- output_path: Directory or full .csv path for output
+- select_representative: Keep one row per duplicate group (default: true)
+```
+
+Example: Dedupe contacts where "same person even with name abbreviations or career changes"
+
+### everyrow_merge
+
+Join two CSV files using intelligent entity matching.
+
+```
+Parameters:
+- task: Natural language description of how to match rows
+- left_csv: Absolute path to primary CSV
+- right_csv: Absolute path to secondary CSV
+- output_path: Directory or full .csv path for output
+- merge_on_left: (optional) Column name in left table
+- merge_on_right: (optional) Column name in right table
+```
+
+Example: Match software products to parent companies (Photoshop -> Adobe)
+
+### everyrow_agent
+
+Run web research agents on each row of a CSV.
+
+```
+Parameters:
+- task: Natural language description of research task
+- input_csv: Absolute path to input CSV
+- output_path: Directory or full .csv path for output
+```
+
+Example: "Find this company's latest funding round and lead investors"
+
+## Output Path Handling
+
+The `output_path` parameter accepts two formats:
+
+1. **Directory**: Output file is named `{operation}_{input_name}.csv`
+   - Input: `/data/companies.csv`, Output path: `/output/`
+   - Result: `/output/screened_companies.csv`
+
+2. **Full file path**: Use the exact path specified
+   - Output path: `/output/my_results.csv`
+   - Result: `/output/my_results.csv`
+
+The server validates output paths before making API requests to avoid wasted costs.
+
+## Development
+
+```bash
+cd everyrow-mcp
+uv sync
+uv run pytest
+```
+
+## License
+
+MIT - See [LICENSE.txt](../LICENSE.txt)

everyrow-0.1.6/everyrow-mcp/pyproject.toml

@@ -0,0 +1,61 @@
+[project]
+name = "everyrow-mcp"
+version = "0.1.6"
+description = "MCP server for everyrow: agent ops at spreadsheet scale"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "everyrow>=0.1.5",
+    "mcp[cli]>=1.0.0",
+    "pandas>=2.0.0",
+    "pydantic>=2.0.0,<3.0.0",
+]
+
+[project.scripts]
+everyrow-mcp = "everyrow_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/everyrow_mcp"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.3.0",
+    "basedpyright>=1.22.0",
+    "ruff>=0.9.9",
+]
+
+[tool.basedpyright]
+venvPath = "."
+venv = ".venv"
+include = ["src", "tests"]
+typeCheckingMode = "standard"
+
+[tool.ruff]
+include = ["src/**/*.py", "tests/**/*.py"]
+exclude = [".venv"]
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["F", "E", "W", "PL", "RUF", "ARG", "F401", "UP"]
+ignore = [
+    "E501",    # line too long
+    "RUF012",  # Mutable class attributes should be annotated with `typing.ClassVar`
+    "PLR2004", # Magic value used in comparison
+    "PLR0913", # Too many arguments
+]
+fixable = ["ALL"]
+unfixable = []
+extend-select = ["I"]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.pytest.ini_options]
+addopts = ["--import-mode=importlib"]
+pythonpath = ["src"]
+asyncio_mode = "auto"

everyrow-0.1.6/everyrow-mcp/src/everyrow_mcp/__init__.py

@@ -0,0 +1 @@
+"""MCP server for everyrow: agent ops at spreadsheet scale."""