footballbin-mcp-server 1.0.0 → 1.0.2

package/README.md

@@ -1,126 +1,72 @@
 # FootballBin MCP Server
 
-A Model Context Protocol (MCP) server that provides AI agents with access to football match predictions for the Premier League and Champions League.
-
-## What is MCP?
+[![npm version](https://img.shields.io/npm/v/footballbin-mcp-server.svg)](https://www.npmjs.com/package/footballbin-mcp-server)
+[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-The [Model Context Protocol](https://modelcontextprotocol.io) (MCP) is an open protocol that enables AI agents to securely access external tools and data sources. This server implements MCP to expose football match predictions to any MCP-compatible AI client.
+A Model Context Protocol (MCP) server that provides AI agents with access to football match predictions for the Premier League and Champions League.
 
-## Features
+## Installation
 
-- **AI Match Predictions**: Get predictions for upcoming matches including:
-  - Half-time score
-  - Full-time score
-  - Next goal scorer
-  - Corner count predictions
+### Option 1: npm (Recommended)
 
-- **Supported Leagues**:
-  - Premier League (EPL)
-  - UEFA Champions League (UCL)
+```bash
+npm install -g footballbin-mcp-server
+```
 
-- **Key Players**: Each match includes key player insights with reasoning
+### Option 2: npx (No Install)
 
-## Live Endpoint
+```bash
+npx footballbin-mcp-server
+```
 
-The FootballBin MCP server is publicly available:
+### Option 3: Remote Endpoint
 
+No installation required - use the hosted endpoint directly:
 ```
 https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp
 ```
 
-No API key required.
-
-## Usage
+## Quick Start
 
-### Connect via Claude Desktop
+### Claude Desktop
 
-Add this to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+Add to your `claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
     "footballbin": {
-      "url": "https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp"
+      "command": "npx",
+      "args": ["footballbin-mcp-server"]
     }
   }
 }
 ```
 
-### Connect via Claude.ai
+**Config file location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Claude.ai (Remote)
 
 1. Go to **Settings > Connectors**
 2. Click **Add custom connector**
-3. Enter the endpoint URL
-4. Start asking about football predictions!
-
-### Direct API Usage
-
-#### List Available Tools
-
-```bash
-curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "method": "tools/list",
-    "id": 1
-  }'
-```
-
-#### Get Premier League Predictions
+3. Enter: `https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp`
 
-```bash
-curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "method": "tools/call",
-    "params": {
-      "name": "get_match_predictions",
-      "arguments": {
-        "league": "premier_league"
-      }
-    },
-    "id": 1
-  }'
-```
-
-#### Get Champions League Predictions
+## Features
 
-```bash
-curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "method": "tools/call",
-    "params": {
-      "name": "get_match_predictions",
-      "arguments": {
-        "league": "ucl"
-      }
-    },
-    "id": 1
-  }'
-```
+- **AI Match Predictions**:
+  - Half-time score
+  - Full-time score
+  - Next goal scorer
+  - Corner count predictions
 
-#### Filter by Team
+- **Supported Leagues**:
+  - Premier League (EPL)
+  - UEFA Champions League (UCL)
 
-```bash
-curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "method": "tools/call",
-    "params": {
-      "name": "get_match_predictions",
-      "arguments": {
-        "league": "epl",
-        "home_team": "liverpool"
-      }
-    },
-    "id": 1
-  }'
-```
+- **Key Players**: Each match includes key player insights with reasoning
 
 ## Tool: get_match_predictions
 
@@ -128,15 +74,13 @@ curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `league` | string | Yes | League identifier. Accepts: `premier_league`, `epl`, `pl`, `champions_league`, `ucl`, `cl` |
-| `matchweek` | number | No | Matchweek number (defaults to current matchweek) |
-| `home_team` | string | No | Filter by home team (e.g., `chelsea`, `arsenal`, `man_utd`) |
+| `league` | string | Yes | `premier_league`, `epl`, `pl`, `champions_league`, `ucl`, `cl` |
+| `matchweek` | number | No | Matchweek number (defaults to current) |
+| `home_team` | string | No | Filter by home team (e.g., `chelsea`, `arsenal`) |
 | `away_team` | string | No | Filter by away team (e.g., `liverpool`, `wolves`) |
 
 ### Team Aliases
 
-The API supports common team aliases:
-
 | Alias | Maps To |
 |-------|---------|
 | `united`, `mufc` | `man_utd` |
@@ -150,9 +94,8 @@ The API supports common team aliases:
 | `blues` | `chelsea` |
 | `barca` | `barcelona` |
 | `real` | `real_madrid` |
-| `bayern_munich` | `bayern` |
 
-### Response Format
+### Example Response
 
 ```json
 {
@@ -160,15 +103,12 @@ The API supports common team aliases:
   "matchweek": 22,
   "count": 10,
   "app_link": "https://apps.apple.com/app/footballbin/id6757111871",
-  "note": "Download FootballBin for live match tracking, player valuations, and detailed predictions.",
   "matches": [
     {
       "match_id": "epl_mw22_liv_bur",
       "home_team": "Liverpool",
       "away_team": "Burnley",
       "kickoff_time": "2026-01-17T15:00:00Z",
-      "kickoff_formatted": "Sat 17 Jan 15:00",
-      "countdown": "7d 3h",
       "status": "scheduled",
       "predictions": [
         { "type": "Half Time Result", "value": "2:0", "confidence": 75 },
@@ -178,14 +118,8 @@ The API supports common team aliases:
       ],
       "key_players": [
         {
-          "player_id": "florian_wirtz",
           "player_name": "Florian Wirtz",
-          "reason": "12 goals, 14 assists. Liverpool's creative hub with 89 form rating."
-        },
-        {
-          "player_id": "zian_flemming",
-          "player_name": "Zian Flemming",
-          "reason": "6 goals, 3 assists. Burnley's top scorer and set-piece specialist."
+          "reason": "12 goals, 14 assists. Liverpool's creative hub."
         }
       ]
     }
@@ -193,6 +127,38 @@ The API supports common team aliases:
 }
 ```
 
+## Direct API Usage
+
+### List Tools
+
+```bash
+curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
+```
+
+### Get Predictions
+
+```bash
+curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \
+  -H "Content-Type: application/json" \
+  -d '{
+    "jsonrpc": "2.0",
+    "method": "tools/call",
+    "params": {
+      "name": "get_match_predictions",
+      "arguments": {"league": "premier_league"}
+    },
+    "id": 1
+  }'
+```
+
+## Registry Links
+
+- **npm**: https://www.npmjs.com/package/footballbin-mcp-server
+- **Official MCP Registry**: https://registry.modelcontextprotocol.io
+- **GitHub**: https://github.com/billychl1/footballbin-mcp-server
+
 ## FootballBin App
 
 Get the full experience with the FootballBin iOS app:
@@ -204,68 +170,21 @@ Features:
 - AI player valuations
 - Detailed match predictions
 - Player news and discussions
-- Squad browsers for all major leagues
 
 ## Technical Details
 
-### Protocol
-
-- **Protocol**: JSON-RPC 2.0
-- **Transport**: HTTPS POST
-- **Content-Type**: application/json
-
-### Infrastructure
-
-- **Runtime**: AWS Lambda (Node.js 20.x)
-- **Database**: Amazon DynamoDB
-- **API Gateway**: AWS API Gateway
-- **Region**: eu-central-1 (Frankfurt)
+- **Protocol**: JSON-RPC 2.0 / MCP
+- **Transport**: stdio (npm) or HTTPS (remote)
+- **Runtime**: Node.js 20+
 
 ### Error Codes
 
 | Code | Meaning |
 |------|---------|
-| -32700 | Parse error (invalid JSON) |
+| -32700 | Parse error |
 | -32600 | Invalid request |
 | -32601 | Method not found |
 | -32602 | Invalid params |
-| -32603 | Internal error |
-
-## Self-Hosting
-
-If you want to deploy your own instance:
-
-### Prerequisites
-
-- Node.js 20+
-- AWS Account with DynamoDB access
-- AWS SAM CLI
-
-### Deploy
-
-```bash
-# Clone the repository
-git clone https://github.com/billychl1/footballbin-mcp-server.git
-cd footballbin-mcp-server
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Deploy with SAM
-sam deploy --guided
-```
-
-### Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `MATCHES_TABLE` | DynamoDB table for matches | `footballbin-matches-prod` |
-| `MATCHWEEKS_TABLE` | DynamoDB table for matchweeks | `footballbin-matchweeks-prod` |
-| `DEFAULT_REGION` | AWS region | `eu-central-1` |
-| `APP_STORE_LINK` | App Store URL | `https://apps.apple.com/app/footballbin/id6757111871` |
 
 ## License
 
@@ -275,4 +194,3 @@ MIT License - see [LICENSE](LICENSE) file.
 
 - [FootballBin App](https://apps.apple.com/app/footballbin/id6757111871)
 - [Model Context Protocol](https://modelcontextprotocol.io)
-- [MCP Specification](https://spec.modelcontextprotocol.io)

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "footballbin-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for FootballBin football match predictions - Premier League & Champions League",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "footballbin-mcp": "./dist/index.js"
+    "footballbin-mcp-server": "./dist/index.js"
   },
   "mcpName": "io.github.billychl1/footballbin-mcp-server",
   "scripts": {