installation.mdx

title	Install EveryRow: Python SDK, Claude Code Plugin, and MCP Server
description	Get started with everyrow. Install the Python SDK via pip, add the coding agent plugin for Claude Code, Gemini CLI, Codex, or Cursor, or configure the MCP server.

Installation

Get an API key at everyrow.io/api-key ($20 free credit included).

export EVERYROW_API_KEY=your_key_here

Select your platform and integration method below.

pip install everyrow

Requires Python 3.12+.

Quick example:

import asyncio
import pandas as pd
from everyrow.ops import screen
from pydantic import BaseModel, Field

companies = pd.DataFrame([
    {"company": "Airtable",}, {"company": "Vercel",}, {"company": "Notion",}
])

class JobScreenResult(BaseModel):
    qualifies: bool = Field(description="True if company lists jobs with all criteria")

async def main():
    result = await screen(
        task="""Qualifies if: 1. Remote-friendly, 2. Senior, and 3. Discloses salary""",
        input=companies,
        response_model=JobScreenResult,
    )
    print(result.data.head())

asyncio.run(main())

uv add everyrow

Requires Python 3.12+.

Quick example:

import asyncio
import pandas as pd
from everyrow.ops import screen
from pydantic import BaseModel, Field

companies = pd.DataFrame([
    {"company": "Airtable",}, {"company": "Vercel",}, {"company": "Notion",}
])

class JobScreenResult(BaseModel):
    qualifies: bool = Field(description="True if company lists jobs with all criteria")

async def main():
    result = await screen(
        task="""Qualifies if: 1. Remote-friendly, 2. Senior, and 3. Discloses salary""",
        input=companies,
        response_model=JobScreenResult,
    )
    print(result.data.head())

asyncio.run(main())

See the API Reference for full documentation.

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

You can optionally configure Claude Code to show a progress bar for long-running tasks.

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.

You can optionally configure Claude Code to show a progress bar for long-running tasks.

Official Claude Code Plugin Docs

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

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

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

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

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

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

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

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

Dependencies

The MCP server requires uv (if using uvx) or pip (if installed directly). The Python SDK requires Python 3.12+.

For the optional terminal progress bar, see the jq dependency in the progress monitoring guide.