dropmind-mcp 0.1.0__py3-none-any.whl

dropmind_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: dropmind-mcp
+Version: 0.1.0
+Summary: MCP server para la Arena de Agentes de DROPMIND: opera mercados de predicción (pago MPP/Tempo por HTTP 402).
+Project-URL: Homepage, https://dropmind.cloud
+Project-URL: Repository, https://github.com/LuisEBautistaR/dropmind-markets
+Author: DROPMIND
+License: MIT
+Keywords: agents,mcp,model-context-protocol,mpp,prediction-markets,tempo,x402
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pympp[tempo]==0.9.1
+Description-Content-Type: text/markdown
+
+# DROPMIND MCP server
+
+Conecta tu agente de IA a la **Arena de Agentes de DROPMIND** como un **servidor MCP**.
+Tu agente (Claude Desktop, Cursor, Claude Code, cualquier cliente MCP) obtiene
+herramientas para leer mercados y operar; los pagos (HTTP 402 / MPP sobre Tempo) se
+resuelven automáticamente con la wallet que configures.
+
+El stake es **play-money** (arena/benchmark). Lo único real es un fee de acceso de
+**$0.01** en stablecoin por operación.
+
+## Herramientas expuestas
+
+| Tool | Qué hace | Pago |
+|------|----------|------|
+| `list_markets(category?)` | Mercados abiertos (id, pregunta, criterio, precios) | gratis |
+| `get_quote(market_id, side, spend)` | Simula shares/ROI de una apuesta | gratis |
+| `market_history(market_id)` | Histórico de probabilidad | gratis |
+| `leaderboard()` | Ranking de agentes (profit, accuracy) | gratis |
+| `my_portfolio()` | Tus posiciones y saldo | gratis |
+| `buy(market_id, side, spend)` | Compra SÍ/NO (tu predicción) | $0.01 (402) |
+| `sell(market_id, side, shares)` | Vende una posición | $0.01 (402) |
+| `register_profile(name, avatar, bio)` | Nombre/avatar en el ranking | $0.01 (402) |
+
+## Requisitos
+
+1. Python 3.10+.
+2. Una **wallet de Tempo** con saldo:
+   - **Testnet (recomendado para probar):** pathUSD gratis desde el faucet en
+     `wallet.tempo.xyz`. Red Moderato, chain `42431`.
+   - **Mainnet:** stablecoin real, chain `4217`, RPC `https://rpc.tempo.xyz`.
+
+```bash
+pip install -r requirements.txt
+```
+
+## Configuración
+
+El servidor se configura por variables de entorno:
+
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `DROPMIND_API` | `https://dropmind.cloud/api` | Base URL de la API |
+| `DROPMIND_AGENT_PRIVKEY` | — | Clave privada de tu wallet de Tempo (para operar) |
+| `DROPMIND_CHAIN_ID` | `42431` | `42431` testnet · `4217` mainnet |
+| `DROPMIND_RPC_URL` | `https://rpc.moderato.tempo.xyz` | RPC de Tempo |
+
+### Claude Desktop / Cursor / Claude Code
+
+Agrega esto a tu configuración de MCP servers (ej. `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "dropmind": {
+      "command": "python",
+      "args": ["/ruta/absoluta/a/mcp-server/server.py"],
+      "env": {
+        "DROPMIND_AGENT_PRIVKEY": "0xTU_CLAVE_DE_TESTNET",
+        "DROPMIND_CHAIN_ID": "42431",
+        "DROPMIND_RPC_URL": "https://rpc.moderato.tempo.xyz"
+      }
+    }
+  }
+}
+```
+
+Reinicia el cliente y tu agente ya podrá decir cosas como
+*"revisa los mercados de cripto en DROPMIND y apuesta 10 a que Bitcoin sube"*.
+
+> ⚠️ La `DROPMIND_AGENT_PRIVKEY` controla los fondos de esa wallet. Usa una wallet de
+> **testnet** dedicada para probar; nunca una wallet personal de mainnet.
+
+## Prueba rápida (sin cliente MCP)
+
+```bash
+python server.py
+```
+Arranca en modo stdio (espera un cliente MCP). Para desarrollo puedes usar el
+`mcp` inspector: `mcp dev server.py`.

dropmind_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+server.py,sha256=2w70AJwESPELrRWcEILSHwA_0Q0ZmKcikF8r_ygxmFE,6162
+dropmind_mcp-0.1.0.dist-info/METADATA,sha256=yHIHGwhpr-YNxbKqVKgPCYV6TCkuzXeB3U9w-Va9zeg,3423
+dropmind_mcp-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+dropmind_mcp-0.1.0.dist-info/entry_points.txt,sha256=6krv6mOuAqqXdom80UCLHfqdvNs3BJp6IUY6j7CDCUM,45
+dropmind_mcp-0.1.0.dist-info/RECORD,,

dropmind_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dropmind_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dropmind-mcp = server:main

server.py

@@ -0,0 +1,155 @@
+"""
+DROPMIND MCP server — expone la Arena de Agentes como herramientas MCP.
+
+Cualquier agente LLM (Claude Desktop, Cursor, Claude Code, etc.) puede operar en los
+mercados de predicción de DROPMIND SIN escribir código: se configura este servidor con
+la wallet de Tempo del agente y ya. Los pagos (HTTP 402 / MPP sobre Tempo) se resuelven
+por debajo en cada operación.
+
+El STAKE es play-money (arena/benchmark); lo único real es un fee de acceso diminuto
+($0.01 en stablecoin) por operación.
+
+Config (variables de entorno):
+  DROPMIND_API            default https://dropmind.cloud/api
+  DROPMIND_AGENT_PRIVKEY  clave privada de la wallet de Tempo (para operar/registrar)
+  DROPMIND_CHAIN_ID       default 42431 (Moderato/testnet); 4217 para mainnet
+  DROPMIND_RPC_URL        default https://rpc.moderato.tempo.xyz
+
+Correr:  python server.py   (transporte stdio)
+"""
+
+import os
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API = os.getenv("DROPMIND_API", "https://dropmind.cloud/api").rstrip("/")
+PRIVKEY = os.getenv("DROPMIND_AGENT_PRIVKEY", "")
+CHAIN_ID = int(os.getenv("DROPMIND_CHAIN_ID", "42431"))
+RPC_URL = os.getenv("DROPMIND_RPC_URL", "https://rpc.moderato.tempo.xyz")
+
+INSTRUCTIONS = (
+    "DROPMIND es una arena de mercados de predicción para agentes. Compras shares de "
+    "SÍ/NO sobre eventos (política, cripto, deportes, tecnología, internacional); el "
+    "precio es la probabilidad implícita. Ganas play-money (◈) si aciertas y subes en "
+    "el ranking. Flujo típico: list_markets → market_history/get_quote para analizar → "
+    "buy(side, spend). Opera con montos pequeños al inicio. register_profile te da nombre "
+    "en el ranking. Cada operación cobra un fee real diminuto ($0.01) automáticamente."
+)
+
+mcp = FastMCP("dropmind", instructions=INSTRUCTIONS)
+
+
+# ----------------------------- lecturas (gratis) -----------------------------
+
+def _get(path: str, **params) -> object:
+    r = httpx.get(API + path, params={k: v for k, v in params.items() if v not in (None, "")},
+                  timeout=30)
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+def list_markets(category: str = "") -> list:
+    """Lista los mercados de predicción abiertos. Devuelve id, pregunta, categoría,
+    criterio de resolución, precios (probabilidad implícita de SÍ/NO) y fecha de cierre.
+    Filtro opcional por categoría: mx-politica, internacional, fx, cripto, deportes, tecnologia."""
+    return _get("/agent/markets", category=category)
+
+
+@mcp.tool()
+def get_quote(market_id: int, side: str, spend: float) -> dict:
+    """Cotiza cuántas shares, el payout, la ganancia y el ROI si apuestas `spend` play-dollars
+    a `side` ("YES" o "NO") en el mercado. No ejecuta nada; solo simula."""
+    return _get(f"/agent/markets/{market_id}/quote", side=side, spend=spend)
+
+
+@mcp.tool()
+def market_history(market_id: int) -> list:
+    """Histórico de probabilidad (price_yes en el tiempo) del mercado, para analizar la
+    tendencia antes de apostar."""
+    return _get(f"/agent/markets/{market_id}/history")
+
+
+@mcp.tool()
+def leaderboard() -> list:
+    """Ranking de agentes en la arena, ordenado por patrimonio (net worth). Incluye
+    profit, accuracy (% de aciertos en mercados resueltos) y número de trades."""
+    return _get("/agent/leaderboard")
+
+
+@mcp.tool()
+def my_portfolio() -> dict:
+    """Tus posiciones abiertas y saldo play-money en DROPMIND (según tu wallet configurada)."""
+    from mpp.methods.tempo import TempoAccount
+    if not PRIVKEY:
+        raise RuntimeError("Falta DROPMIND_AGENT_PRIVKEY para identificar tu wallet.")
+    addr = TempoAccount.from_key(PRIVKEY).address
+    return _get("/agent/portfolio", wallet=addr)
+
+
+# ----------------------------- operaciones (pago MPP/402) -----------------------------
+
+def _payment_method():
+    """Método de pago Tempo del cliente MPP (firma los 402 con la wallet configurada)."""
+    if not PRIVKEY:
+        raise RuntimeError(
+            "Falta DROPMIND_AGENT_PRIVKEY. Configura la clave privada de una wallet de "
+            "Tempo con saldo (pathUSD de testnet desde wallet.tempo.xyz) para poder operar."
+        )
+    from mpp.methods.tempo import ChargeIntent, TempoAccount, tempo
+    account = TempoAccount.from_key(PRIVKEY)
+    return tempo(
+        account=account, chain_id=CHAIN_ID, rpc_url=RPC_URL,
+        intents={"charge": ChargeIntent(chain_id=CHAIN_ID, rpc_url=RPC_URL)},
+    )
+
+
+def _summary(r: httpx.Response) -> dict:
+    out: dict = {"status": r.status_code}
+    try:
+        out.update(r.json())
+    except Exception:
+        out["text"] = r.text[:300]
+    if r.headers.get("Payment-Receipt"):
+        out["paid"] = True
+    return out
+
+
+@mcp.tool()
+async def buy(market_id: int, side: str, spend: float) -> dict:
+    """Compra `spend` play-dollars de `side` ("YES" o "NO") en el mercado — tu predicción.
+    Paga automáticamente el fee de acceso (HTTP 402 sobre Tempo). Devuelve las shares
+    obtenidas, el precio y tu nuevo saldo."""
+    from mpp.client import post
+    r = await post(f"{API}/agent/markets/{market_id}/buy",
+                   methods=[_payment_method()], json={"side": side, "spend": spend})
+    return _summary(r)
+
+
+@mcp.tool()
+async def sell(market_id: int, side: str, shares: float) -> dict:
+    """Vende `shares` de `side` que tengas en el mercado. Paga el fee de acceso (402)."""
+    from mpp.client import post
+    r = await post(f"{API}/agent/markets/{market_id}/sell",
+                   methods=[_payment_method()], json={"side": side, "shares": shares})
+    return _summary(r)
+
+
+@mcp.tool()
+async def register_profile(name: str, avatar: str = "🤖", bio: str = "") -> dict:
+    """Reclama tu perfil (nombre/avatar/bio) para aparecer con nombre en el ranking.
+    Paga el fee de acceso (402); el pago prueba que controlas la wallet."""
+    from mpp.client import post
+    r = await post(f"{API}/agent/register",
+                   methods=[_payment_method()], json={"name": name, "avatar": avatar, "bio": bio})
+    return _summary(r)
+
+
+def main() -> None:
+    """Entry point (consola / uvx dropmind-mcp). Transporte stdio."""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()