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

# 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:

{
  "mcpServers": {
    "nfl-transactions": {
      "command": "python server.py",
      "env": {}
    }
  }
}

Running the MCP Directly

# 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:

{
  "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:

{
  "jsonrpc": "2.0",
  "method": "list_teams",
  "id": 2
}

3. list_transaction_types

Lists all transaction types available for filtering.

Example:

{
  "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:

# 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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A Modular Command-line Program for fetching and filtering NFL transaction data, including player movements, injuries, disciplinary actions, and more from ProSportsTransactions.com.

Related MCP Servers

Soccer MCP Server
obinopaul
-
security
F
license
-
quality
Provides programmatic access to comprehensive football statistics and live match data via API-Football, enabling applications to retrieve league standings, team fixtures, player statistics, and real-time match events.
Last updated -
3
Python
NHL MCP Server
dylangroos
-
security
F
license
-
quality
Provides structured access to NHL data including teams, players, standings, schedules, and statistics through the Model-Context Protocol pattern.
Last updated -
5
TypeScript
balldontlie-mcp
mikechao
A
security
A
license
A
quality
An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.
Last updated -
4
2,726
10
JavaScript
MIT License
Video Metadata MCP Server
stich-studios
-
security
F
license
-
quality
Manages sports video metadata with CRUD operations for game information, teams, scores, and statistics. Enables advanced search filtering by game type, teams, league, season, and date ranges through PostgreSQL integration.
Last updated -
JavaScript

View all related MCP servers

NFL Transactions MCP