everyrow-mcp 0.1.9__tar.gz → 0.2.0__tar.gz

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/.gitignore

@@ -217,3 +217,12 @@ __marimo__/
 
 .history/
 .python-version
+
+# MCPB bundles
+*.mcpb
+
+# MCP registry tokens
+.mcpregistry_*
+
+# Claude Code local instructions
+CLAUDE.local.md

everyrow_mcp-0.2.0/.mcpbignore

@@ -0,0 +1,13 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+*.egg-info/
+server/lib/
+server/venv/
+.mcpregistry_github_token
+.mcpregistry_registry_token
+tests/
+dist/
+.ruff_cache/

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: everyrow-mcp
-Version: 0.1.9
+Version: 0.2.0
 Summary: MCP server for everyrow: agent ops at spreadsheet scale
 Requires-Python: >=3.12
 Requires-Dist: everyrow>=0.1.5
@@ -17,11 +17,27 @@ This server exposes everyrow's 5 core operations as MCP tools, allowing LLM appl
 
 **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
+## Installation
 
 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.
+### Claude Desktop
+
+Download the latest `.mcpb` bundle from the [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) page and double-click to install in Claude Desktop. You'll be prompted to enter your everyrow API key during setup.
+
+> **Note:** The MCPB bundle works in Claude Desktop's **Chat** mode. Due to a [known limitation](https://github.com/anthropics/claude-code/issues/20377), local MCP servers are not currently exposed in Cowork mode.
+
+### Cursor
+Set the environment variable in your terminal shell before opening cursor. You may need to re-open cursor from your shell after this. Alternatively, hardcode the api key within cursor settings instead of the hard-coded `${env:EVERYROW_API_KEY}`
+```bash
+export EVERYROW_API_KEY=your_key_here
+```
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=everyrow&config=eyJlbnYiOnsiRVZFUllST1dfQVBJX0tFWSI6IiR7ZW52OkVWRVJZUk9XX0FQSV9LRVl9In0sImNvbW1hbmQiOiJ1dnggZXZlcnlyb3ctbWNwIn0%3D)
+
+### Manual Config
+
+Either set the API key in your shell environment as mentioned above, or hardcode it directly in the config below. Environment variable interpolation may differ between MCP clients.
 
 ```bash
 export EVERYROW_API_KEY=your_key_here
@@ -140,7 +156,7 @@ cd everyrow-mcp
 uv sync
 uv run pytest
 ```
