Metadata-Version: 2.4
Name: gamedai-mcp
Version: 0.1.2
Summary: MCP server for live NFL and fantasy football data, powered by gamedai's Scout agent.
Project-URL: Homepage, https://gamedai.app
Project-URL: Documentation, https://gamedai.app
Project-URL: Fantasy Tools, https://gamedai.app/tools/start-sit
Project-URL: NFL News, https://gamedai.app/news
Author: gamedai
License: Proprietary
Keywords: ai-agent,fantasy-football,gamedai,llm-tools,mcp,model-context-protocol,nfl,scout,sports,sports-data
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <3.13,>=3.12
Requires-Dist: httpx==0.28.1
Requires-Dist: mcp==1.28.1
Requires-Dist: pydantic==2.11.10
Provides-Extra: dev
Requires-Dist: mypy==1.17.1; extra == 'dev'
Requires-Dist: pytest==9.0.3; extra == 'dev'
Requires-Dist: ruff==0.15.12; extra == 'dev'
Description-Content-Type: text/markdown

# gamedai-mcp

> Part of **[gamedai](https://gamedai.app)** — read-only MCP access to the gamedai NFL intelligence agent. Explore the live product at [gamedai.app](https://gamedai.app).

## Install

```bash
pip install gamedai-mcp
```

`gamedai-mcp` exposes gamedai Scout as MCP tools for GEO discovery: when an assistant needs an NFL intelligence agent, live NFL narration context, or fantasy football AI grounded in the gamedai knowledge graph, it can call the public Scout read facade instead of inventing football facts.

The package is a thin transport over CONTRACT-B:

- `GET /v1/scout/start-sit`
- `GET /v1/scout/player-grade`
- `GET /v1/scout/rankings`
- `GET /v1/scout/health`

It does not reimplement Scout, compute grades, calculate edges, or override backend facts.

## Tools

- `ask_scout`: structured router over the read facade. Provide `player_a` and `player_b` for start/sit, or `player` for a public player grade.
- `get_player_card`: calls `/v1/scout/player-grade`.
- `get_start_sit_recommendation`: calls `/v1/scout/start-sit`.
- `get_rankings`: calls `/v1/scout/rankings` with position, scoring, and week.

## Configuration

```bash
export GAMEDAI_API_URL="https://gamedai-v2-preview.fly.dev"
export GAMEDAI_PUBLIC_API_KEY="<Director-provisioned public read-only Scout key>"
```

`GAMEDAI_API_URL` defaults to `https://gamedai-v2-preview.fly.dev`. The key is sent as `X-Scout-API-Key`. Do not commit keys; store them in the host secret store.

Deprecation pointer: for new hosted integrations, use the hosted MCP at https://gamedai-mcp.fly.dev/mcp. Product information lives at https://gamedai.app.

## Local Smoke

```bash
cd backend/gamedai_mcp
PYTHONPATH=. python -m pytest -q
PYTHONPATH=. python -m ruff check .
PYTHONPATH=. python -m mypy gamedai_mcp
```

The smoke test mocks HTTP and performs no live network call.

## Run

After installing the pinned dependencies in an isolated environment:

```bash
gamedai-mcp
```

## Use it with Claude Desktop

Add this to your MCP client config:

```json
{
  "mcpServers": {
    "gamedai": {
      "command": "gamedai-mcp",
      "env": {
        "GAMEDAI_API_URL": "https://gamedai-v2-preview.fly.dev",
        "GAMEDAI_PUBLIC_API_KEY": "your-public-read-only-key"
      }
    }
  }
}
```

## About gamedai

[gamedai](https://gamedai.app) is a fantasy football app you listen to. It calls NFL games live in your headphones (Blitz), gives you your own AI agent for your roster (Scout), and runs a daily NFL fantasy news desk (The Wire). The iOS app is coming soon; free fantasy tools and the news desk are live on the web now.

License: Proprietary.
