feat: rename everyrow SDK to futuresearch-python (#4943)

Sourced from commit a8ee4f471f7bd4ebdd51c7b2abc39a81fcbf8db8

Author: Daniel Hnyk

.claude-plugin/marketplace.json

@@ -4,11 +4,11 @@
     "name": "FutureSearch"
   },
   "metadata": {
-    "description": "everyrow plugins from FutureSearch"
+    "description": "futuresearch plugins from FutureSearch"
   },
   "plugins": [
     {
-      "name": "everyrow",
+      "name": "futuresearch",
       "source": "./",
       "description": "Give Claude Code a research team. Forecast, score, classify, or research every row of a dataset.",
       "version": "0.5.1"

.claude-plugin/plugin.json

@@ -1,17 +1,17 @@
 {
-  "name": "everyrow",
+  "name": "futuresearch",
   "description": "Give Claude Code a research team. Forecast, score, classify, or research every row of a dataset.",
   "version": "0.5.1",
   "author": {
     "name": "FutureSearch"
   },
   "repository": "https://github.com/futuresearch/everyrow-sdk",
   "mcpServers": {
-    "everyrow": {
+    "futuresearch": {
       "command": "uvx",
-      "args": ["everyrow-mcp"],
+      "args": ["futuresearch-mcp"],
       "env": {
-        "EVERYROW_API_KEY": "${EVERYROW_API_KEY}"
+        "FUTURESEARCH_API_KEY": "${FUTURESEARCH_API_KEY}"
       }
     }
   }

.claude/skills/deploy-mcp/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deploy-mcp
-description: Deploy the everyrow MCP server to staging or production on GKE. Use when the user wants to deploy, redeploy, roll back, scale replicas, or check deployment status. Triggers on deploy, redeploy, staging, production, rollout, scale, replicas.
+description: Deploy the FutureSearch MCP server to staging or production on GKE. Use when the user wants to deploy, redeploy, roll back, scale replicas, or check deployment status. Triggers on deploy, redeploy, staging, production, rollout, scale, replicas.
 ---
 
 # Deploying the MCP Server
@@ -39,10 +39,10 @@ gh run list --workflow="Deploy MCP Server" --limit 3
 gh run watch <run-id>
 
 # Check pod rollout
-kubectl rollout status deploy/everyrow-mcp-staging -n everyrow-mcp-staging --timeout=5m
+kubectl rollout status deploy/futuresearch-mcp-staging -n futuresearch-mcp-staging --timeout=5m
 
 # Verify pods are running
-kubectl get pods -n everyrow-mcp-staging -o wide
+kubectl get pods -n futuresearch-mcp-staging -o wide
 ```
 
 ## How It Works
@@ -62,7 +62,7 @@ The deploy uses `--atomic` so it auto-rolls back on failure.
 
 ### Via Helm values (persistent)
 
-Edit `everyrow-mcp/deploy/chart/values.staging.yaml`:
+Edit `futuresearch-mcp/deploy/chart/values.staging.yaml`:
 ```yaml
 replicaCount: 2  # Change this
 ```
@@ -72,29 +72,29 @@ Commit, push, and redeploy.
 
 ```bash
 # Staging
-kubectl scale deploy everyrow-mcp-staging -n everyrow-mcp-staging --replicas=3
+kubectl scale deploy futuresearch-mcp-staging -n futuresearch-mcp-staging --replicas=3
 
 # Take offline
-kubectl scale deploy everyrow-mcp-staging -n everyrow-mcp-staging --replicas=0
+kubectl scale deploy futuresearch-mcp-staging -n futuresearch-mcp-staging --replicas=0
 ```
 
 ## Environments
 
 | Environment | Namespace | Host | Redis DB |
 |---|---|---|---|
-| Staging | `everyrow-mcp-staging` | `mcp-staging.everyrow.io` | 14 |
-| Production | `everyrow-mcp` | `mcp.everyrow.io` | (default in values.yaml) |
+| Staging | `futuresearch-mcp-staging` | `mcp-staging.everyrow.io` | 14 |
+| Production | `futuresearch-mcp` | `mcp.everyrow.io` | (default in values.yaml) |
 
-Both environments hit the **same production EveryRow API** — there is no staging API.
+Both environments hit the **same production FutureSearch API** — there is no staging API.
 
 ## Updating Secrets
 
 ```bash
 # View current secrets
-sops -d everyrow-mcp/deploy/chart/secrets.staging.enc.yaml
+sops -d futuresearch-mcp/deploy/chart/secrets.staging.enc.yaml
 
 # Update a value
-sops --set '["secrets"]["data"]["KEY_NAME"] "new-value"' everyrow-mcp/deploy/chart/secrets.staging.enc.yaml
+sops --set '["secrets"]["data"]["KEY_NAME"] "new-value"' futuresearch-mcp/deploy/chart/secrets.staging.enc.yaml
 ```
 
 Commit the encrypted file and redeploy.
@@ -104,11 +104,11 @@ Commit the encrypted file and redeploy.
 | File | Purpose |
 |------|---------|
 | `.github/workflows/deploy-mcp.yaml` | CI/CD workflow (checks → build → deploy) |
-| `everyrow-mcp/deploy/chart/values.yaml` | Base Helm values |
-| `everyrow-mcp/deploy/chart/values.staging.yaml` | Staging overrides |
-| `everyrow-mcp/deploy/chart/secrets.enc.yaml` | Production secrets (SOPS) |
-| `everyrow-mcp/deploy/chart/secrets.staging.enc.yaml` | Staging secrets (SOPS) |
-| `everyrow-mcp/deploy/Dockerfile` | Server container image |
+| `futuresearch-mcp/deploy/chart/values.yaml` | Base Helm values |
+| `futuresearch-mcp/deploy/chart/values.staging.yaml` | Staging overrides |
+| `futuresearch-mcp/deploy/chart/secrets.enc.yaml` | Production secrets (SOPS) |
+| `futuresearch-mcp/deploy/chart/secrets.staging.enc.yaml` | Staging secrets (SOPS) |
+| `futuresearch-mcp/deploy/Dockerfile` | Server container image |
 
 ## Gotchas
 

.claude/skills/run-mcp-local/SKILL.md

@@ -1,17 +1,17 @@
 ---
 name: run-mcp-local
-description: Run the everyrow HTTP MCP server locally with Docker Compose and optionally expose it via Cloudflare tunnel. Use when starting/stopping the local MCP server, debugging startup issues, connecting Claude.ai or Claude Desktop to a local instance, or checking server logs. Triggers on mcp local, mcp server, run mcp, mcp docker, mcp tunnel, cloudflare tunnel, mcp logs.
+description: Run the FutureSearch HTTP MCP server locally with Docker Compose and optionally expose it via Cloudflare tunnel. Use when starting/stopping the local MCP server, debugging startup issues, connecting Claude.ai or Claude Desktop to a local instance, or checking server logs. Triggers on mcp local, mcp server, run mcp, mcp docker, mcp tunnel, cloudflare tunnel, mcp logs.
 ---
 
-# Running the everyrow MCP Server Locally
+# Running the FutureSearch MCP Server Locally
 
-Two-container stack: **mcp-server** (FastAPI on :8000) and **redis** (on :6379), orchestrated by `everyrow-mcp/deploy/docker-compose.yaml` with local overrides.
+Two-container stack: **mcp-server** (FastAPI on :8000) and **redis** (on :6379), orchestrated by `futuresearch-mcp/deploy/docker-compose.yaml` with local overrides.
 
 ## Pre-flight Checks
 
 **CRITICAL: Always check for stale processes on port 8000 before starting.**
 
-A leftover `everyrow-mcp --no-auth` or similar process on the host will shadow the Docker container's port binding. All requests hit the stale process instead of the container — this can look like auth routes are broken, sheets tools are missing, etc.
+A leftover `futuresearch-mcp --no-auth` or similar process on the host will shadow the Docker container's port binding. All requests hit the stale process instead of the container — this can look like auth routes are broken, sheets tools are missing, etc.
 
 ```bash
 # Check for anything on port 8000
@@ -29,7 +29,7 @@ docker info --format '{{.ServerVersion}}' || colima start
 ## Quick Start
 
 ```bash
-cd everyrow-mcp/deploy
+cd futuresearch-mcp/deploy
 
 REDIS_PASSWORD=testpass \
 MCP_SERVER_URL=http://localhost:8000 \
@@ -55,7 +55,7 @@ These are templated in `docker-compose.local.yaml` as `${VAR:-default}` — the
 
 ## Secrets
 
-The `.env` file at `everyrow-mcp/deploy/.env` contains production secrets (Supabase, API keys, upload secret). It is already present and should NOT be committed or overwritten.
+The `.env` file at `futuresearch-mcp/deploy/.env` contains production secrets (Supabase, API keys, upload secret). It is already present and should NOT be committed or overwritten.
 
 `REDIS_PASSWORD` is intentionally NOT in `.env` — always pass it as an env var (`testpass` for local dev).
 
@@ -64,8 +64,8 @@ The `.env` file at `everyrow-mcp/deploy/.env` contains production secrets (Supab
 The `.env` file is gitignored and won't exist in worktrees. Symlink it:
 
 ```bash
-ln -s /Users/rafaelpoyiadzi/Documents/git/everyrow-sdk/everyrow-mcp/deploy/.env \
-      <worktree-path>/everyrow-mcp/deploy/.env
+ln -s /Users/rafaelpoyiadzi/Documents/git/futuresearch-python/futuresearch-mcp/deploy/.env \
+      <worktree-path>/futuresearch-mcp/deploy/.env
 ```
 
 ## Exposing via Cloudflare Tunnel
@@ -95,7 +95,7 @@ This prints a URL like `https://something-something.trycloudflare.com`.
 The server must know its public URL for OAuth redirects to work:
 
 ```bash
-cd everyrow-mcp/deploy
+cd futuresearch-mcp/deploy
 
 REDIS_PASSWORD=testpass \
 MCP_SERVER_URL=https://something-something.trycloudflare.com \
@@ -128,10 +128,10 @@ Both should return JSON with `issuer`, `authorization_endpoint`, etc. If local r
 **Claude Code**: Add a project-scoped MCP server (writes to `.claude/settings.local.json` in the current dir, not the global config):
 
 ```bash
-claude mcp add everyrow --scope project --transport http <TUNNEL_URL>/mcp
+claude mcp add futuresearch --scope project --transport http <TUNNEL_URL>/mcp
 ```
 
-Then restart Claude Code. Remove with `claude mcp remove everyrow --scope project`.
+Then restart Claude Code. Remove with `claude mcp remove futuresearch --scope project`.
 
 ## Logs
 
@@ -149,7 +149,7 @@ docker logs deploy-mcp-server-1 2>&1 | grep "User-Agent"
 ## Teardown
 
 ```bash
-cd everyrow-mcp/deploy
+cd futuresearch-mcp/deploy
 
 REDIS_PASSWORD=testpass MCP_SERVER_URL=http://localhost:8000 \
   docker compose -f docker-compose.yaml -f docker-compose.local.yaml down
@@ -166,12 +166,12 @@ Run the server directly with `uv run` — no Docker needed. Useful for quick loc
 ### Prerequisites
 
 - Redis running on localhost:6379 (e.g. `docker run -d --name test-redis -p 6379:6379 redis:7-alpine`)
-- `EVERYROW_API_KEY` in `~/.claude/secrets/remote.env`
+- `FUTURESEARCH_API_KEY` (or legacy `FUTURESEARCH_API_KEY`) in `~/.claude/secrets/remote.env`
 
 ### Start the server
 
 ```bash
-cd everyrow-mcp
+cd futuresearch-mcp
 ALLOW_NO_AUTH=1 \
 UPLOAD_SECRET=$(python -c "import secrets; print(secrets.token_urlsafe(32))") \
 EXTRA_ALLOWED_HOSTS="host.docker.internal,localhost" \
@@ -195,8 +195,8 @@ Note: Direct mode won't work (CORS). Auth mode won't work (Inspector v0.21.0 doe
 
 ```bash
 uv run python scripts/mcp_call.py list
-uv run python scripts/mcp_call.py call everyrow_balance
-uv run python scripts/mcp_call.py call everyrow_agent '{"params": {"task": "...", "data": [...]}}'
+uv run python scripts/mcp_call.py call futuresearch_balance
+uv run python scripts/mcp_call.py call futuresearch_agent '{"params": {"task": "...", "data": [...]}}'
 ```
 
 Note: `mcp_call.py` only works against `--no-auth` servers. It doesn't do OAuth, so authenticated servers will show a subset of tools or fail.
@@ -214,7 +214,7 @@ Note: `mcp_call.py` only works against `--no-auth` servers. It doesn't do OAuth,
 | cloudflared output is empty | It writes to stderr: use `2>/tmp/cf-tunnel.log` redirect |
 | Container doesn't pick up code changes | Add `--build` to the `docker compose up` command |
 | Container doesn't pick up env var changes | Must recreate: `docker compose ... down && docker compose ... up -d` |
-| `.env` not found in worktree | Symlink from main repo: `ln -s <main>/everyrow-mcp/deploy/.env <worktree>/everyrow-mcp/deploy/.env` |
+| `.env` not found in worktree | Symlink from main repo: `ln -s <main>/futuresearch-mcp/deploy/.env <worktree>/futuresearch-mcp/deploy/.env` |
 | Sheets tools not showing in tool list | Pass `ENABLE_SHEETS_TOOLS=true` and recreate the container |
 | `mcp_call.py` shows fewer tools than expected | It connects without auth — authenticated servers may filter tools |
 | Docker daemon not running | `colima start` (may need `colima stop && colima start` if socket is stale) |
@@ -223,7 +223,7 @@ Note: `mcp_call.py` only works against `--no-auth` servers. It doesn't do OAuth,
 
 | File | Purpose |
 |------|---------|
-| `everyrow-mcp/deploy/docker-compose.yaml` | Base compose (server + redis) |
-| `everyrow-mcp/deploy/docker-compose.local.yaml` | Local overrides (ports, env passthrough) |
-| `everyrow-mcp/deploy/.env` | Production secrets (DO NOT commit changes) |
-| `everyrow-mcp/deploy/Dockerfile` | Server container build |
+| `futuresearch-mcp/deploy/docker-compose.yaml` | Base compose (server + redis) |
+| `futuresearch-mcp/deploy/docker-compose.local.yaml` | Local overrides (ports, env passthrough) |
+| `futuresearch-mcp/deploy/.env` | Production secrets (DO NOT commit changes) |
+| `futuresearch-mcp/deploy/Dockerfile` | Server container build |

.env.example

@@ -1,8 +1,12 @@
-# everyrow API Configuration
-# Required: Your API key for authenticating with the everyrow API
-EVERYROW_API_KEY=
+# FutureSearch API Configuration
+# Required: Your API key for authenticating with the FutureSearch API
+FUTURESEARCH_API_KEY=
 
 # Optional: API base URL (defaults to https://futuresearch.ai/api/v0/)
-# EVERYROW_API_URL=https://futuresearch.ai/api/v0/
+# FUTURESEARCH_API_URL=https://futuresearch.ai/api/v0/
 # Optional: App base URL (defaults to https://futuresearch.ai/)
-# EVERYROW_APP_URL=https://futuresearch.ai/
+# FUTURESEARCH_APP_URL=https://futuresearch.ai/
+
+# Legacy env vars (still supported for backwards compatibility):
+# EVERYROW_API_KEY=
+# EVERYROW_API_URL=

.github/workflows/ci.yaml

@@ -4,22 +4,22 @@ on:
   push:
     branches: ["main"]
     paths:
-      - "src/everyrow/**"
+      - "src/futuresearch/**"
       - "tests/**"
       - "examples/**"
       - "pyproject.toml"
       - "uv.lock"
       - ".github/workflows/ci.yaml"
-      - "everyrow-mcp/**"
+      - "futuresearch-mcp/**"
 
   pull_request:
     paths:
-      - "src/everyrow/**"
+      - "src/futuresearch/**"
       - "tests/**"
       - "examples/**"
       - "pyproject.toml"
       - "uv.lock"
-      - "everyrow-mcp/**"
+      - "futuresearch-mcp/**"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -59,7 +59,7 @@ jobs:
         run: uv run basedpyright
 
   mcp-checks:
-    name: everyrow-mcp
+    name: futuresearch-mcp
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -79,13 +79,13 @@ jobs:
           python-version: "3.12"
 
       - name: Install dependencies
-        run: uv sync --directory everyrow-mcp
+        run: uv sync --directory futuresearch-mcp
 
       - name: Check formatting
-        run: uv run --directory everyrow-mcp ruff format --check
+        run: uv run --directory futuresearch-mcp ruff format --check
 
       - name: Run ruff
-        run: uv run --directory everyrow-mcp ruff check
+        run: uv run --directory futuresearch-mcp ruff check
 
       - name: Run tests
-        run: uv run --directory everyrow-mcp pytest tests
+        run: uv run --directory futuresearch-mcp pytest tests

.github/workflows/deploy-mcp.yaml

@@ -22,7 +22,7 @@ on:
 env:
   GKE_ZONE: ${{ vars.BETA_CLUSTER_REGION }}
   GKE_NAME: ${{ vars.BETA_CLUSTER_NAME }}
-  MCP_IMAGE_NAME: ${{ vars.GCP_REGISTRY_NAME }}/${{ vars.GCP_PROJECT_NAME }}/delphos/everyrow-mcp
+  MCP_IMAGE_NAME: ${{ vars.GCP_REGISTRY_NAME }}/${{ vars.GCP_PROJECT_NAME }}/delphos/futuresearch-mcp
 
 permissions:
   contents: read
@@ -65,11 +65,11 @@ jobs:
         with:
           python-version: "3.12"
       - name: Install deps
-        run: uv sync --directory everyrow-mcp
+        run: uv sync --directory futuresearch-mcp
       - name: Run ruff
-        run: uv run --directory everyrow-mcp ruff check
+        run: uv run --directory futuresearch-mcp ruff check
       - name: Run tests
-        run: uv run --directory everyrow-mcp pytest tests
+        run: uv run --directory futuresearch-mcp pytest tests
 
   build-and-push:
     needs: [setup, checks]
@@ -105,7 +105,7 @@ jobs:
         uses: useblacksmith/build-push-action@v2
         with:
           context: .
-          file: everyrow-mcp/deploy/Dockerfile
+          file: futuresearch-mcp/deploy/Dockerfile
           push: true
           tags: ${{ steps.tags.outputs.tags }}
           platforms: linux/amd64
@@ -145,18 +145,18 @@ jobs:
 
       - name: Decrypt production secrets
         if: inputs.deploy_production == true
-        run: sops -d everyrow-mcp/deploy/chart/secrets.enc.yaml > everyrow-mcp/deploy/chart/values.secrets.yaml
+        run: sops -d futuresearch-mcp/deploy/chart/secrets.enc.yaml > futuresearch-mcp/deploy/chart/values.secrets.yaml
 
       - name: Decrypt staging secrets
         if: inputs.deploy_staging == true
-        run: sops -d everyrow-mcp/deploy/chart/secrets.staging.enc.yaml > everyrow-mcp/deploy/chart/values.secrets.staging.yaml
+        run: sops -d futuresearch-mcp/deploy/chart/secrets.staging.enc.yaml > futuresearch-mcp/deploy/chart/values.secrets.staging.yaml
 
       - name: Deploy to production
         if: inputs.deploy_production == true
-        working-directory: everyrow-mcp/deploy/chart
+        working-directory: futuresearch-mcp/deploy/chart
         run: |
-          helm upgrade --install everyrow-mcp . \
-            -n everyrow-mcp \
+          helm upgrade --install futuresearch-mcp . \
+            -n futuresearch-mcp \
             -f values.yaml \
             -f values.secrets.yaml \
             --set-string releaseId="${{ needs.setup.outputs.sha_short }}" \
@@ -167,10 +167,10 @@ jobs:
 
       - name: Deploy to staging
         if: inputs.deploy_staging == true
-        working-directory: everyrow-mcp/deploy/chart
+        working-directory: futuresearch-mcp/deploy/chart
         run: |
-          helm upgrade --install everyrow-mcp-staging . \
-            -n everyrow-mcp-staging \
+          helm upgrade --install futuresearch-mcp-staging . \
+            -n futuresearch-mcp-staging \
             -f values.yaml \
             -f values.staging.yaml \
             -f values.secrets.staging.yaml \