-For MCP registry publishing:
+For MCP [registry publishing](https://modelcontextprotocol.info/tools/registry/publishing/#package-deployment):
 
 mcp-name: io.github.futuresearch/everyrow-mcp
 

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/README.md

@@ -6,11 +6,27 @@ This server exposes everyrow's 5 core operations as MCP tools, allowing LLM appl
 
 **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
+## Installation
 
 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.
+### Claude Desktop
+
+Download the latest `.mcpb` bundle from the [GitHub Releases](https://github.com/futuresearch/everyrow-sdk/releases) page and double-click to install in Claude Desktop. You'll be prompted to enter your everyrow API key during setup.
+
+> **Note:** The MCPB bundle works in Claude Desktop's **Chat** mode. Due to a [known limitation](https://github.com/anthropics/claude-code/issues/20377), local MCP servers are not currently exposed in Cowork mode.
+
+### Cursor
+Set the environment variable in your terminal shell before opening cursor. You may need to re-open cursor from your shell after this. Alternatively, hardcode the api key within cursor settings instead of the hard-coded `${env:EVERYROW_API_KEY}`
+```bash
+export EVERYROW_API_KEY=your_key_here
+```
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=everyrow&config=eyJlbnYiOnsiRVZFUllST1dfQVBJX0tFWSI6IiR7ZW52OkVWRVJZUk9XX0FQSV9LRVl9In0sImNvbW1hbmQiOiJ1dnggZXZlcnlyb3ctbWNwIn0%3D)
+
+### Manual Config
+
+Either set the API key in your shell environment as mentioned above, or hardcode it directly in the config below. Environment variable interpolation may differ between MCP clients.
 
 ```bash
 export EVERYROW_API_KEY=your_key_here
@@ -129,7 +145,7 @@ cd everyrow-mcp
 uv sync
 uv run pytest
 ```
-For MCP registry publishing:
+For MCP [registry publishing](https://modelcontextprotocol.info/tools/registry/publishing/#package-deployment):
 
 mcp-name: io.github.futuresearch/everyrow-mcp
 

everyrow_mcp-0.2.0/manifest.json

@@ -0,0 +1,70 @@
+{
+  "manifest_version": "0.4",
+  "name": "everyrow-mcp",
+  "display_name": "Everyrow MCP Server",
+  "version": "0.2.0",
+  "description": "AI-powered dataframe ops: transform, dedupe, merge, rank, and screen with natural language",
+  "long_description": "MCP server for everyrow: 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.",
+  "author": {
+    "name": "FutureSearch",
+    "url": "https://everyrow.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/futuresearch/everyrow-sdk.git"
+  },
+  "homepage": "https://everyrow.io",
+  "documentation": "https://github.com/futuresearch/everyrow-sdk/tree/main/everyrow-mcp",
+  "support": "https://github.com/futuresearch/everyrow-sdk/issues",
+  "server": {
+    "type": "uv",
+    "entry_point": "src/everyrow_mcp/server.py",
+    "mcp_config": {
+      "command": "uv",
+      "args": ["run", "${__dirname}/src/everyrow_mcp/server.py"],
+      "env": {
+        "EVERYROW_API_KEY": "${user_config.api_key}"
+      }
+    }
+  },
+  "tools": [
+    {
+      "name": "everyrow_screen",
+      "description": "Filter CSV rows based on criteria that require judgment"
+    },
+    {
+      "name": "everyrow_rank",
+      "description": "Score and sort CSV rows based on qualitative criteria"
+    },
+    {
+      "name": "everyrow_dedupe",
+      "description": "Remove duplicate rows using semantic equivalence"
+    },
+    {
+      "name": "everyrow_merge",
+      "description": "Join two CSV files using intelligent entity matching"
+    },
+    {
+      "name": "everyrow_agent",
+      "description": "Run web research agents on each row of a CSV"
+    }
+  ],
+  "user_config": {
+    "api_key": {
+      "type": "string",
+      "title": "Everyrow API Key",
+      "description": "Your API key from https://everyrow.io/api-key ($20 free credit)",
+      "sensitive": true,
+      "required": true
+    }
+  },
+  "compatibility": {
+    "platforms": ["darwin", "linux", "win32"],
+    "runtimes": {
+      "python": ">=3.12"
+    }
+  },
+  "keywords": ["everyrow", "dataframe", "csv", "ai", "data-processing", "dedupe", "merge", "rank", "screen"],
+  "license": "MIT",
+  "privacy_policies": ["https://futuresearch.ai/privacy/"]
+}

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "everyrow-mcp"
-version = "0.1.9"
+version = "0.2.0"
 description = "MCP server for everyrow: agent ops at spreadsheet scale"
 readme = "README.md"
 requires-python = ">=3.12"

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/server.json

@@ -9,13 +9,13 @@
     "subfolder": "everyrow-mcp"
   },
   "websiteUrl": "https://github.com/futuresearch/everyrow-sdk/tree/main/everyrow-mcp",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "everyrow-mcp",
-      "version": "0.1.9",
+      "version": "0.2.0",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/src/everyrow_mcp/server.py

@@ -1,10 +1,11 @@
 """MCP server for everyrow SDK operations."""
 
 import json
+import logging
 import os
 import sys
 from contextlib import asynccontextmanager
-from typing import Any
+from typing import Any, Literal
 
 import pandas as pd
 from everyrow.api_utils import create_client
@@ -30,7 +31,6 @@ async def lifespan(_server: FastMCP):
             response = await whoami(client=c)
             if response is None:
                 raise RuntimeError("Failed to authenticate with everyrow API")
-        print("everyrow-mcp: Authenticated successfully")
     except Exception as e:
         raise RuntimeError(f"everyrow-mcp startup failed: {e}") from e
 
@@ -354,6 +354,10 @@ class MergeInput(BaseModel):
         description="Optional column name in the right table to use as the merge key. "
         "If not provided, the LLM will determine the best matching strategy.",
     )
+    use_web_search: Literal["auto", "yes", "no"] | None = Field(
+        default=None,
+        description='Optional. Control web search behavior: "auto" tries LLM merge first then conditionally searches, "no" skips web search entirely, "yes" forces web search on every row. Defaults to "auto" if not provided.',
+    )
 
     @field_validator("left_csv", "right_csv")
     @classmethod
@@ -395,6 +399,7 @@ async def everyrow_merge(params: MergeInput) -> str:
         right_table=right_df,
         merge_on_left=params.merge_on_left,
         merge_on_right=params.merge_on_right,
+        use_web_search=params.use_web_search,
     )
 
     output_file = resolve_output_path(params.output_path, params.left_csv, "merged")
@@ -539,6 +544,14 @@ def _schema_to_model(name: str, schema: dict[str, Any]) -> type[BaseModel]:
 
 def main():
     """Run the MCP server."""
+    # Configure logging to use stderr only (stdout is reserved for JSON-RPC)
+    logging.basicConfig(
+        level=logging.WARNING,
+        stream=sys.stderr,
+        format="%(levelname)s: %(message)s",
+        force=True,
+    )
+
     # Check for API key before starting
     if "EVERYROW_API_KEY" not in os.environ:
         print(

{everyrow_mcp-0.1.9 → everyrow_mcp-0.2.0}/uv.lock

@@ -214,7 +214,7 @@ wheels = [
 
 [[package]]
 name = "everyrow-mcp"
-version = "0.1.0"
+version = "0.1.9"
 source = { editable = "." }
 dependencies = [
     { name = "everyrow" },
@@ -972,8 +972,8 @@ name = "uvicorn"
 version = "0.40.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "click" },
-    { name = "h11" },
+    { name = "click", marker = "sys_platform != 'emscripten'" },
+    { name = "h11", marker = "sys_platform != 'emscripten'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/c3/d1/8f3c683c9561a4e6689dd3b1d345c815f10f86acd044ee1fb9a4dcd0b8c5/uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea", size = 81761, upload-time = "2025-12-21T14:16:22.45Z" }
 wheels = [