Installation

Python SDK with uv

uv add everyrow

Requires Python 3.12+.

Quick example:

import everyrow

df = everyrow.research(
    "companies.csv",
    {"industry": "What industry is this company in?"}
)
df.to_csv("companies_enriched.csv")

See the API Reference for full documentation.

Claude Code with MCP

Add everyrow to your MCP config (requires uv):

{
  "mcpServers": {
    "everyrow": {
      "command": "uvx",
      "args": ["everyrow-mcp"],
      "env": {
        "EVERYROW_API_KEY": "${EVERYROW_API_KEY}"
      }
    }
  }
}

Or install with pip and use "command": "everyrow-mcp" instead of uvx.

Config file location:

• User scope: ~/.claude.json (in the mcpServers field)
• Project scope: .mcp.json in your project root

Choosing the right scope

Claude Code with Plugin

Install the everyrow plugin from the marketplace:

claude plugin marketplace add futuresearch/everyrow-sdk
claude plugin install everyrow@futuresearch

This installs both the skill and MCP server together. You can toggle each on/off in Claude Code settings.

Official Docs

Claude Desktop with MCP

Download the latest .mcpb bundle from GitHub Releases and double-click to install. You'll be prompted for your API key during setup.

Note: Works in Claude Desktop's Chat mode only (not Cowork mode due to a known limitation).

Manual installation:

Add to your MCP config (requires uv):

{
  "mcpServers": {
    "everyrow": {
      "command": "uvx",
      "args": ["everyrow-mcp"],
      "env": {
        "EVERYROW_API_KEY": "${EVERYROW_API_KEY}"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Codex with Skills

Ask Codex in natural language:

>>> codex
>>> Install the skill from github.com/futuresearch/everyrow-sdk found under skills/everyrow-sdk

Or install manually:

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.

Official Docs

Codex with MCP

Add everyrow to your Codex MCP config (requires uv):

[mcp_servers.everyrow]
command = "uvx"
args = ["everyrow-mcp"]

[mcp_servers.everyrow.env]
EVERYROW_API_KEY = "${EVERYROW_API_KEY}"

Or use the CLI:

codex mcp add everyrow --env EVERYROW_API_KEY=${EVERYROW_API_KEY} -- uvx everyrow-mcp

Config file location:

• User scope: ~/.codex/config.toml
• Project scope: .codex/config.toml

Official Docs

Gemini with Skills

Install the skill directly from GitHub:

gemini skills install https://github.com/futuresearch/everyrow-sdk --path skills/everyrow-sdk

Use --scope workspace to install to .gemini/skills/ (project-level) instead of ~/.gemini/skills/ (user-level).

Then enable skills within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable everyrow-sdk
/skills reload

Official Docs

Gemini with MCP

Add via CLI (requires uv):

gemini mcp add -e EVERYROW_API_KEY=$EVERYROW_API_KEY everyrow uvx everyrow-mcp

Or add manually to ~/.gemini/settings.json (user) or .gemini/settings.json (project):

{
  "mcpServers": {
    "everyrow": {
      "command": "uvx",
      "args": ["everyrow-mcp"],
      "env": {
        "EVERYROW_API_KEY": "$EVERYROW_API_KEY"
      }
    }
  }
}

Official Docs

Gemini with Plugin

This installs both the MCP server and skills together.

gemini extensions install https://github.com/futuresearch/everyrow-sdk --ref main

When prompted with Would you like to attempt to install via "git clone" instead?, type Y to confirm.

Then enable the extension:

gemini extensions enable everyrow [--scope <user or workspace>]

To use skills, enable them within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable everyrow-sdk
/skills reload
/model > Manual > gemini-3-pro-preview

Official Docs

Cursor with Skills

1. Open Cursor Settings → Rules
2. In the Project Rules section, click Add Rule
3. Select Remote Rule (Github)
4. Enter: https://github.com/futuresearch/everyrow-sdk.git

Official Docs

Cursor with MCP

Or add manually to your MCP config (requires uv):

{
  "mcpServers": {
    "everyrow": {
      "command": "uvx",
      "args": ["everyrow-mcp"],
      "env": {
        "EVERYROW_API_KEY": "${env:EVERYROW_API_KEY}"
      }
    }
  }
}

Config file location:

• macOS: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json