{"_id":"@dennisk2025/nba-latest-scores","name":"@dennisk2025/nba-latest-scores","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/nba-latest-scores","version":"1.0.0","description":"Fetches the latest NBA game scores, final or in-progress, including teams, scores, game status, and time remaining, using the free balldontlie public API.","type":"module","main":"index.js","bin":{"nba-latest-scores":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/nba-latest-scores@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-KW3e6Zj/iffASr/zLxIHFnZEZLLitJ4JME3VNFTi174GaEnSfeV+kmjWHqvnUUh5B/sNCtZeOClbI9Q/NTJ2Jw==","shasum":"a7ac97fdf86580a6b00f1aff141540d4ca753e5a","tarball":"https://registry.npmjs.org/@dennisk2025/nba-latest-scores/-/nba-latest-scores-1.0.0.tgz","fileCount":3,"unpackedSize":8348,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCekxFClmMpuBBbA6OgulgfBZBO7+ItX9jZZgU89uWuGQIhANICDujSvVzLk+2DislekR8Pj53AxCGR8RfY1d+f03G0"}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nba-latest-scores_1.0.0_1761426902218_0.9137274530649959"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:15:02.112Z","1.0.0":"2025-10-25T21:15:02.401Z","modified":"2025-10-25T21:15:02.697Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches the latest NBA game scores, final or in-progress, including teams, scores, game status, and time remaining, using the free balldontlie public API.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# NBA Latest Scores MCP Server\n\nFetches the latest NBA game scores (final or in-progress), including teams, scores, game status, and time remaining, using the free [balldontlie public API](https://www.balldontlie.io/).\n\n## Installation\n\nYou can install or run this MCP server via npm or npx:\n\n```\nnpm install @dennisk2025/nba-latest-scores\nyarn add @dennisk2025/nba-latest-scores\nnpx @dennisk2025/nba-latest-scores\n```\n\n## Adding to Claude Desktop\n\nTo use this MCP server in Claude Desktop, add the following entry to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"nba-scores\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/nba-latest-scores\"]\n    }\n  }\n}\n```\n\n**Add this JSON to your Claude Desktop config file at:**\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nRestart Claude Desktop after saving your changes.\n\n## Usage\n\nThis MCP server exposes one tool:\n\n### Tool: `get_latest_scores`\nFetch the latest NBA scores. You can optionally filter by date (YYYY-MM-DD).\n\n#### Parameters\n- `date` _(string, optional)_: ISO date string (YYYY-MM-DD) to fetch scores for a specific date. Defaults to today (Eastern Time) if not provided.\n\n#### Returns\nA JSON object with the date and an array of `games`. Each game has:\n- `id`: Game ID (number)\n- `date`: ISO date-time of the game\n- `status`: \"final\", \"in_progress\", or \"scheduled\" (other status strings possible)\n- `home_team`: Full home team name\n- `home_team_score`: Home team score\n- `visitor_team`: Full visitor team name\n- `visitor_team_score`: Visitor team score\n- `time_remaining`: If in progress, string like \"4:32 2nd\"; otherwise null\n\n#### Example Tool Calls\n\nGet today\\'s NBA scores:\n```\n{\n  \"tool_name\": \"get_latest_scores\",\n  \"parameters\": {}\n}\n```\n\nGet NBA scores for a specific date:\n```\n{\n  \"tool_name\": \"get_latest_scores\",\n  \"parameters\": {\n    \"date\": \"2024-03-21\"\n  }\n}\n```\n\n#### Example Result\n```\n{\n  \"date\": \"2024-03-21\",\n  \"games\": [\n    {\n      \"id\": 14654,\n      \"date\": \"2024-03-21T23:00:00.000Z\",\n      \"status\": \"final\",\n      \"home_team\": \"Miami Heat\",\n      \"home_team_score\": 99,\n      \"visitor_team\": \"Boston Celtics\",\n      \"visitor_team_score\": 105,\n      \"time_remaining\": null\n    },\n    ...\n  ]\n}\n```\n\n## List of Available Tools\n\n### `get_latest_scores`\n- **Description:** Retrieves a list of the most recent NBA games played, including home and visitor team names, scores, game status (final, in progress), and time left if applicable. Optionally filter by date (YYYY-MM-DD).\n- **Input:**\n  - `date` (string, optional): ISO date string (YYYY-MM-DD) to fetch scores for a specific date. Defaults to today if not provided.\n- **Output:** An object containing the date and an array of game objects as outlined above.\n\n---\n\nNBA data provided by the free [balldontlie.io API](https://www.balldontlie.io/).\n","readmeFilename":"README.md","_rev":"1-488896ab2e0cb2c81023a310687b05ff"}