sugra-api-mcp 0.1.0__tar.gz

sugra_api_mcp-0.1.0/.github/workflows/deploy-app-vm.yml

@@ -0,0 +1,24 @@
+name: Deploy MCP to APP VM
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "sugra_api_mcp/**"
+      - "pyproject.toml"
+      - ".github/workflows/deploy-app-vm.yml"
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy via SSH
+        uses: appleboy/ssh-action@v1.2.0
+        with:
+          host: ${{ secrets.APP_VM_HOST }}
+          username: ${{ secrets.APP_VM_USER }}
+          key: ${{ secrets.APP_VM_SSH_KEY }}
+          script: |
+            sudo /usr/local/bin/sugra-mcp-deploy

sugra_api_mcp-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,25 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Publish to PyPI (trusted publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1

sugra_api_mcp-0.1.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,28 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "test-v*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

sugra_api_mcp-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,42 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13", "3.14"]
+    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
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev,http]"
+      - name: Ruff
+        run: ruff check sugra_api_mcp
+      - name: Import check
+        run: python -c "import sugra_api_mcp; from sugra_api_mcp import tools"
+      - name: Tools registered
+        env:
+          SUGRA_API_KEY: dummy_test_key
+        run: |
+          python -c "
+          import asyncio
+          from sugra_api_mcp import tools
+          from sugra_api_mcp.server import mcp
+          async def main():
+              t = await mcp.list_tools()
+              assert len(t) == 17, f'Expected 17 tools, got {len(t)}'
+              print(f'OK: {len(t)} tools registered')
+          asyncio.run(main())
+          "

sugra_api_mcp-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+
+.venv/
+venv/
+env/
+ENV/
+
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.tox/
+
+.env
+.env.local
+*.log
+
+.vscode/
+.idea/
+*.swp
+.DS_Store

sugra_api_mcp-0.1.0/LICENSE

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

