EdgeFinder

CLI and MCP server for EdgeFinder sports analysis. Get AI-powered NFL, NBA, and MLB betting recommendations, player stats, odds, schedules, and Polymarket portfolio tracking from your terminal or AI agent.

Requirements

• Node.js 18+
• EdgeFinder subscription (Starter $20/mo, Pro $50/mo, or Ultimate $150/mo)

Getting Started

# Install
npm install -g @edgefinder/cli

# Log in (opens magic link in your email)
edgefinder login

# Start asking questions
edgefinder ask "Who should I bet on tonight?"

edgefinder login will walk you through everything — enter your email, click the magic link, and if you don't have a subscription yet, it'll open the pricing page in your browser. Once you're set up, your API key is saved automatically.

To log out:

edgefinder logout

Security

The published CLI has no runtime npm dependencies and does not use dynamic code execution such as eval() or new Function().

The CLI stores saved API keys in ~/.edgefinder/config.json with user-only file permissions (0600) on Unix-like systems. You can remove the saved key at any time with:

edgefinder logout

For MCP integrations, prefer passing API keys with an Authorization: Bearer ... header. Query-string API keys are supported only for connector UIs that cannot set headers, because URLs may be recorded in browser history, proxies, or logs.

Please report suspected vulnerabilities through GitHub private vulnerability reporting rather than public issues. See SECURITY.md.

Manual Configuration

You can also set your API key directly if you already have one from chat.edgefinder.io/settings/integrations:

# Environment variable
export EDGEFINDER_API_KEY=ef_live_...

# Or save to config file (~/.edgefinder/config.json)
edgefinder config set api-key ef_live_...

CLI Usage

# AI-powered analysis
edgefinder ask "Who should I bet on tonight?"         # NFL (default)
edgefinder ask --nba "Lakers vs Celtics prediction"   # NBA
edgefinder ask --mlb "Yankees vs Red Sox prediction"  # MLB

# Schedules and scores
edgefinder schedule nfl
edgefinder schedule nba --date 2026-02-20

# Polymarket odds
edgefinder odds nfl --week 12
edgefinder odds nba

# Standings
edgefinder standings nba

# Portfolio tracking (requires connected Polymarket wallet)
edgefinder portfolio summary
edgefinder portfolio positions
edgefinder portfolio trades

# Account status
edgefinder status

All commands support --json for machine-readable output.

Interactive Mode

Run edgefinder without a subcommand to start an interactive session. Use /nfl, /nba, or /mlb to switch the active league before asking follow-up questions.

MCP Server

Use EdgeFinder as a tool in AI agents like Claude Desktop, Openclaw, or any MCP-compatible client.

EdgeFinder supports two MCP connection modes:

• Local stdio MCP: run by this CLI package with npx @edgefinder/cli mcp. Use this for desktop/local agent clients that can launch a command.
• Remote HTTP MCP: hosted by EdgeFinder at https://chat.edgefinder.io/api/mcp. Use this for URL-based connector UIs such as Grok or ChatGPT custom apps/connectors.

Local stdio setup

Add to your MCP client config:

{
  "mcpServers": {
    "edgefinder": {
      "command": "npx",
      "args": ["-y", "@edgefinder/cli", "mcp"],
      "env": {
        "EDGEFINDER_API_KEY": "ef_live_..."
      }
    }
  }
}

This mode reads credentials from EDGEFINDER_API_KEY, edgefinder login, or edgefinder config set api-key.

Remote HTTP setup

For clients that ask for an MCP server URL, use:

https://chat.edgefinder.io/api/mcp

Tool calls require an EdgeFinder API key. Prefer clients that support request headers:

Authorization: Bearer YOUR_EDGEFINDER_API_KEY

If a connector UI only accepts a URL and does not provide a way to set headers, use:

https://chat.edgefinder.io/api/mcp?api_key=YOUR_EDGEFINDER_API_KEY

Use the remote HTTP URL for Grok and ChatGPT because their connector flows connect to a hosted MCP server over HTTPS. The @edgefinder/cli package is still useful for local MCP clients, but it does not host a public URL by itself.

Available Tools

Tool	Description
ask	AI sports analysis for NFL, NBA, or MLB -- betting picks, player stats, matchups
get_schedule	Game schedules and scores
get_standings	League standings
get_odds	Polymarket betting odds
get_portfolio	Polymarket portfolio data (summary, positions, trades)
analyze_position	Analyze a portfolio position -- searches by team/title, runs AI analysis with hold/exit advice, entry assessment, or win/loss post-mortem
get_status	Account and subscription status

analyze_position is currently available in the local stdio MCP server. The hosted remote MCP endpoint currently exposes ask, get_schedule, get_standings, get_odds, get_portfolio, and get_status.

Codex Plugin

This repo is also a Codex Marketplace plugin. The manifest lives at .codex-plugin/plugin.json and bundles the EdgeFinder MCP server (.mcp.json) plus the edgefinder skill. The plugin reads credentials the same way the CLI does — edgefinder login, edgefinder config set api-key, or EDGEFINDER_API_KEY in the plugin environment.

OpenClaw Plugin

This repo also includes a local-installable OpenClaw plugin package in openclaw-plugin/.

Local install:

openclaw plugins install /absolute/path/to/openclaw-plugin

OpenClaw can also install it by package name:

openclaw plugins install @edgefinder/openclaw-plugin

License

MIT