simba-mcp 0.1.0__tar.gz

simba_mcp-0.1.0/.commitmsg

@@ -0,0 +1,5 @@
+Fix CI: move dev deps to optional-dependencies for pip compatibility
+
+pip does not support --dependency-group. Move dev dependencies from
+[dependency-groups] to [project.optional-dependencies] and use
+pip install -e ".[dev]" everywhere.

simba_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,30 @@
+---
+name: Bug Report
+about: Report a bug in the Simba MCP Server
+labels: bug
+---
+
+## Description
+
+<!-- A clear description of the bug. -->
+
+## Steps to Reproduce
+
+1. 
+2. 
+3. 
+
+## Expected Behavior
+
+<!-- What should happen? -->
+
+## Actual Behavior
+
+<!-- What happens instead? Include error messages or logs if available. -->
+
+## Environment
+
+- **simba-mcp version:** 
+- **Python version:** 
+- **MCP client:** (Cursor / Claude Code / Claude API / other)
+- **OS:** 

simba_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature Request
+about: Suggest a new tool or improvement
+labels: enhancement
+---
+
+## Problem
+
+<!-- What problem does this solve? What's missing today? -->
+
+## Proposed Solution
+
+<!-- Describe the feature or change you'd like. -->
+
+## Alternatives Considered
+
+<!-- Any other approaches you've thought about. -->

simba_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - ci
+    open-pull-requests-limit: 5

simba_mcp-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## What does this PR do?
+
+<!-- A brief description of the change. -->
+
+## Why?
+
+<!-- Why is this change needed? Link to an issue if applicable. -->
+
+## Testing
+
+- [ ] `pytest -v` passes
+- [ ] `ruff check src/ tests/` passes
+- [ ] `ruff format --check src/ tests/` passes
+
+## Notes
+
+<!-- Anything reviewers should know — breaking changes, migration steps, etc. -->

simba_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Format check
+        run: ruff format --check src/ tests/
+
+      - name: Test
+        run: pytest -v

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

@@ -0,0 +1,56 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Format check
+        run: ruff format --check src/ tests/
+
+      - name: Test
+        run: pytest -v
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install hatchling build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

simba_mcp-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+.venv/
+venv/
+.env
+
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDEs
+.idea/
+.vscode/
+.cursor/
+*.swp
+*.swo
+*~
+
+# Logs
+*.log

simba_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to the Simba MCP Server will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## 0.1.0 — 2026-04-05
+
+### Added
+
+- Initial release of the Simba MCP Server.
+- 11 MCP tools: `get_data_schema`, `upload_data`, `list_models`, `create_model`, `get_model_status`, `get_model_results`, `run_optimizer`, `get_optimizer_results`, `get_scenario_template`, `run_scenario`, `get_scenario_results`.
+- Async HTTP client (`SimbaAPIClient`) wrapping Simba API v1.
+- Support for stdio, Streamable HTTP, and SSE transport modes.
+- CLI entrypoint (`simba-mcp`).
+- CI workflow (lint + test on Python 3.11/3.12/3.13).
+- PyPI publish workflow on GitHub Release.

