minimalai-mcp 0.0.1__tar.gz

minimalai_mcp-0.0.1/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.env
+*.pem
+*.key
+explorer/dist/shot-*.png

minimalai_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.5
+Name: minimalai-mcp
+Version: 0.0.1
+Summary: MCP server for MINIMALAI: AI agents get Cocoon (Telegram/TON) inference and signed oracle verdicts through one key.
+Project-URL: Homepage, https://github.com/miinimal/cocoon-explorer
+Project-URL: Explorer, https://miinimal.github.io/cocoon-explorer/
+Author: Aleksandr Shcherbakov (@miinimal)
+License-Expression: MIT
+Keywords: ai-agents,cocoon,mcp,oracle,telegram,ton
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.2
+Description-Content-Type: text/markdown
+
+# minimalai-mcp
+
+MCP server for **MINIMALAI** — a gateway to [Cocoon](https://github.com/TelegramMessenger), the confidential AI compute network of Telegram and TON.
+
+Tools for AI agents:
+- `ask` — run a prompt on a model inside Cocoon (TEE)
+- `oracle` — signed yes/no verdict for TON smart contracts
+- `balance`, `models`
+
+## Install
+
+```
+pip install minimalai-mcp
+```
+
+Claude Desktop / any MCP client:
+
+```json
+{"mcpServers": {"minimalai": {"command": "minimalai-mcp",
+  "env": {"MINIMALAI_URL": "<gateway url>", "MINIMALAI_KEY": "<your key>"}}}}
+```
+
+Key and top-up (TON / Telegram Stars): Telegram bot [@miinimalai](https://t.me/miinimalai).
+Open map of the Cocoon network: https://miinimal.github.io/cocoon-explorer/
+
+Status: early access, gateway is being launched.

minimalai_mcp-0.0.1/README.md

@@ -0,0 +1,26 @@
+# minimalai-mcp
+
+MCP server for **MINIMALAI** — a gateway to [Cocoon](https://github.com/TelegramMessenger), the confidential AI compute network of Telegram and TON.
+
+Tools for AI agents:
+- `ask` — run a prompt on a model inside Cocoon (TEE)
+- `oracle` — signed yes/no verdict for TON smart contracts
+- `balance`, `models`
+
+## Install
+
+```
+pip install minimalai-mcp
+```
+
+Claude Desktop / any MCP client:
+
+```json
+{"mcpServers": {"minimalai": {"command": "minimalai-mcp",
+  "env": {"MINIMALAI_URL": "<gateway url>", "MINIMALAI_KEY": "<your key>"}}}}
+```
+
+Key and top-up (TON / Telegram Stars): Telegram bot [@miinimalai](https://t.me/miinimalai).
+Open map of the Cocoon network: https://miinimal.github.io/cocoon-explorer/
+
+Status: early access, gateway is being launched.

minimalai_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "minimalai-mcp"
+version = "0.0.1"
+description = "MCP server for MINIMALAI: AI agents get Cocoon (Telegram/TON) inference and signed oracle verdicts through one key."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Aleksandr Shcherbakov (@miinimal)" }]
+keywords = ["mcp", "cocoon", "ton", "telegram", "ai-agents", "oracle"]
+dependencies = ["mcp>=1.2,<2", "httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/miinimal/cocoon-explorer"
+Explorer = "https://miinimal.github.io/cocoon-explorer/"
+
+[project.scripts]
+minimalai-mcp = "minimalai_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/minimalai_mcp"]

minimalai_mcp-0.0.1/src/minimalai_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

minimalai_mcp-0.0.1/src/minimalai_mcp/server.py

@@ -0,0 +1,60 @@
+"""MINIMALAI MCP server: Cocoon inference and signed oracle verdicts for AI agents.
+Author: Aleksandr Shcherbakov (@miinimal) - MINIMALCULT.
+Env: MINIMALAI_URL (gateway base URL), MINIMALAI_KEY (access key from Telegram bot @miinimalai)."""
+import os
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("minimalai")
+
+
+def _cfg():
+    url = os.environ.get("MINIMALAI_URL", "").rstrip("/")
+    key = os.environ.get("MINIMALAI_KEY", "")
+    if not url or not key:
+        raise RuntimeError("Set MINIMALAI_URL and MINIMALAI_KEY (get a key in Telegram: @miinimalai)")
+    return url, {"Authorization": f"Bearer {key}"}
+
+
+def _call(method: str, path: str, payload=None) -> dict:
+    url, headers = _cfg()
+    with httpx.Client(timeout=120) as c:
+        r = c.request(method, url + path, headers=headers, json=payload)
+    if r.status_code == 402:
+        return {"error": "balance is empty", "top_up": "https://t.me/miinimalai"}
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+def ask(prompt: str, model: str = "Qwen/Qwen3-32B", max_tokens: int = 800) -> str:
+    """Ask a model running in the Cocoon confidential-compute network (Telegram/TON). Returns the answer text."""
+    d = _call("POST", "/v1/chat/completions",
+              {"model": model, "messages": [{"role": "user", "content": prompt}], "max_tokens": max_tokens})
+    return d["choices"][0]["message"]["content"] if "choices" in d else str(d)
+
+
+@mcp.tool()
+def oracle(question: str) -> dict:
+    """Get a signed yes/no verdict (majority of several confidential runs) usable by TON smart contracts."""
+    return _call("POST", "/v1/oracle/ask", {"question": question})
+
+
+@mcp.tool()
+def balance() -> dict:
+    """Show the balance and free requests left on the current key."""
+    return _call("GET", "/v1/balance")
+
+
+@mcp.tool()
+def models() -> dict:
+    """List models available through the gateway."""
+    return _call("GET", "/v1/models")
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()