> ## Documentation Index
> Fetch the complete documentation index at: https://edgefinder.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# EdgeFinder MCP Tool Reference: All 7 Tools Documented

> Parameter reference for all seven EdgeFinder MCP tools: ask, get_schedule, get_standings, get_odds, get_portfolio, analyze_position, and get_status.

The EdgeFinder MCP server registers seven tools that your AI agent can call during a conversation. Each tool maps to a specific capability: AI analysis, live sports data, Polymarket odds and portfolio management, and account information. This page documents every parameter for every tool so you know exactly what to pass and what to expect back.

## ask

Ask EdgeFinder for AI-powered sports analysis. This is the core tool — it accepts any question in plain English and returns a detailed response covering betting recommendations, player stats, matchup breakdowns, odds analysis, injury impact, and more for NFL, NBA, and MLB.

**Example questions:**

* "Who should I bet on in tonight's NBA games?"
* "Give me a breakdown of Chiefs vs Bills"
* "Which MLB pitchers have the best matchups this week?"

<ParamField body="question" type="string" required>
  Your sports analysis question in plain English. Ask about betting picks, player performance, matchup breakdowns, injury impact, odds movement, or any other sports topic.
</ParamField>

<ParamField body="league" type="string" default="nfl">
  Which league to analyze. Accepted values: `nfl`, `nba`, `mlb`. Defaults to `nfl` if omitted.
</ParamField>

***

## get\_schedule

Retrieve the current game schedule and scores for NFL or NBA. For NBA, you can target a specific date; for NFL, the tool returns the current week's schedule.

<ParamField body="league" type="string" required>
  Which league schedule to retrieve. Accepted values: `nfl`, `nba`.
</ParamField>

<ParamField body="date" type="string">
  NBA only. A specific date in `YYYY-MM-DD` format. Omit this parameter to get today's NBA games. This parameter has no effect when `league` is `nfl`.
</ParamField>

***

## get\_standings

Retrieve the current league standings for NFL or NBA, including win/loss records and ranking.

<ParamField body="league" type="string" required>
  Which league standings to retrieve. Accepted values: `nfl`, `nba`.
</ParamField>

***

## get\_odds

Retrieve Polymarket betting odds for NFL or NBA games. NFL odds can be scoped to a specific week; NBA odds can be scoped to a specific date.

<ParamField body="league" type="string" required>
  Which league odds to retrieve. Accepted values: `nfl`, `nba`.
</ParamField>

<ParamField body="week" type="number">
  NFL only. A specific NFL week number (e.g., `12`). Omit to get odds for the current week. This parameter has no effect when `league` is `nba`.
</ParamField>

<ParamField body="date" type="string">
  NBA only. A specific date in `YYYY-MM-DD` format. Omit to get odds for today's games. This parameter has no effect when `league` is `nfl`.
</ParamField>

***

## get\_portfolio

Retrieve your Polymarket portfolio data. You must have a Polymarket wallet connected to your EdgeFinder account for this tool to return data.

<Note>
  Connect your Polymarket wallet in the EdgeFinder web app at [chat.edgefinder.io](https://chat.edgefinder.io) before using portfolio tools. If no wallet is connected, the tool returns a `connected: false` response.
</Note>

<ParamField body="view" type="string" default="summary">
  Which portfolio view to retrieve. Accepted values:

  * `summary` — Account-level overview: total value, cash balance, P\&L, and position count.
  * `positions` — All currently open positions with size, average entry price, current price, and unrealized P\&L.
  * `trades` — Recent trade history (up to 50 trades) with side, size, price, and timestamp.
</ParamField>

<ParamField body="league" type="string" default="all">
  Filter results by league. Accepted values: `nfl`, `nba`, `all`. Defaults to `all`, which returns data across all leagues.
</ParamField>

***

## analyze\_position

Search your Polymarket portfolio for a specific position and run a full AI analysis on it. The tool searches open positions, trade history, or closed positions by title or team name, then generates detailed analysis with odds history, team stats, injury data, and a concrete recommendation.

Depending on which `view` you search:

* **open** — Provides a hold/exit recommendation with thesis check, hidden risk assessment, and current odds context.
* **trade** — Assesses your entry price against odds movement and evaluates whether the trade was well-reasoned.
* **closed** — Delivers a post-mortem with box score stats, odds arc, and an actionable takeaway for future bets.

<Warning>
  This tool requires a connected Polymarket wallet. It also uses your EdgeFinder query quota, since it calls the `ask` tool internally to generate the analysis.
</Warning>

<ParamField body="search" type="string" required>
  A search term to match against position titles or team names. The match is case-insensitive and partial — for example, `"Mavericks"` matches "Mavericks vs. Lakers", and `"Chiefs"` matches "Kansas City Chiefs vs. Buffalo Bills".
</ParamField>

<ParamField body="view" type="string" default="open">
  Which portfolio tab to search for the position. Accepted values:

  * `open` — Search currently open positions.
  * `trade` — Search recent trade history.
  * `closed` — Search resolved/closed positions.
</ParamField>

<ParamField body="league" type="string" default="all">
  Filter the search by league before matching. Accepted values: `nfl`, `nba`, `all`. Use a specific league to narrow results when you have positions across multiple sports.
</ParamField>

***

## get\_status

Check your EdgeFinder account status. Returns your active subscription plan, current query usage, access level, and trial information if applicable. Use this tool to confirm your account is active before running analysis or to check how many queries you have remaining.

This tool takes no parameters.

<Note>
  If `hasAccess` is `false` in the response, your subscription may have lapsed or your trial has ended. Visit [edgefinder.io/subscription](https://edgefinder.io/subscription) to manage your plan.
</Note>