simba_mcp-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Code of Conduct
+
+This project follows the same Code of Conduct as the main Simba platform.
+
+Please see the [Simba Code of Conduct](https://github.com/getsimba-ai/simba-mmm/blob/main/CODE_OF_CONDUCT.md) for the full text.
+
+In summary: be respectful, be constructive, and be welcoming. Harassment, discrimination, and disruptive behavior will not be tolerated.
+
+## Reporting
+
+If you experience or witness unacceptable behavior, please email **conduct@getsimba.ai**.

simba_mcp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# Contributing to Simba MCP Server
+
+Thanks for your interest in contributing! This guide covers the basics for getting set up and submitting changes.
+
+For broader contribution guidelines across the Simba project, see the [main repo's contributing guide](https://github.com/getsimba-ai/simba-mmm/blob/main/CONTRIBUTING.md).
+
+## Development Setup
+
+```bash
+# Clone the repo
+git clone https://github.com/getsimba-ai/simba-mcp.git
+cd simba-mcp
+
+# Create a virtual environment
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+
+# Install the package in editable mode with dev dependencies
+pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+pytest -v
+```
+
+## Linting
+
+```bash
+ruff check src/ tests/
+```
+
+## Submitting Changes
+
+1. Fork the repo and create a feature branch from `main`.
+2. Make your changes — add tests for new functionality.
+3. Ensure `pytest -v` and `ruff check src/ tests/` pass locally.
+4. Open a pull request against `main` with a clear description of the change.
+
+## Code Style
+
+This project uses [Ruff](https://docs.astral.sh/ruff/) for linting, configured in `pyproject.toml` (Python 3.11+, 100-char line length). CI enforces this on every PR.

simba_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simba
+
+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.

simba_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.4
+Name: simba-mcp
+Version: 0.1.0
+Summary: MCP server for Simba Marketing Mix Modeling — connect AI assistants to your MMM models
+Project-URL: Homepage, https://getsimba.ai
+Project-URL: Repository, https://github.com/getsimba-ai/simba-mcp
+Project-URL: Documentation, https://github.com/getsimba-ai/simba-mmm
+Author-email: Simba <hello@getsimba.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bayesian,marketing-mix-model,mcp,mmm,simba
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.1.3
+Provides-Extra: dev
+Requires-Dist: anyio>=4.0; extra == 'dev'
+Requires-Dist: pytest-anyio>=0.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Simba MCP Server
+
+[![PyPI](https://img.shields.io/pypi/v/simba-mcp)](https://pypi.org/project/simba-mcp/)
+[![CI](https://github.com/getsimba-ai/simba-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/getsimba-ai/simba-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+[Simba](https://getsimba.ai) is a Bayesian Marketing Mix Modeling (MMM) platform. This [MCP server](https://modelcontextprotocol.io/) lets AI assistants interact with your Marketing Mix Models directly — upload data, build models, check results, and run budget optimizations through natural language in Claude, Cursor, or Claude Code.
+
+## See Also
+
+- **[getsimba.ai](https://getsimba.ai)** — the main Simba website (features, pricing, demos)
+- **[getsimba-ai/simba-mmm](https://github.com/getsimba-ai/simba-mmm)** — platform repo with full documentation on MMM concepts, data requirements, model configuration, optimization, and scenario planning
+
+## Installation
+
+```bash
+pip install simba-mcp
+```
+
+Or run directly without installing:
+
+```bash
+uvx simba-mcp
+```
+
+## Quick Start
+
+### Cursor IDE
+
+Add to your Cursor MCP settings (`.cursor/mcp.json` in the workspace or global settings):
+
+```json
+{
+  "mcpServers": {
+    "simba": {
+      "command": "uvx",
+      "args": ["simba-mcp"],
+      "env": {
+        "SIMBA_API_URL": "https://app.getsimba.ai",
+        "SIMBA_API_KEY": "simba_sk_..."
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your Claude Code MCP config:
+
+```json
+{
+  "mcpServers": {
+    "simba": {
+      "command": "uvx",
+      "args": ["simba-mcp"],
+      "env": {
+        "SIMBA_API_URL": "https://app.getsimba.ai",
+        "SIMBA_API_KEY": "simba_sk_..."
+      }
+    }
+  }
+}
+```
+
+### Claude API (MCP Connector)
+
+Use the remote Streamable HTTP transport with the Anthropic MCP connector:
+
+```python
+import anthropic
+
+client = anthropic.Anthropic()
+
+response = client.beta.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=4096,
+    messages=[{"role": "user", "content": "List my Simba models"}],
+    mcp_servers=[
+        {
+            "type": "url",
+            "url": "https://app.getsimba.ai/mcp",
+            "name": "simba",
+            "authorization_token": "simba_sk_...",
+        }
+    ],
+    tools=[{"type": "mcp_toolset", "mcp_server_name": "simba"}],
+    betas=["mcp-client-2025-11-20"],
+)
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_data_schema` | Get the canonical CSV schema for MMM input files |
+| `upload_data` | Upload a CSV dataset to Simba |
+| `list_models` | List all models with their status |
+| `create_model` | Configure and start fitting a new MMM model |
+| `get_model_status` | Poll fitting progress for a model |
+| `get_model_results` | Get results (ROI, contributions, response curves, diagnostics, and more) |
+| `run_optimizer` | Run budget optimization on a completed model |
+| `get_optimizer_results` | Get optimizer status and results |
+| `get_scenario_template` | Generate a forward-period template for scenario planning |
+| `run_scenario` | Run a "what-if" scenario prediction |
+| `get_scenario_results` | Get scenario prediction results |
+
+## Example Prompts
+
+Try these with any connected AI assistant:
+
+**Explore your models:**
+> "List my Simba models and show me the channel ROI summary for the most recent complete model."
+
+**Build a model:**
+> "Upload this CSV data to Simba and create a new MMM model with TV, Search, and Social as media channels. Use 'revenue' as the KPI and 'date' as the date column."
+
+**Check progress:**
+> "What's the fitting status of model a1b2c3d4?"
+
+**Get results:**
+> "Show me the model diagnostics and channel contributions for model a1b2c3d4."
+
+**Optimize budget:**
+> "Run a budget optimization on model a1b2c3d4 with $1M total budget over 12 months. Set TV bounds to 5-40% and Search to 10-50%. Use uniform laydown weights."
+
+**Response curves:**
+> "Show me the response curves for model a1b2c3d4. At what spend level does TV hit diminishing returns?"
+
+**Scenario planning:**
+> "Get a scenario template for model a1b2c3d4 for the next 12 weeks. Then run a scenario where I increase TV by 20% and cut Search by 10%. What happens to revenue?"
+
+**Full workflow:**
+> "I have marketing data I want to analyze. First get the schema so I know what format is needed, then upload my data, create a model, and once it's done show me the ROI by channel."
+
+## API Key Setup
+
+The MCP server authenticates with the same API keys used by the Simba REST API. Create a key with the required scopes:
+
+1. Go to **Profile > API Keys** in the Simba UI
+2. Click **Create Key**
+3. Set scopes: `ingest`, `read:models`, `read:results`, `create:models`, `optimize`, `scenario`
+4. Copy the key (shown only once)
+
+Set the key as the `SIMBA_API_KEY` environment variable in your MCP config.
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `SIMBA_API_URL` | Simba API base URL | `http://localhost:5005` |
+| `SIMBA_API_KEY` | Your Simba API key | (required) |
+
+## Transport Modes
+
+The server supports all MCP transport modes:
+
+```bash
+# stdio (default) — for Cursor, Claude Code
+simba-mcp
+
+# Streamable HTTP — for remote deployment
+simba-mcp --transport streamable-http --port 8100
+
+# SSE — legacy transport
+simba-mcp --transport sse --port 8100
+
+# Or via uvicorn directly
+uvicorn "simba_mcp.server:create_app()" --host 0.0.0.0 --port 8100
+```
+
+## License
+
+MIT

simba_mcp-0.1.0/README.md

@@ -0,0 +1,175 @@
+# Simba MCP Server
+
+[![PyPI](https://img.shields.io/pypi/v/simba-mcp)](https://pypi.org/project/simba-mcp/)
+[![CI](https://github.com/getsimba-ai/simba-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/getsimba-ai/simba-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+[Simba](https://getsimba.ai) is a Bayesian Marketing Mix Modeling (MMM) platform. This [MCP server](https://modelcontextprotocol.io/) lets AI assistants interact with your Marketing Mix Models directly — upload data, build models, check results, and run budget optimizations through natural language in Claude, Cursor, or Claude Code.
+
+## See Also
+
+- **[getsimba.ai](https://getsimba.ai)** — the main Simba website (features, pricing, demos)
+- **[getsimba-ai/simba-mmm](https://github.com/getsimba-ai/simba-mmm)** — platform repo with full documentation on MMM concepts, data requirements, model configuration, optimization, and scenario planning
+
+## Installation
+
+```bash
+pip install simba-mcp
+```
+
+Or run directly without installing:
+
+```bash
+uvx simba-mcp
+```
+
+## Quick Start
+
+### Cursor IDE
+
+Add to your Cursor MCP settings (`.cursor/mcp.json` in the workspace or global settings):
+
+```json
+{
+  "mcpServers": {
+    "simba": {
+      "command": "uvx",
+      "args": ["simba-mcp"],
+      "env": {
+        "SIMBA_API_URL": "https://app.getsimba.ai",
+        "SIMBA_API_KEY": "simba_sk_..."
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your Claude Code MCP config:
+
+```json
+{
+  "mcpServers": {
+    "simba": {
+      "command": "uvx",
+      "args": ["simba-mcp"],
+      "env": {
+        "SIMBA_API_URL": "https://app.getsimba.ai",
+        "SIMBA_API_KEY": "simba_sk_..."
+      }
+    }
+  }
+}
+```
+
+### Claude API (MCP Connector)
+
+Use the remote Streamable HTTP transport with the Anthropic MCP connector:
+
+```python
+import anthropic
+
+client = anthropic.Anthropic()
+
+response = client.beta.messages.create(
+    model="claude-sonnet-4-6",
+    max_tokens=4096,
+    messages=[{"role": "user", "content": "List my Simba models"}],
+    mcp_servers=[
+        {
+            "type": "url",
+            "url": "https://app.getsimba.ai/mcp",
+            "name": "simba",
+            "authorization_token": "simba_sk_...",
+        }
+    ],
+    tools=[{"type": "mcp_toolset", "mcp_server_name": "simba"}],
+    betas=["mcp-client-2025-11-20"],
+)
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_data_schema` | Get the canonical CSV schema for MMM input files |
+| `upload_data` | Upload a CSV dataset to Simba |
+| `list_models` | List all models with their status |
+| `create_model` | Configure and start fitting a new MMM model |
+| `get_model_status` | Poll fitting progress for a model |
+| `get_model_results` | Get results (ROI, contributions, response curves, diagnostics, and more) |
+| `run_optimizer` | Run budget optimization on a completed model |
+| `get_optimizer_results` | Get optimizer status and results |
+| `get_scenario_template` | Generate a forward-period template for scenario planning |
+| `run_scenario` | Run a "what-if" scenario prediction |
+| `get_scenario_results` | Get scenario prediction results |
+
+## Example Prompts
+
+Try these with any connected AI assistant:
+
+**Explore your models:**
+> "List my Simba models and show me the channel ROI summary for the most recent complete model."
+
+**Build a model:**
+> "Upload this CSV data to Simba and create a new MMM model with TV, Search, and Social as media channels. Use 'revenue' as the KPI and 'date' as the date column."
+
+**Check progress:**
+> "What's the fitting status of model a1b2c3d4?"
+
+**Get results:**
+> "Show me the model diagnostics and channel contributions for model a1b2c3d4."
+
+**Optimize budget:**
+> "Run a budget optimization on model a1b2c3d4 with $1M total budget over 12 months. Set TV bounds to 5-40% and Search to 10-50%. Use uniform laydown weights."
+
+**Response curves:**
+> "Show me the response curves for model a1b2c3d4. At what spend level does TV hit diminishing returns?"
+
+**Scenario planning:**
+> "Get a scenario template for model a1b2c3d4 for the next 12 weeks. Then run a scenario where I increase TV by 20% and cut Search by 10%. What happens to revenue?"
+
+**Full workflow:**
+> "I have marketing data I want to analyze. First get the schema so I know what format is needed, then upload my data, create a model, and once it's done show me the ROI by channel."
+
+## API Key Setup
+
+The MCP server authenticates with the same API keys used by the Simba REST API. Create a key with the required scopes:
+
+1. Go to **Profile > API Keys** in the Simba UI
+2. Click **Create Key**
+3. Set scopes: `ingest`, `read:models`, `read:results`, `create:models`, `optimize`, `scenario`
+4. Copy the key (shown only once)
+
+Set the key as the `SIMBA_API_KEY` environment variable in your MCP config.
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `SIMBA_API_URL` | Simba API base URL | `http://localhost:5005` |
+| `SIMBA_API_KEY` | Your Simba API key | (required) |
+
+## Transport Modes
+
+The server supports all MCP transport modes:
+
+```bash
+# stdio (default) — for Cursor, Claude Code
+simba-mcp
+
+# Streamable HTTP — for remote deployment
+simba-mcp --transport streamable-http --port 8100
+
+# SSE — legacy transport
+simba-mcp --transport sse --port 8100
+
+# Or via uvicorn directly
+uvicorn "simba_mcp.server:create_app()" --host 0.0.0.0 --port 8100
+```
+
+## License
+
+MIT