scrumdo-mcp 0.1.0__tar.gz

scrumdo_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish scrumdo-mcp to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Dry run (build only, don't publish)"
+        type: boolean
+        default: true
+
+jobs:
+  build-and-publish:
+    name: Build and publish scrumdo-mcp
+    runs-on: ubuntu-latest
+
+    permissions:
+      id-token: write  # required for PyPI trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        if: ${{ github.event_name == 'release' || !inputs.dry_run }}
+        uses: pypa/gh-action-pypi-publish@release/v1

scrumdo_mcp-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+.env
+.env.local
+*.env
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.so

scrumdo_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ScrumDo LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

scrumdo_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: scrumdo-mcp
+Version: 0.1.0
+Summary: MCP server for ScrumDo boards — connect any AI tool directly to your board
+Project-URL: Homepage, https://www.scrumdo.com
+Project-URL: Documentation, https://github.com/ScrumDoLLC/scrumdo-mcp#readme
+Project-URL: Repository, https://github.com/ScrumDoLLC/scrumdo-mcp
+Project-URL: Bug Tracker, https://github.com/ScrumDoLLC/scrumdo-mcp/issues
+Author-email: ScrumDo LLC <support@scrumdo.com>
+License: MIT
+License-File: LICENSE
+Keywords: agile,ai,claude,cursor,kanban,llm,mcp,model-context-protocol,scrum,scrumdo,windsurf
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.3.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# scrumdo-mcp
+
+Connect any MCP-compatible AI tool (Claude Code, Cursor, Windsurf, and others) directly to your [ScrumDo](https://www.scrumdo.com) boards.
+
+Once installed, your AI assistant can read cards, move them, create tasks, post comments, and search across your board — without you copy-pasting anything.
+
+---
+
+## Installation
+
+```bash
+pip install scrumdo-mcp
+```
+
+> **Pre-release / before PyPI publish:** install directly from GitHub:
+> ```bash
+> pip install git+https://github.com/ScrumDoLLC/scrumdo-mcp.git
+> ```
+
+---
+
+## Cursor quick-start
+
+**1 — Install**
+```bash
+# To run the server only:
+pip install git+https://github.com/ScrumDoLLC/scrumdo-mcp.git
+
+# To run tests too:
+git clone https://github.com/ScrumDoLLC/scrumdo-mcp.git
+cd scrumdo-mcp
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+**2 — Get your token**
+
+Log in to ScrumDo → your org → **Settings → API Tokens → Create Token**. Copy it — shown once only.
+
+**3 — Add to `~/.cursor/mcp.json`**
+
+```json
+{
+  "mcpServers": {
+    "scrumdo": {
+      "command": "scrumdo-mcp",
+      "env": {
+        "SCRUMDO_TOKEN": "your-token-here",
+        "SCRUMDO_ORG": "your-org-slug",
+        "SCRUMDO_PROJECT": "your-default-project-slug"
+      }
+    }
+  }
+}
+```
+
+Your org and project slugs are the short names in your board URL:
+`app.scrumdo.com/`**`my-company`**`/`**`engineering`**
+
+**4 — Restart Cursor**
+
+Done. In any Cursor chat you can now ask:
+- *"What cards are in the current sprint?"*
+- *"Move ENG-42 to In Review"*
+- *"Add a comment to ENG-42: PR is up for review"*
+- *"List all cards assigned to me"*
+
+---
+
+## Setup
+
+### Step 1 — Get your token
+
+Log in to ScrumDo → your organization → **Settings → API Tokens → Create Token**.
+
+Copy the token — it is only shown once. This is your personal key; keep it private.
+
+### Step 2 — Configure your AI tool
+
+Find your tool's MCP config file and add the `scrumdo` server entry:
+
+| Tool | Config file |
+|------|-------------|
+| Claude Code | `~/.claude/claude.json` |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "scrumdo": {
+      "command": "scrumdo-mcp",
+      "env": {
+        "SCRUMDO_TOKEN": "your-token-here",
+        "SCRUMDO_ORG": "your-org-slug",
+        "SCRUMDO_PROJECT": "your-default-project-slug"
+      }
+    }
+  }
+}
+```
+
+Your org slug and project slug are the short names in your board URL:
+`app.scrumdo.com/`**`my-company`**`/`**`engineering`**
+
+### Step 3 — Restart your AI tool
+
+Done. Your AI assistant now has direct access to your board.
+
+---
+
+## What you can do
+
+Once connected, just talk to your AI tool naturally:
+
+```
+"What's the status of ENG-42?"
+"Move ENG-42 to In Review and add a comment saying the PR is up"
+"List all cards assigned to me in the current sprint"
+"Create a sub-task on ENG-42: write release notes"
+"Search for cards about the login bug"
+"What did the team work on this week?"
+```
+
+---
+
+## Available tools (41 total)
+
+| Group | Tools |
+|-------|-------|
+| **Boards** | `list_boards`, `get_board`, `get_board_cells`, `list_iterations`, `list_labels`, `list_epics` |
+| **Cards** | `list_cards`, `get_card`, `find_card`, `create_card`, `update_card`, `move_card`, `set_card_field`, `archive_card`, `assign_card`, `add_card_label`, `remove_card_label` |
+| **Tasks** | `list_tasks`, `create_task`, `complete_task`, `reopen_task`, `update_task`, `delete_task` |
+| **Comments** | `list_comments`, `add_comment`, `delete_comment` |
+| **Fields** | `list_custom_fields`, `get_card_field`, `get_all_card_fields` |
+| **Members** | `list_members`, `find_member` |
+| **Search** | `search_cards`, `search_by_field_value` |
+| **Activity** | `log_activity`, `get_activity_log`, `get_workspace_activity` |
+| **Webhooks** | `list_webhooks`, `create_webhook`, `delete_webhook` |
+| **Time** | `list_time_entries`, `log_time` |
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SCRUMDO_TOKEN` | — | **Required.** API token from Settings → API Tokens |
+| `SCRUMDO_BASE_URL` | `https://app.spryng.io` | API base URL |
+| `SCRUMDO_ORG` | — | Your organization slug |
+| `SCRUMDO_PROJECT` | — | Default project slug |
+
+---
+
+## Token scope
+
+Your API token is restricted to your organization's board data only — cards, tasks, comments, members, iterations. It cannot access billing, account settings, or any other organization's data. Revoke it at any time from Settings → API Tokens.
+
+---
+
+## What is MCP?
+
+[Model Context Protocol](https://modelcontextprotocol.io) is an open standard for connecting AI tools to external services. Claude Code, Cursor, Windsurf, and other AI editors support it natively. Install the server once; any MCP-compatible tool can use it.
+
+---
+
+## License
+
+MIT

scrumdo_mcp-0.1.0/README.md

@@ -0,0 +1,169 @@
+# scrumdo-mcp
+
+Connect any MCP-compatible AI tool (Claude Code, Cursor, Windsurf, and others) directly to your [ScrumDo](https://www.scrumdo.com) boards.
+
+Once installed, your AI assistant can read cards, move them, create tasks, post comments, and search across your board — without you copy-pasting anything.
+
+---
+
+## Installation
+
+```bash
+pip install scrumdo-mcp
+```
+
+> **Pre-release / before PyPI publish:** install directly from GitHub:
+> ```bash
+> pip install git+https://github.com/ScrumDoLLC/scrumdo-mcp.git
+> ```
+
+---
+
+## Cursor quick-start
+
+**1 — Install**
+```bash
+# To run the server only:
+pip install git+https://github.com/ScrumDoLLC/scrumdo-mcp.git
+
+# To run tests too:
+git clone https://github.com/ScrumDoLLC/scrumdo-mcp.git
+cd scrumdo-mcp
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+**2 — Get your token**
+
+Log in to ScrumDo → your org → **Settings → API Tokens → Create Token**. Copy it — shown once only.
+
+**3 — Add to `~/.cursor/mcp.json`**
+
+```json
+{
+  "mcpServers": {
+    "scrumdo": {
+      "command": "scrumdo-mcp",
+      "env": {
+        "SCRUMDO_TOKEN": "your-token-here",
+        "SCRUMDO_ORG": "your-org-slug",
+        "SCRUMDO_PROJECT": "your-default-project-slug"
+      }
+    }
+  }
+}
+```
+
+Your org and project slugs are the short names in your board URL:
+`app.scrumdo.com/`**`my-company`**`/`**`engineering`**
+
+**4 — Restart Cursor**
+
+Done. In any Cursor chat you can now ask:
+- *"What cards are in the current sprint?"*
+- *"Move ENG-42 to In Review"*
+- *"Add a comment to ENG-42: PR is up for review"*
+- *"List all cards assigned to me"*
+
+---
+
+## Setup
+
+### Step 1 — Get your token
+
+Log in to ScrumDo → your organization → **Settings → API Tokens → Create Token**.
+
+Copy the token — it is only shown once. This is your personal key; keep it private.
+
+### Step 2 — Configure your AI tool
+
+Find your tool's MCP config file and add the `scrumdo` server entry:
+
+| Tool | Config file |
+|------|-------------|
+| Claude Code | `~/.claude/claude.json` |
+| Cursor | `~/.cursor/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "scrumdo": {
+      "command": "scrumdo-mcp",
+      "env": {
+        "SCRUMDO_TOKEN": "your-token-here",
+        "SCRUMDO_ORG": "your-org-slug",
+        "SCRUMDO_PROJECT": "your-default-project-slug"
+      }
+    }
+  }
+}
+```
+
+Your org slug and project slug are the short names in your board URL:
+`app.scrumdo.com/`**`my-company`**`/`**`engineering`**
+
+### Step 3 — Restart your AI tool
+
+Done. Your AI assistant now has direct access to your board.
+
+---
+
+## What you can do
+
+Once connected, just talk to your AI tool naturally:
+
+```
+"What's the status of ENG-42?"
+"Move ENG-42 to In Review and add a comment saying the PR is up"
+"List all cards assigned to me in the current sprint"
+"Create a sub-task on ENG-42: write release notes"
+"Search for cards about the login bug"
+"What did the team work on this week?"
+```
+
+---
+
+## Available tools (41 total)
+
+| Group | Tools |
+|-------|-------|
+| **Boards** | `list_boards`, `get_board`, `get_board_cells`, `list_iterations`, `list_labels`, `list_epics` |
+| **Cards** | `list_cards`, `get_card`, `find_card`, `create_card`, `update_card`, `move_card`, `set_card_field`, `archive_card`, `assign_card`, `add_card_label`, `remove_card_label` |
+| **Tasks** | `list_tasks`, `create_task`, `complete_task`, `reopen_task`, `update_task`, `delete_task` |
+| **Comments** | `list_comments`, `add_comment`, `delete_comment` |
+| **Fields** | `list_custom_fields`, `get_card_field`, `get_all_card_fields` |
+| **Members** | `list_members`, `find_member` |
+| **Search** | `search_cards`, `search_by_field_value` |
+| **Activity** | `log_activity`, `get_activity_log`, `get_workspace_activity` |
+| **Webhooks** | `list_webhooks`, `create_webhook`, `delete_webhook` |
+| **Time** | `list_time_entries`, `log_time` |
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SCRUMDO_TOKEN` | — | **Required.** API token from Settings → API Tokens |
+| `SCRUMDO_BASE_URL` | `https://app.spryng.io` | API base URL |
+| `SCRUMDO_ORG` | — | Your organization slug |
+| `SCRUMDO_PROJECT` | — | Default project slug |
+
+---
+
+## Token scope
+
+Your API token is restricted to your organization's board data only — cards, tasks, comments, members, iterations. It cannot access billing, account settings, or any other organization's data. Revoke it at any time from Settings → API Tokens.
+
+---
+
+## What is MCP?
+
+[Model Context Protocol](https://modelcontextprotocol.io) is an open standard for connecting AI tools to external services. Claude Code, Cursor, Windsurf, and other AI editors support it natively. Install the server once; any MCP-compatible tool can use it.
+
+---
+
+## License
+
+MIT

scrumdo_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,77 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "scrumdo-mcp"
+version = "0.1.0"
+description = "MCP server for ScrumDo boards — connect any AI tool directly to your board"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [
+    { name = "ScrumDo LLC", email = "support@scrumdo.com" }
+]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "scrumdo",
+    "agile",
+    "scrum",
+    "kanban",
+    "ai",
+    "llm",
+    "claude",
+    "cursor",
+    "windsurf",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Office/Business :: Scheduling",
+]
+dependencies = [
+    "mcp[cli]>=1.3.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://www.scrumdo.com"
+Documentation = "https://github.com/ScrumDoLLC/scrumdo-mcp#readme"
+Repository = "https://github.com/ScrumDoLLC/scrumdo-mcp"
+"Bug Tracker" = "https://github.com/ScrumDoLLC/scrumdo-mcp/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "respx>=0.21",
+]
+
+[project.scripts]
+scrumdo-mcp = "spryng_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["spryng_mcp"]
+exclude = [
+    "tests/",
+    ".env*",
+]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    ".venv/",
+    "tests/",
+    ".env*",
+    "dist/",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

scrumdo_mcp-0.1.0/spryng_mcp/__init__.py

@@ -0,0 +1 @@
+"""spryng_mcp — MCP server for ScrumDo / Spryng boards."""