cortexdb-mcp 0.2.0__tar.gz → 0.2.2__tar.gz

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/Dockerfile

@@ -7,6 +7,6 @@ COPY cortexdb_mcp/ cortexdb_mcp/
 
 RUN pip install --no-cache-dir .
 
-ENV CORTEXDB_URL=http://localhost:3141
+ENV CORTEXDB_URL=https://api.cortexdb.ai
 
 CMD ["cortexdb-mcp"]

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexdb-mcp
-Version: 0.2.0
+Version: 0.2.2
 Summary: MCP Server for CortexDB — expose memory operations to AI agents
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -28,7 +28,7 @@ uvx --from . cortexdb-mcp
 Set your environment variables:
 
 ```bash
-export CORTEXDB_URL="https://api.cortexdb.ai"   # or http://localhost:3141
+export CORTEXDB_URL="https://api.cortexdb.ai"
 export CORTEXDB_API_KEY="cx_live_your_key_here"
 ```
 
@@ -132,13 +132,6 @@ Add to `.vscode/mcp.json` in your project or `~/.vscode/mcp.json` globally:
 }
 ```
 
-### Docker
-
-```bash
-docker build -t cortexdb-mcp .
-docker run -e CORTEXDB_URL=https://api.cortexdb.ai -e CORTEXDB_API_KEY=cx_live_... cortexdb-mcp
-```
-
 ## Tools
 
 ### Memory Operations
@@ -211,7 +204,7 @@ Pre-built prompt templates:
 
 | Environment Variable | Default | Description |
 |---|---|---|
-| `CORTEXDB_URL` | `http://localhost:3141` | CortexDB server URL |
+| `CORTEXDB_URL` | `https://api.cortexdb.ai` | CortexDB server URL |
 | `CORTEXDB_API_KEY` | (none) | API key for authentication |
 | `CORTEXDB_TIMEOUT` | `30.0` | HTTP request timeout (seconds) |
 
@@ -242,19 +235,6 @@ The assistant calls `entity_get` or `entity_edges` to traverse relationships.
 
 Uses the `deployment_review` prompt to check for recent incidents, dependencies, and risks.
 
-## Development
-
-```bash
-# Install in dev mode
-pip install -e ".[dev]"
-
-# Run tests
-pytest
-
-# Run the server locally
-CORTEXDB_URL=http://localhost:3141 CORTEXDB_API_KEY=test cortexdb-mcp
-```
-
 ## Architecture
 
 ```

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/README.md

@@ -15,7 +15,7 @@ uvx --from . cortexdb-mcp
 Set your environment variables:
 
 ```bash
-export CORTEXDB_URL="https://api.cortexdb.ai"   # or http://localhost:3141
+export CORTEXDB_URL="https://api.cortexdb.ai"
 export CORTEXDB_API_KEY="cx_live_your_key_here"
 ```
 
@@ -119,13 +119,6 @@ Add to `.vscode/mcp.json` in your project or `~/.vscode/mcp.json` globally:
 }
 ```
 
-### Docker
-
-```bash
-docker build -t cortexdb-mcp .
-docker run -e CORTEXDB_URL=https://api.cortexdb.ai -e CORTEXDB_API_KEY=cx_live_... cortexdb-mcp
-```
-
 ## Tools
 
 ### Memory Operations
@@ -198,7 +191,7 @@ Pre-built prompt templates:
 
 | Environment Variable | Default | Description |
 |---|---|---|
-| `CORTEXDB_URL` | `http://localhost:3141` | CortexDB server URL |
+| `CORTEXDB_URL` | `https://api.cortexdb.ai` | CortexDB server URL |
 | `CORTEXDB_API_KEY` | (none) | API key for authentication |
 | `CORTEXDB_TIMEOUT` | `30.0` | HTTP request timeout (seconds) |
 
@@ -229,19 +222,6 @@ The assistant calls `entity_get` or `entity_edges` to traverse relationships.
 
 Uses the `deployment_review` prompt to check for recent incidents, dependencies, and risks.
 