sugra_api_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: sugra-api-mcp
+Version: 0.1.0
+Summary: Sugra API MCP server - unified access to 518+ intelligence endpoints from Claude Desktop, Cursor, Zed, and any MCP-compatible client
+Project-URL: Homepage, https://sugra.ai
+Project-URL: Documentation, https://docs.sugra.ai
+Project-URL: Repository, https://github.com/Sugra-Systems/prod-sugra-ai-MCP
+Project-URL: Issues, https://github.com/Sugra-Systems/prod-sugra-ai-MCP/issues
+Author-email: "Sugra Systems, Inc." <support@sugra.systems>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,claude,data,finance,llm,macro,mcp,model-context-protocol,sugra
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pydantic>=2.9
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.7; extra == 'dev'
+Provides-Extra: http
+Requires-Dist: fastapi>=0.115; extra == 'http'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'http'
+Description-Content-Type: text/markdown
+
+# sugra-api-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/sugra-api-mcp.svg)](https://pypi.org/project/sugra-api-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/sugra-api-mcp.svg)](https://pypi.org/project/sugra-api-mcp/)
+[![License](https://img.shields.io/pypi/l/sugra-api-mcp.svg)](https://github.com/Sugra-Systems/prod-sugra-ai-MCP/blob/main/LICENSE)
+
+Official [Model Context Protocol](https://modelcontextprotocol.io) server for the [Sugra API](https://sugra.ai) - unified access to 518+ intelligence endpoints spanning financial markets, macroeconomics, fundamentals, government data, physical world signals, and news.
+
+Use it from Claude Desktop, Cursor, Zed, Cline, claude.ai, or any MCP-compatible agent.
+
+## What you get
+
+17 tools covering the full Sugra API:
+
+| Category | Tools |
+|---|---|
+| Markets | `get_market_price`, `get_historical_prices`, `get_market_overview`, `search_symbol`, `get_prediction_market` |
+| Fundamentals | `get_company_overview`, `get_company_filings` |
+| Macro | `get_macro_indicator`, `get_central_bank_rate`, `search_economic_series` |
+| Government | `get_government_spending`, `get_treasury_data` |
+| Physical world | `get_weather`, `get_environmental_data` |
+| News | `get_news` |
+| Discovery | `search_endpoint`, `call_endpoint` (covers all 518 endpoints) |
+
+## Installation
+
+```bash
+pip install sugra-api-mcp
+```
+
+Get a free API key at [app.sugra.ai/settings/billing](https://app.sugra.ai/settings/billing) (Free tier: 50 req/day).
+
+## Usage with Claude Desktop (stdio)
+
+Add to `claude_desktop_config.json`:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sugra": {
+      "command": "python",
+      "args": ["-m", "sugra_api_mcp"],
+      "env": {
+        "SUGRA_API_KEY": "sugra_xxx_yourkey..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Sugra tools appear in the tools menu.
+
+## Usage with Cursor, Zed, Cline
+
+Same stdio config as above, in the respective MCP settings file.
+
+## Usage over HTTP (claude.ai, remote agents)
+
+If you prefer not to install anything locally, use the hosted Streamable HTTP endpoint:
+
+```
+https://app.sugra.ai/mcp
+```
+
+Add to claude.ai or any Streamable HTTP MCP client with `Authorization: Bearer sugra_xxx_...` header.
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `SUGRA_API_KEY` | Yes | - | Your Sugra API key |
+| `SUGRA_API_BASE` | No | `https://sugra.ai` | Override for self-hosted or beta environments |
+| `SUGRA_TIMEOUT` | No | `30` | Request timeout in seconds |
+
+## Examples
+
+Ask Claude:
+
+- "What's Bitcoin's current price and how did it move this week?"
+- "Show me Apple's income statement and debt profile."
+- "Compare US vs Germany CPI over the last 5 years."
+- "What's the Fed funds rate today, and what was the last change?"
+- "Find all Sugra endpoints related to shipping or vessels."
+
+## Development
+
+```bash
+git clone https://github.com/Sugra-Systems/prod-sugra-ai-MCP
+cd prod-sugra-ai-MCP
+pip install -e ".[dev,http]"
+export SUGRA_API_KEY=sugra_...
+python -m sugra_api_mcp  # stdio mode
+python -m sugra_api_mcp --transport streamable-http --port 8001  # HTTP mode
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+## License
+
+MIT © Sugra Systems, Inc.

sugra_api_mcp-0.1.0/README.md

@@ -0,0 +1,107 @@
+# sugra-api-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/sugra-api-mcp.svg)](https://pypi.org/project/sugra-api-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/sugra-api-mcp.svg)](https://pypi.org/project/sugra-api-mcp/)
+[![License](https://img.shields.io/pypi/l/sugra-api-mcp.svg)](https://github.com/Sugra-Systems/prod-sugra-ai-MCP/blob/main/LICENSE)
+
+Official [Model Context Protocol](https://modelcontextprotocol.io) server for the [Sugra API](https://sugra.ai) - unified access to 518+ intelligence endpoints spanning financial markets, macroeconomics, fundamentals, government data, physical world signals, and news.
+
+Use it from Claude Desktop, Cursor, Zed, Cline, claude.ai, or any MCP-compatible agent.
+
+## What you get
+
+17 tools covering the full Sugra API:
+
+| Category | Tools |
+|---|---|
+| Markets | `get_market_price`, `get_historical_prices`, `get_market_overview`, `search_symbol`, `get_prediction_market` |
+| Fundamentals | `get_company_overview`, `get_company_filings` |
+| Macro | `get_macro_indicator`, `get_central_bank_rate`, `search_economic_series` |
+| Government | `get_government_spending`, `get_treasury_data` |
+| Physical world | `get_weather`, `get_environmental_data` |
+| News | `get_news` |
+| Discovery | `search_endpoint`, `call_endpoint` (covers all 518 endpoints) |
+
+## Installation
+
+```bash
+pip install sugra-api-mcp
+```
+
+Get a free API key at [app.sugra.ai/settings/billing](https://app.sugra.ai/settings/billing) (Free tier: 50 req/day).
+
+## Usage with Claude Desktop (stdio)
+
+Add to `claude_desktop_config.json`:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sugra": {
+      "command": "python",
+      "args": ["-m", "sugra_api_mcp"],
+      "env": {
+        "SUGRA_API_KEY": "sugra_xxx_yourkey..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Sugra tools appear in the tools menu.
+
+## Usage with Cursor, Zed, Cline
+
+Same stdio config as above, in the respective MCP settings file.
+
+## Usage over HTTP (claude.ai, remote agents)
+
+If you prefer not to install anything locally, use the hosted Streamable HTTP endpoint:
+
+```
+https://app.sugra.ai/mcp
+```
+
+Add to claude.ai or any Streamable HTTP MCP client with `Authorization: Bearer sugra_xxx_...` header.
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `SUGRA_API_KEY` | Yes | - | Your Sugra API key |
+| `SUGRA_API_BASE` | No | `https://sugra.ai` | Override for self-hosted or beta environments |
+| `SUGRA_TIMEOUT` | No | `30` | Request timeout in seconds |
+
+## Examples
+
+Ask Claude:
+
+- "What's Bitcoin's current price and how did it move this week?"
+- "Show me Apple's income statement and debt profile."
+- "Compare US vs Germany CPI over the last 5 years."
+- "What's the Fed funds rate today, and what was the last change?"
+- "Find all Sugra endpoints related to shipping or vessels."
+
+## Development
+
+```bash
+git clone https://github.com/Sugra-Systems/prod-sugra-ai-MCP
+cd prod-sugra-ai-MCP
+pip install -e ".[dev,http]"
+export SUGRA_API_KEY=sugra_...
+python -m sugra_api_mcp  # stdio mode
+python -m sugra_api_mcp --transport streamable-http --port 8001  # HTTP mode
+```
+
+Run tests:
+
+```bash
+pytest
+```
+
+## License
+
+MIT © Sugra Systems, Inc.

sugra_api_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sugra-api-mcp"
+version = "0.1.0"
+description = "Sugra API MCP server - unified access to 518+ intelligence endpoints from Claude Desktop, Cursor, Zed, and any MCP-compatible client"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Sugra Systems, Inc.", email = "support@sugra.systems" },
+]
+requires-python = ">=3.13"
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "sugra",
+    "finance",
+    "macro",
+    "claude",
+    "ai-agents",
+    "llm",
+    "data",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Office/Business :: Financial",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = [
+    "mcp>=1.2.0",
+    "httpx>=0.27",
+    "pydantic>=2.9",
+]
+
+[project.optional-dependencies]
+http = [
+    "fastapi>=0.115",
+    "uvicorn[standard]>=0.30",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-httpx>=0.30",
+    "ruff>=0.7",
+    "mypy>=1.11",
+]
+
+[project.scripts]
+sugra-api-mcp = "sugra_api_mcp.__main__:main"
+
+[project.urls]
+Homepage = "https://sugra.ai"
+Documentation = "https://docs.sugra.ai"
+Repository = "https://github.com/Sugra-Systems/prod-sugra-ai-MCP"
+Issues = "https://github.com/Sugra-Systems/prod-sugra-ai-MCP/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["sugra_api_mcp"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unused_configs = true

sugra_api_mcp-0.1.0/sugra_api_mcp/__init__.py

@@ -0,0 +1,7 @@
+"""Sugra API MCP server.
+
+Official Model Context Protocol server for the Sugra API.
+See https://github.com/Sugra-Systems/prod-sugra-ai-MCP for usage.
+"""
+
+__version__ = "0.1.0"

sugra_api_mcp-0.1.0/sugra_api_mcp/__main__.py

@@ -0,0 +1,48 @@
+"""Entry point: `python -m sugra_api_mcp` or `sugra-api-mcp` CLI."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import Literal
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="sugra-api-mcp",
+        description="Sugra API MCP server",
+    )
+    parser.add_argument(
+        "--transport",
+        choices=["stdio", "streamable-http"],
+        default="stdio",
+        help="MCP transport (default: stdio for Claude Desktop / Cursor / Zed)",
+    )
+    parser.add_argument(
+        "--host",
+        default="127.0.0.1",
+        help="Bind host for streamable-http (default: 127.0.0.1)",
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=8001,
+        help="Bind port for streamable-http (default: 8001)",
+    )
+    args = parser.parse_args()
+
+    # Import tools to register them with the FastMCP instance.
+    from . import tools  # noqa: F401
+    from .server import mcp
+
+    transport: Literal["stdio", "streamable-http"] = args.transport
+    if transport == "stdio":
+        mcp.run(transport="stdio")
+    else:
+        mcp.settings.host = args.host
+        mcp.settings.port = args.port
+        mcp.run(transport="streamable-http")
+
+
+if __name__ == "__main__":
+    sys.exit(main())

sugra_api_mcp-0.1.0/sugra_api_mcp/client.py

@@ -0,0 +1,52 @@
+"""Async HTTP client for the Sugra API."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+from .config import Config
+
+
+class SugraClient:
+    """Thin async wrapper over the Sugra API with x-api-key auth."""
+
+    def __init__(self, config: Config) -> None:
+        self._config = config
+        self._client = httpx.AsyncClient(
+            base_url=config.api_base,
+            headers={
+                "x-api-key": config.api_key,
+                "User-Agent": "sugra-api-mcp/0.1.0",
+                "Accept": "application/json",
+            },
+            timeout=config.timeout,
+        )
+
+    async def get(self, path: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+        clean_params = {k: v for k, v in (params or {}).items() if v is not None}
+        response = await self._client.get(path, params=clean_params)
+        return self._handle(response)
+
+    async def post(self, path: str, json: dict[str, Any] | None = None) -> dict[str, Any]:
+        response = await self._client.post(path, json=json or {})
+        return self._handle(response)
+
+    @staticmethod
+    def _handle(response: httpx.Response) -> dict[str, Any]:
+        try:
+            payload = response.json()
+        except ValueError:
+            payload = {"error": response.text[:500]}
+        if response.status_code >= 400:
+            error = payload.get("error") if isinstance(payload, dict) else str(payload)
+            return {
+                "error": error or f"HTTP {response.status_code}",
+                "status_code": response.status_code,
+                "url": str(response.request.url),
+            }
+        return payload
+
+    async def aclose(self) -> None:
+        await self._client.aclose()

sugra_api_mcp-0.1.0/sugra_api_mcp/config.py

@@ -0,0 +1,27 @@
+"""Configuration loading from environment variables."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Config:
+    api_base: str
+    api_key: str
+    timeout: float
+
+
+def load_config() -> Config:
+    api_key = os.environ.get("SUGRA_API_KEY", "").strip()
+    if not api_key:
+        raise RuntimeError(
+            "SUGRA_API_KEY environment variable is required. "
+            "Get one free at https://app.sugra.ai/settings/billing"
+        )
+    return Config(
+        api_base=os.environ.get("SUGRA_API_BASE", "https://sugra.ai").rstrip("/"),
+        api_key=api_key,
+        timeout=float(os.environ.get("SUGRA_TIMEOUT", "30")),
+    )