devrev-Python-SDK 3.0.3__py3-none-any.whl → 3.1.1__py3-none-any.whl

devrev_mcp/server.py

@@ -249,6 +249,7 @@ from devrev_mcp.tools import slas as _slas_tools  # noqa: E402, F401
 from devrev_mcp.tools import tags as _tags_tools  # noqa: E402, F401
 from devrev_mcp.tools import timeline as _timeline_tools  # noqa: E402, F401
 from devrev_mcp.tools import users as _users_tools  # noqa: E402, F401
+from devrev_mcp.tools import webhooks as _webhooks_tools  # noqa: E402, F401
 from devrev_mcp.tools import works as _works_tools  # noqa: E402, F401
 
 # Beta tools (only if beta tools are enabled)

devrev_mcp/tools/webhooks.py

@@ -0,0 +1,153 @@
+"""MCP tools for DevRev webhook operations."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from mcp.server.fastmcp import Context
+
+from devrev.exceptions import DevRevError
+from devrev.models.webhooks import (
+    WebhooksCreateRequest,
+    WebhooksDeleteRequest,
+    WebhooksGetRequest,
+    WebhooksListRequest,
+    WebhookStatus,
+    WebhooksUpdateRequest,
+)
+from devrev_mcp.server import _config, mcp
+from devrev_mcp.utils.don_id import validate_don_id
+from devrev_mcp.utils.errors import format_devrev_error
+from devrev_mcp.utils.formatting import serialize_model, serialize_models
+from devrev_mcp.utils.pagination import clamp_page_size
+
+logger = logging.getLogger(__name__)
+
+
+@mcp.tool()
+async def devrev_webhooks_list(
+    ctx: Context[Any, Any, Any],
+    cursor: str | None = None,
+    limit: int | None = None,
+) -> dict[str, Any]:
+    """List DevRev webhooks.
+
+    Args:
+        cursor: Pagination cursor from a previous response.
+        limit: Maximum number of items to return (default: 25, max: 100).
+    """
+    app = ctx.request_context.lifespan_context
+    try:
+        request = WebhooksListRequest(
+            cursor=cursor,
+            limit=clamp_page_size(
+                limit, default=app.config.default_page_size, maximum=app.config.max_page_size
+            ),
+        )
+        webhooks = await app.get_client().webhooks.list(request)
+        items = serialize_models(list(webhooks))
+        return {"count": len(items), "webhooks": items}
+    except DevRevError as e:
+        raise RuntimeError(format_devrev_error(e)) from e
+
+
+@mcp.tool()
+async def devrev_webhooks_get(
+    ctx: Context[Any, Any, Any],
+    id: str,
+) -> dict[str, Any]:
+    """Get a DevRev webhook by ID.
+
+    Args:
+        id: Webhook ID (e.g., "don:integration:dvrv-us-1:devo/1:webhook/123").
+    """
+    validate_don_id(id, "webhook", "devrev_webhooks_get")
+    app = ctx.request_context.lifespan_context
+    try:
+        request = WebhooksGetRequest(id=id)
+        webhook = await app.get_client().webhooks.get(request)
+        return serialize_model(webhook)
+    except DevRevError as e:
+        raise RuntimeError(format_devrev_error(e)) from e
+
+
+# Destructive tools (only registered when enabled)
+if _config.enable_destructive_tools:
+
+    @mcp.tool()
+    async def devrev_webhooks_create(
+        ctx: Context[Any, Any, Any],
+        url: str,
+        event_types: list[str] | None = None,
+        secret: str | None = None,
+    ) -> dict[str, Any]:
+        """Create a new DevRev webhook.
+
+        Args:
+            url: Target URL that will receive webhook event POSTs.
+            event_types: Event types to subscribe to (default: all events).
+            secret: Shared secret used to sign and verify webhook payloads.
+        """
+        app = ctx.request_context.lifespan_context
+        try:
+            request = WebhooksCreateRequest(url=url, event_types=event_types, secret=secret)
+            webhook = await app.get_client().webhooks.create(request)
+            return serialize_model(webhook)
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e
+
+    @mcp.tool()
+    async def devrev_webhooks_update(
+        ctx: Context[Any, Any, Any],
+        id: str,
+        url: str | None = None,
+        event_types: list[str] | None = None,
+        status: str | None = None,
+    ) -> dict[str, Any]:
+        """Update a DevRev webhook.
+
+        Args:
+            id: Webhook ID to update.
+            url: New target URL.
+            event_types: New list of event types to subscribe to.
+            status: New status (active, inactive, unverified).
+        """
+        validate_don_id(id, "webhook", "devrev_webhooks_update")
+        app = ctx.request_context.lifespan_context
+        try:
+            resolved_status: WebhookStatus | None = None
+            if status is not None:
+                try:
+                    resolved_status = WebhookStatus(status.lower())
+                except ValueError as e:
+                    raise RuntimeError(
+                        f"Invalid webhook status '{status}'. "
+                        "Valid values: active, inactive, unverified."
+                    ) from e
+            request = WebhooksUpdateRequest(
+                id=id, url=url, event_types=event_types, status=resolved_status
+            )
+            webhook = await app.get_client().webhooks.update(request)
+            return serialize_model(webhook)
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e
+
+    @mcp.tool()
+    async def devrev_webhooks_delete(
+        ctx: Context[Any, Any, Any],
+        id: str,
+    ) -> dict[str, Any]:
+        """Delete a DevRev webhook.
+
+        Args:
+            id: Webhook ID to delete.
+        """
+        validate_don_id(id, "webhook", "devrev_webhooks_delete")
+        app = ctx.request_context.lifespan_context
+        try:
+            request = WebhooksDeleteRequest(id=id)
+            await app.get_client().webhooks.delete(request)
+            return {"deleted": True, "id": id}
+        except DevRevError as e:
+            raise RuntimeError(format_devrev_error(e)) from e

devrev_mcp/utils/don_id.py

@@ -35,6 +35,7 @@ DON_TYPE_MAP: dict[str, str] = {
     "qa": "question_answer",
     "question_answer": "question_answer",
     "timeline_entry": "timeline_entry",
+    "webhook": "webhook",
 }
 
 TOOL_SUGGESTIONS: dict[str, str] = {
@@ -57,6 +58,7 @@ TOOL_SUGGESTIONS: dict[str, str] = {
     "qa": "devrev_question_answers_get",
     "question_answer": "devrev_question_answers_get",
     "timeline_entry": "devrev_timeline_get",
+    "webhook": "devrev_webhooks_get",
 }
 
 

{devrev_python_sdk-3.0.3.dist-info → devrev_python_sdk-3.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devrev-Python-SDK
-Version: 3.0.3
+Version: 3.1.1
 Summary: A modern, type-safe Python SDK for the DevRev API
 Project-URL: Homepage, https://github.com/mgmonteleone/py-dev-rev
 Project-URL: Documentation, https://github.com/mgmonteleone/py-dev-rev
@@ -75,7 +75,7 @@ Description-Content-Type: text/markdown
 
 # py-devrev
 
-A modern, type-safe Python SDK for the DevRev API.
+A modern, type-safe Python SDK and MCP for the DevRev API.
 
 [![Built with Augment](https://img.shields.io/badge/Built%20with-Auggie-6366f1?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0xMiAyTDIgMTloMjBMMTIgMnptMCAzLjc1TDE4LjI1IDE3SDUuNzVMMTIgNS43NXoiLz48L3N2Zz4=)](https://www.augmentcode.com/)
 [![PyPI Version](https://img.shields.io/pypi/v/devrev-python-sdk.svg)](https://pypi.org/project/devrev-Python-SDK/)
@@ -159,7 +159,7 @@ This SDK is generated and maintained from the official DevRev OpenAPI specificat
 
 ### MCP Server (AI Integration)
 
-- ✅ **78+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, and all DevRev resources
+- ✅ **83+ MCP Tools** — Full CRUD for tickets, accounts, users, articles, webhooks, and all DevRev resources
 - ✅ **7 Resource Templates** — `devrev://` URI scheme for AI-accessible data browsing
 - ✅ **8 Workflow Prompts** — Pre-built triage, escalation, investigation, and reporting workflows
 - ✅ **3 Transport Modes** — stdio (local), Streamable HTTP (production), SSE (legacy)
@@ -725,7 +725,7 @@ The DevRev MCP Server exposes the full DevRev platform as [Model Context Protoco
 
 ### MCP Server Features
 
-- **78+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, plus beta tools (search, recommendations, incidents, engagements)
+- **83+ MCP Tools** — Full CRUD for tickets, accounts, users, conversations, articles, parts, tags, groups, timeline, links, SLAs, webhooks, plus beta tools (search, recommendations, incidents, engagements)
 - **7 Resource Templates** — `devrev://` URI scheme for browsing tickets, accounts, articles, users, parts, conversations
 - **8 Workflow Prompts** — Triage, draft response, escalate, summarize account, investigate, weekly report, find similar, onboard customer
 - **3 Transports** — stdio (local dev), Streamable HTTP (production), SSE (legacy)

{devrev_python_sdk-3.0.3.dist-info → devrev_python_sdk-3.1.1.dist-info}/RECORD

@@ -73,7 +73,7 @@ devrev/utils/pagination.py,sha256=zsAZdGw2eGs2p5XEFX-Dng3zjsP-ERsUqQn7PWmI9Oc,48
 devrev_mcp/__init__.py,sha256=-VAlWWe5rx2UqfOUK8L2Evr28FEfapEmMKgYpCbVxjQ,216
 devrev_mcp/__main__.py,sha256=PfuBYR0I4yIj1CqTikFBcqB_TNo34R1I5_8bv0D2ekc,1521
 devrev_mcp/config.py,sha256=4GllGfYM6k7OixEKfR9JH_TE1F7LFeCbDo1bLEC9ACA,4002
-devrev_mcp/server.py,sha256=ZI0ZzMkcv8Ug-F7Ez1wLI2slJ2e3KyHZhxYtyW1eaGg,18597
+devrev_mcp/server.py,sha256=4Zhkom-2LQ0qo91o70Uif9U0uSqwFAZ9Xip74ihhmxw,18674
 devrev_mcp/middleware/__init__.py,sha256=QphqWGURVzKXWJ0oLJ5Qub6V33z5YyQwN5r6Gue6hd8,52
 devrev_mcp/middleware/audit.py,sha256=PRnyNCobXSJnSqVh4Z5K8b7jauNOTMSiMEIjKcd1s2A,13459
 devrev_mcp/middleware/auth.py,sha256=wgdYZEWxBIAj7XAc8c95ct9aZ1aUQ6s29SiWuUW6IiU,16214
@@ -111,13 +111,14 @@ devrev_mcp/tools/slas.py,sha256=q7eYC7nMxCGoHMDp1QbtCgSWiG4oHk78sydPtYwsh10,4902
 devrev_mcp/tools/tags.py,sha256=zj_my9CkPQu8_TTOqszfLULPNgxm83kHux-rWFxHvXQ,4711
 devrev_mcp/tools/timeline.py,sha256=p7P699Oq205jrzCVyYS6v4bXHEQizircHVyS5JE-GJ4,5326
 devrev_mcp/tools/users.py,sha256=7CtrxjgxniEb5-DaPh0rwL680a2fDFLJSIU5huuTjYE,4896
+devrev_mcp/tools/webhooks.py,sha256=UdoKxZprZygVopqYYf02RF84HVCL-gJBpTNm0jrw_QI,5166
 devrev_mcp/tools/works.py,sha256=IFaIXYR4j_2pZ39ykZgdHdo5nCk8OfgWU5bxBdHwp5E,15241
 devrev_mcp/utils/__init__.py,sha256=2_5b1KC5kjoUqFY1ZSdB2Tefd2ekjbZ-eHyFWBKI-0A,49
-devrev_mcp/utils/don_id.py,sha256=PAVzOSgaiqJQSdo1fwohFHq2x7PDNUZoBTN4LFGYM48,6294
+devrev_mcp/utils/don_id.py,sha256=jbVKXW_BeKjPHhz1F9p14fNmrXP2R36rgWZqdC4QlOc,6358
 devrev_mcp/utils/errors.py,sha256=5mRAo76rJvvEVi6b1ZokPxDtX5JKkptaqmiYDLCkwBE,2110
 devrev_mcp/utils/formatting.py,sha256=6JssG5x1BxjdgSiQ8Ou3H-9Wo3wgWTWmejsrGez4wKc,2431
 devrev_mcp/utils/pagination.py,sha256=EOUgL-ZdSToM1Q-ydXmjhibsef5K1u1g3CaS9K8I2fY,1286
-devrev_python_sdk-3.0.3.dist-info/METADATA,sha256=asQmpRbwB4KZCymgX1FRAS7d-r0TxUQMLkSELz3PmRU,40906
-devrev_python_sdk-3.0.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-devrev_python_sdk-3.0.3.dist-info/entry_points.txt,sha256=XiV4J_yy0yzVZVxg7T66YERVIlqdPNp3O-NHTHkllqQ,63
-devrev_python_sdk-3.0.3.dist-info/RECORD,,
+devrev_python_sdk-3.1.1.dist-info/METADATA,sha256=KuDpsWwhLZQ-048S8B7FchJkkjP1ATp3a2upRwVfxJM,40934
+devrev_python_sdk-3.1.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+devrev_python_sdk-3.1.1.dist-info/entry_points.txt,sha256=XiV4J_yy0yzVZVxg7T66YERVIlqdPNp3O-NHTHkllqQ,63
+devrev_python_sdk-3.1.1.dist-info/RECORD,,

{devrev_python_sdk-3.0.3.dist-info → devrev_python_sdk-3.1.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.29.0
+Generator: hatchling 1.30.1
 Root-Is-Purelib: true
 Tag: py3-none-any