-## Development
-
-```bash
-# Install in dev mode
-pip install -e ".[dev]"
-
-# Run tests
-pytest
-
-# Run the server locally
-CORTEXDB_URL=http://localhost:3141 CORTEXDB_API_KEY=test cortexdb-mcp
-```
-
 ## Architecture
 
 ```

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/cortexdb_mcp/__init__.py

@@ -1,3 +1,3 @@
 """CortexDB MCP Server -- expose CortexDB memory operations to AI agents via MCP."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

cortexdb_mcp-0.2.2/cortexdb_mcp/__main__.py

@@ -0,0 +1,5 @@
+"""Allow ``python -m cortexdb_mcp`` to launch the MCP server."""
+
+from cortexdb_mcp.server import main
+
+main()

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/cortexdb_mcp/api.py

@@ -6,7 +6,7 @@ display proactive insights.  Results are cached with a configurable TTL (default
 
 Configuration is read from environment variables:
 
-- ``CORTEXDB_URL``      -- CortexDB base URL (default ``http://localhost:3141``)
+- ``CORTEXDB_URL``      -- CortexDB base URL (default ``https://api.cortexdb.ai``)
 - ``CORTEXDB_API_KEY``  -- Optional bearer token
 - ``CORTEXDB_TENANT_ID``-- Optional tenant scope
 - ``INSIGHTS_CACHE_TTL``-- Cache lifetime in seconds (default ``300``)
@@ -34,7 +34,7 @@ logger = logging.getLogger("cortexdb_mcp.api")
 # Configuration
 # ---------------------------------------------------------------------------
 
-CORTEXDB_URL = os.environ.get("CORTEXDB_URL", "http://localhost:3141")
+CORTEXDB_URL = os.environ.get("CORTEXDB_URL", "https://api.cortexdb.ai")
 CORTEXDB_API_KEY = os.environ.get("CORTEXDB_API_KEY")
 CORTEXDB_TENANT_ID = os.environ.get("CORTEXDB_TENANT_ID")
 INSIGHTS_CACHE_TTL = int(os.environ.get("INSIGHTS_CACHE_TTL", "300"))

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/cortexdb_mcp/config.py

@@ -19,7 +19,7 @@ class CortexMCPConfig:
         timeout: HTTP request timeout in seconds.
     """
 
-    url: str = "http://localhost:3141"
+    url: str = "https://api.cortexdb.ai"
     api_key: str | None = None
     timeout: float = 30.0
 
@@ -29,7 +29,7 @@ class CortexMCPConfig:
 
         Environment variables
         ---------------------
-        CORTEXDB_URL      -- CortexDB base URL (default ``http://localhost:3141``)
+        CORTEXDB_URL      -- CortexDB base URL (default ``https://api.cortexdb.ai``)
         CORTEXDB_API_KEY  -- API key (default ``None``)
         CORTEXDB_TIMEOUT  -- Request timeout in seconds (default ``30.0``)
         """

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/cortexdb_mcp/insights.py

@@ -131,7 +131,7 @@ class InsightsEngine:
 
     def __init__(
         self,
-        cortex_url: str = "http://localhost:3141",
+        cortex_url: str = "https://api.cortexdb.ai",
         api_key: str | None = None,
         tenant_id: str | None = None,
     ) -> None:

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/cortexdb_mcp/server.py

@@ -123,23 +123,29 @@ async def memory_store(
     ttl_seconds:
         Auto-expiry time in seconds. Omit for permanent storage.
     """
+    # Always route to /v1/remember. The /v1/episodes endpoint requires a
+    # structured Source object (connector + external_id) and a full Actor,
+    # which an MCP caller doesn't have. Carry `source`, `episode_type`, and
+    # `tags` through the free-form metadata bag instead — the coordinator
+    # and recall pipeline both honour `metadata.source` for filtering.
+    metadata: dict[str, str] = {"episode_type": episode_type}
+    if source is not None:
+        metadata["source"] = source
+    if tags:
+        metadata["tags"] = ",".join(tags)
+
     body: dict[str, Any] = {
         "content": content,
-        "episode_type": episode_type,
+        "metadata": metadata,
     }
-    if source is not None:
-        body["source"] = source
     if tenant_id is not None:
         body["tenant_id"] = tenant_id
     if namespace is not None:
         body["namespace"] = namespace
-    if tags is not None:
-        body["tags"] = tags
     if ttl_seconds is not None:
         body["ttl_seconds"] = ttl_seconds
 
-    path = "/v1/episodes" if source or tags else "/v1/remember"
-    result = await _request("POST", path, json_body=body)
+    result = await _request("POST", "/v1/remember", json_body=body)
 
     event_id = result.get("event_id") or result.get("episode_id") or "unknown"
     return f"Stored successfully. ID: {event_id}"
@@ -857,29 +863,35 @@ async def export_data(
 
 @mcp.tool()
 async def import_data(
-    data: str,
+    memories: list[dict[str, Any]],
     tenant_id: str | None = None,
-    format: str = "json",
 ) -> str:
-    """Import memories into CortexDB.
+    """Bulk-import memories into CortexDB.
 
     Parameters
     ----------
-    data:
-        JSON string of episodes to import.
+    memories:
+        List of memory objects to import. Each item must have a `content`
+        field (string); optional fields: `metadata` (dict of str→str),
+        `scope` (str).
     tenant_id:
         Tenant scope for the imported data.
-    format:
-        Import format: "json" (default).
+
+    Requires the Starter tier or higher. Free-tier accounts will receive
+    HTTP 402 (feature_not_available).
     """
-    body: dict[str, Any] = {"data": data, "format": format}
+    if not isinstance(memories, list) or not memories:
+        raise ValueError("memories must be a non-empty list of objects")
+
+    body: dict[str, Any] = {"memories": memories}
     if tenant_id:
         body["tenant_id"] = tenant_id
 
     result = await _request("POST", "/v1/import", json_body=body)
 
-    imported = result.get("imported", result.get("count", 0))
-    return f"Import complete. {imported} episodes imported."
+    imported = result.get("imported", 0)
+    failed = result.get("failed", 0)
+    return f"Import complete. {imported} imported, {failed} failed."
 
 
 # ===========================================================================
@@ -1078,7 +1090,25 @@ def weekly_digest(tenant_id: str | None = None) -> str:
 
 def main() -> None:
     """Run the CortexDB MCP server over stdio transport."""
-    mcp.run(transport="stdio")
+    import argparse
+
+    parser = argparse.ArgumentParser(
+        prog="cortexdb-mcp",
+        description="CortexDB MCP Server — expose memory operations to AI agents via the Model Context Protocol.",
+    )
+    parser.add_argument(
+        "--transport",
+        choices=["stdio"],
+        default="stdio",
+        help="Transport mode (default: stdio)",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="cortexdb-mcp 0.2.1",
+    )
+    args = parser.parse_args()
+    mcp.run(transport=args.transport)
 
 
 if __name__ == "__main__":

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cortexdb-mcp"
-version = "0.2.0"
+version = "0.2.2"
 description = "MCP Server for CortexDB — expose memory operations to AI agents"
 requires-python = ">=3.10"
 license = "MIT"

{cortexdb_mcp-0.2.0 → cortexdb_mcp-0.2.2}/tests/test_server.py

@@ -41,7 +41,7 @@ class TestConfig:
 
     def test_defaults(self):
         cfg = CortexMCPConfig()
-        assert cfg.url == "http://localhost:3141"
+        assert cfg.url == "https://api.cortexdb.ai"
         assert cfg.api_key is None
         assert cfg.timeout == 30.0
 
@@ -59,7 +59,7 @@ class TestConfig:
         monkeypatch.delenv("CORTEXDB_API_KEY", raising=False)
         monkeypatch.delenv("CORTEXDB_TIMEOUT", raising=False)
         cfg = CortexMCPConfig.from_env()
-        assert cfg.url == "http://localhost:3141"
+        assert cfg.url == "https://api.cortexdb.ai"
         assert cfg.api_key is None