README.md•3.34 kB
# NFL Transactions MCP
A Modular Command-line Program (MCP) for scraping NFL transaction data from ProSportsTransactions.com.
## Features
- Fetch NFL transactions with flexible filtering options:
- Player/Coach/Executive movement (trades, free agent signings, draft picks, etc.)
- Movements to/from injured reserve
- Movements to and from minor leagues (NFL Europe)
- Missed games due to injuries
- Missed games due to personal reasons
- Disciplinary actions (suspensions, fines, etc.)
- Legal/Criminal incidents
- Filter by team, player, date range, and transaction type
- Output data in CSV, JSON, or DataFrame format
- List all NFL teams and transaction types
## Installation
```bash
# Clone the repository
git clone <repository-url>
cd nfl_transactions_mcp
# Install requirements
pip install -r requirements.txt
```
## Usage with Cursor
To use this MCP with Cursor, add the following configuration to your `.cursor/mcp.json` file:
```json
{
"mcpServers": {
"nfl-transactions": {
"command": "python server.py",
"env": {}
}
}
}
```
### Running the MCP Directly
```bash
# Run the MCP server via Cursor
cursor run-mcp nfl-transactions
```
## Available Tools
### 1. fetch_transactions
Fetches NFL transactions based on specified filters.
**Parameters:**
- `start_date` (required): Start date in YYYY-MM-DD format
- `end_date` (required): End date in YYYY-MM-DD format
- `transaction_type` (optional, default: "All"): Type of transaction to filter
- `team` (optional): Team name
- `player` (optional): Player name
- `output_format` (optional, default: "json"): Output format (csv, json, or dataframe)
**Example:**
```json
{
"jsonrpc": "2.0",
"method": "fetch_transactions",
"params": {
"start_date": "2023-01-01",
"end_date": "2023-12-31",
"transaction_type": "Injury",
"team": "Patriots"
},
"id": 1
}
```
### 2. list_teams
Lists all NFL teams available for filtering.
**Example:**
```json
{
"jsonrpc": "2.0",
"method": "list_teams",
"id": 2
}
```
### 3. list_transaction_types
Lists all transaction types available for filtering.
**Example:**
```json
{
"jsonrpc": "2.0",
"method": "list_transaction_types",
"id": 3
}
```
## Integration with Super Agents
This MCP is designed to be easily integrated with AI agents or super agents. An agent can make JSON-RPC requests to interact with this MCP and retrieve NFL transaction data based on user queries.
Example agent integration:
```python
# Example of an agent calling the MCP
import json
import subprocess
def call_mcp(method, params=None):
request = {
"jsonrpc": "2.0",
"method": method,
"params": params or {},
"id": 1
}
# Call the MCP via cursor
cmd = ["cursor", "run-mcp", "nfl-transactions"]
proc = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True)
# Send the request and get the response
response, _ = proc.communicate(json.dumps(request))
return json.loads(response)
# Example: Get Patriots injury transactions from 2023
result = call_mcp("fetch_transactions", {
"start_date": "2023-01-01",
"end_date": "2023-12-31",
"transaction_type": "Injury",
"team": "Patriots"
})
print(f"Found {len(result['data'])} transactions")
```
## License
[MIT License](LICENSE)