sendflo-mcp 0.1.0__tar.gz

sendflo_mcp-0.1.0/.gitignore

@@ -0,0 +1,34 @@
+# Virtual environment
+.venv/
+
+# Environment variables — never commit this
+.env*
+
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Database — don't commit local DB
+*.db
+*.sqlite
+
+# VS Code settings
+.vscode/
+
+# Anaconda
+.conda/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Local documents — not tracked in git
+docs/
+
+# Local test scripts
+backend/test_*.py
+
+#claude
+.claude

sendflo_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: sendflo-mcp
+Version: 0.1.0
+Summary: Use Sendflo from Claude Desktop — manage campaigns, contacts, and segments with natural language
+Project-URL: Homepage, https://sendflo.io
+Project-URL: Repository, https://github.com/rahulxj100/whatsapp
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.9.0
+Description-Content-Type: text/markdown
+
+# sendflo-mcp
+
+Use [Sendflo](https://sendflo.io) from Claude Desktop. Manage campaigns, contacts, and segments with natural language.
+
+## Setup
+
+**1. Get your Sendflo API key**
+
+Sendflo dashboard → Settings → API Keys → Create
+
+**2. Add to Claude Desktop config**
+
+Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sendflo": {
+      "command": "uvx",
+      "args": ["sendflo-mcp"],
+      "env": {
+        "SENDFLO_API_KEY": "sk_sf_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**3. Restart Claude Desktop**
+
+The Sendflo tools appear under the 🔨 icon in chat.
+
+## Example prompts
+
+- "List my VIP contacts"
+- "Create an email campaign for the Diwali sale"
+- "Generate a friendly email about 50% off"
+- "What are my analytics?"
+- "Send campaign 42"
+
+## Requirements
+
+- Claude Desktop (claude.ai/download)
+- `uvx` — install via `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- Sendflo account with API key

sendflo_mcp-0.1.0/README.md

@@ -0,0 +1,46 @@
+# sendflo-mcp
+
+Use [Sendflo](https://sendflo.io) from Claude Desktop. Manage campaigns, contacts, and segments with natural language.
+
+## Setup
+
+**1. Get your Sendflo API key**
+
+Sendflo dashboard → Settings → API Keys → Create
+
+**2. Add to Claude Desktop config**
+
+Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sendflo": {
+      "command": "uvx",
+      "args": ["sendflo-mcp"],
+      "env": {
+        "SENDFLO_API_KEY": "sk_sf_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**3. Restart Claude Desktop**
+
+The Sendflo tools appear under the 🔨 icon in chat.
+
+## Example prompts
+
+- "List my VIP contacts"
+- "Create an email campaign for the Diwali sale"
+- "Generate a friendly email about 50% off"
+- "What are my analytics?"
+- "Send campaign 42"
+
+## Requirements
+
+- Claude Desktop (claude.ai/download)
+- `uvx` — install via `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- Sendflo account with API key

sendflo_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sendflo-mcp"
+version = "0.1.0"
+description = "Use Sendflo from Claude Desktop — manage campaigns, contacts, and segments with natural language"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = [
+    "mcp[cli]>=1.9.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+sendflo-mcp = "sendflo_mcp.server:main"
+
+[project.urls]
+Homepage = "https://sendflo.io"
+Repository = "https://github.com/rahulxj100/whatsapp"

sendflo_mcp-0.1.0/src/sendflo_mcp/server.py

@@ -0,0 +1,158 @@
+from __future__ import annotations
+
+import os
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API_KEY = os.environ["SENDFLO_API_KEY"]
+BASE_URL = os.environ.get("SENDFLO_BASE_URL", "https://api.sendflo.io")
+
+mcp = FastMCP("sendflo")
+
+client = httpx.AsyncClient(
+    base_url=BASE_URL,
+    headers={"Authorization": f"Bearer {API_KEY}"},
+    timeout=30.0,
+)
+
+
+async def _get(path: str, params: dict | None = None) -> dict | list:
+    try:
+        r = await client.get(path, params=params)
+        r.raise_for_status()
+        return r.json()
+    except httpx.HTTPStatusError as e:
+        return {"error": f"{e.response.status_code}: {e.response.text}"}
+    except httpx.RequestError as e:
+        return {"error": f"Network error: {e}"}
+
+
+async def _post(path: str, body: dict | None = None) -> dict | list:
+    try:
+        r = await client.post(path, json=body)
+        r.raise_for_status()
+        return r.json()
+    except httpx.HTTPStatusError as e:
+        return {"error": f"{e.response.status_code}: {e.response.text}"}
+    except httpx.RequestError as e:
+        return {"error": f"Network error: {e}"}
+
+
+@mcp.tool()
+async def list_contacts(tag: str | None = None, limit: int = 50) -> list:
+    """List contacts. Optionally filter by tag."""
+    params: dict = {"limit": limit}
+    if tag:
+        params["tag"] = tag
+    return await _get("/contacts", params=params)
+
+
+@mcp.tool()
+async def create_contact(
+    name: str,
+    phone: str,
+    email: str | None = None,
+    tags: list[str] | None = None,
+) -> dict:
+    """Create a new contact."""
+    return await _post("/contacts", {
+        "name": name,
+        "phone": phone,
+        "email": email,
+        "tags": tags or [],
+    })
+
+
+@mcp.tool()
+async def list_segments() -> list:
+    """List all contact segments."""
+    return await _get("/segments")
+
+
+@mcp.tool()
+async def list_campaigns(status: str | None = None) -> list:
+    """List campaigns. status filter: draft | scheduled | sent"""
+    params: dict = {}
+    if status:
+        params["status"] = status
+    return await _get("/campaigns", params=params)
+
+
+@mcp.tool()
+async def get_campaign(campaign_id: int) -> dict:
+    """Get a campaign by ID including delivery stats (sent, delivered, read counts)."""
+    return await _get(f"/campaigns/{campaign_id}")
+
+
+@mcp.tool()
+async def create_email_campaign(
+    name: str,
+    subject: str,
+    html: str,
+    segment_id: int | None = None,
+) -> dict:
+    """Create a draft email campaign. html is the full HTML body. Returns campaign with its ID."""
+    return await _post("/campaigns", {
+        "name": name,
+        "channel": "email",
+        "subject": subject,
+        "message": html,
+        "segment_id": segment_id,
+    })
+
+
+@mcp.tool()
+async def send_campaign(campaign_id: int) -> dict:
+    """Send a campaign to all contacts in its segment. Irreversible."""
+    return await _post(f"/campaigns/{campaign_id}/send")
+
+
+@mcp.tool()
+async def get_analytics() -> dict:
+    """Account analytics: credits remaining, plan, total campaigns, total sent, avg open rate."""
+    me = await _get("/auth/me")
+    if "error" in me:
+        return me
+    campaigns = await _get("/campaigns")
+    if isinstance(campaigns, dict) and "error" in campaigns:
+        return campaigns
+    sent = [c for c in campaigns if c.get("status") == "sent"]
+    total_sent = sum(c.get("sent_count", 0) for c in sent)
+    avg_open_rate = (
+        sum(c.get("read_count", 0) / max(c.get("sent_count", 1), 1) for c in sent) / len(sent)
+        if sent else 0.0
+    )
+    return {
+        "credits_remaining": me.get("credits", 0),
+        "plan": me.get("plan", "unknown"),
+        "total_campaigns": len(campaigns),
+        "total_sent": total_sent,
+        "avg_open_rate": round(avg_open_rate, 4),
+    }
+
+
+@mcp.tool()
+async def generate_email(prompt: str, tone: str = "friendly") -> dict:
+    """Generate email subject + HTML from a prompt. tone: friendly | professional | urgent | playful"""
+    return await _post("/ai/generate-email", {"prompt": prompt, "tone": tone})
+
+
+@mcp.tool()
+async def score_contacts() -> dict:
+    """Score all contacts hot/warm/cold by campaign engagement. Requires Pro plan."""
+    return await _post("/ai/score-contacts")
+
+
+@mcp.tool()
+async def list_workspaces() -> list:
+    """List agency sub-workspaces. To operate in a workspace, use its own API key in a separate MCP config entry."""
+    return await _get("/workspaces")
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()