ecs-mcp 0.1.0__tar.gz

ecs_mcp-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:github.com)",
+      "Bash(uvx --help)"
+    ]
+  }
+}

ecs_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: ecs-mcp
+Version: 0.1.0
+Summary: ECS MCP server
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp[cli]

ecs_mcp-0.1.0/mcp.specification

@@ -0,0 +1,35 @@
+# ECS-MCP
+This is an MCP server tool for the ECS company.
+
+## Requirements
+Must be Claude Desktop compatible with the ability to be configure via `claude_desktop_config.json` like below.
+```
+{
+  "mcpServers": {
+    "ecs-mcp": {
+      "command": "your-uvx-path-here",
+      "args": ["ecs-mcp"],
+      "env": {
+        "AFFINITY_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Prerequisites:
+* An Affinity account with API access (Scale, Advanced, or Enterprise)
+* UV Python package manager
+* An MCP-compatible AI assistant (e.g., Claude Desktop, GitHub Copilot, Gemini CLI)
+* An Affinity API key — see the Authentication page for help obtaining one
+
+## Tools
+### Affinity
+Create Affinity CRM tool that is a facade of its API:
+https://api-docs.affinity.co/?utm_source=chatgpt.com#introduction-to-api-v1
+
+Only create functions in the Affinity tool listed below.
+Do not create any additional ones that are not listed below.
+
+#### Create a new deal
+Create a new deal on an existing list that's provided as a parameter (e.g. "ALL DEALS ECS").

ecs_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "ecs-mcp"
+version = "0.1.0"
+description = "ECS MCP server"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp[cli]",
+    "httpx>=0.27",
+]
+
+[project.scripts]
+ecs-mcp = "ecs_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ecs_mcp"]

ecs_mcp-0.1.0/src/ecs_mcp/__init__.py

@@ -0,0 +1,6 @@
+"""ECS MCP Server — Affinity CRM integration."""
+
+from mcp.server.fastmcp import FastMCP
+
+# Shared FastMCP instance — imported by server.py and all tool modules
+mcp = FastMCP("ecs-mcp")

ecs_mcp-0.1.0/src/ecs_mcp/__main__.py

@@ -0,0 +1,3 @@
+from ecs_mcp.server import main
+
+main()

ecs_mcp-0.1.0/src/ecs_mcp/server.py

@@ -0,0 +1,12 @@
+"""ECS MCP Server bootstrap."""
+
+from ecs_mcp import mcp
+import ecs_mcp.tools  # noqa: F401 — registers all tool modules as a side effect
+
+
+def main() -> None:
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

ecs_mcp-0.1.0/src/ecs_mcp/tools/__init__.py

@@ -0,0 +1,6 @@
+"""Tool registry — import each tool module here to register its @mcp.tool() decorators."""
+
+from ecs_mcp.tools import affinity  # noqa: F401
+
+# To add a new integration, add an import here:
+# from ecs_mcp.tools import hubspot  # noqa: F401

ecs_mcp-0.1.0/src/ecs_mcp/tools/affinity.py

@@ -0,0 +1,115 @@
+"""Affinity CRM tools for ecs-mcp."""
+
+import os
+from typing import Any
+
+import httpx
+
+from ecs_mcp import mcp
+
+AFFINITY_BASE_URL = "https://api.affinity.co"
+
+
+# ---------------------------------------------------------------------------
+# Affinity API client helpers
+# ---------------------------------------------------------------------------
+
+def _get_api_key() -> str:
+    key = os.environ.get("AFFINITY_API_KEY", "").strip()
+    if not key:
+        raise ValueError(
+            "AFFINITY_API_KEY environment variable is not set. "
+            "Add it to your Claude Desktop config under 'env'."
+        )
+    return key
+
+
+def _client() -> httpx.AsyncClient:
+    return httpx.AsyncClient(
+        base_url=AFFINITY_BASE_URL,
+        auth=("", _get_api_key()),
+        headers={"Content-Type": "application/json"},
+        timeout=30.0,
+    )
+
+
+async def _find_list_by_name(client: httpx.AsyncClient, list_name: str) -> dict[str, Any] | None:
+    response = await client.get("/lists")
+    response.raise_for_status()
+    for lst in response.json():
+        if lst.get("name", "").lower() == list_name.lower():
+            return lst
+    return None
+
+
+async def _find_organization(client: httpx.AsyncClient, org_name: str) -> dict[str, Any] | None:
+    response = await client.get("/organizations", params={"term": org_name})
+    response.raise_for_status()
+    orgs = response.json().get("organizations", [])
+    if not orgs:
+        return None
+    for org in orgs:
+        if org.get("name", "").lower() == org_name.lower():
+            return org
+    return orgs[0]
+
+
+async def _create_organization(client: httpx.AsyncClient, org_name: str) -> dict[str, Any]:
+    slug = "".join(c for c in org_name.lower() if c.isalnum())
+    response = await client.post(
+        "/organizations",
+        json={"name": org_name, "domain": f"{slug}.com"},
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+async def _create_list_entry(
+    client: httpx.AsyncClient, list_id: int, entity_id: int
+) -> dict[str, Any]:
+    response = await client.post(
+        f"/lists/{list_id}/list-entries",
+        json={"entity_id": entity_id},
+    )
+    response.raise_for_status()
+    return response.json()
+
+
+# ---------------------------------------------------------------------------
+# MCP tool
+# ---------------------------------------------------------------------------
+
+@mcp.tool()
+async def create_deal(list_name: str, organization_name: str) -> str:
+    """Add a company as a new deal entry on an Affinity CRM list.
+
+    Finds or creates the organization in Affinity, then adds it to the
+    specified list. Avoids creating duplicate organizations.
+
+    Args:
+        list_name: The exact name of the Affinity list (e.g. "ALL DEALS ECS").
+        organization_name: The company name to add (e.g. "Acme Corp").
+    """
+    async with _client() as client:
+        lst = await _find_list_by_name(client, list_name)
+        if lst is None:
+            return (
+                f"Error: No Affinity list found with name '{list_name}'. "
+                "Check the list name in Affinity and try again."
+            )
+
+        org = await _find_organization(client, organization_name)
+        created_new = org is None
+        if created_new:
+            org = await _create_organization(client, organization_name)
+
+        org_id: int = org["id"]
+        entry = await _create_list_entry(client, lst["id"], org_id)
+
+        org_status = "created new organization" if created_new else "found existing organization"
+        return (
+            f"Successfully added '{org.get('name', organization_name)}' to '{lst['name']}'.\n"
+            f"  - Organization: {org_status} (id={org_id})\n"
+            f"  - List entry id: {entry.get('id', '?')}\n"
+            f"  - List: '{lst['name']}' (id={lst['id']})"
+        )

ecs_mcp-0.1.0/templates-claude.prompts

@@ -0,0 +1,8 @@
+# Prompt templates for Claude
+
+## New opportunities in Gmail
+Discover new opportunity companies from my emails in Gmail and add them to Affinity CRM.
+Emails that contain new opporutnity companies are labeled "opportunity".
+Add the new opportunities in the "ALL DEALS ECS" list in Affinity.
+Emails that have already been added to the Affinity CRM are labeled "in_affinity" under "automation".
+Do not add duplicate entry.