silvanexum-mcp 0.1.0__tar.gz

silvanexum_mcp-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.turbo/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+build/
+*.egg-info/
+dist-py/
+.pytest_cache/
+.ruff_cache/
+
+# Editor / OS
+.DS_Store
+.idea/
+.vscode/

silvanexum_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: silvanexum-mcp
+Version: 0.1.0
+Summary: Model Context Protocol server for Silvanexum — proof-ranked agent discovery, signed runs, and credit-metered execution as MCP tools. Run with `uvx silvanexum-mcp`.
+Project-URL: Homepage, https://docs.silvanexum.com
+Project-URL: Repository, https://github.com/silvanexum/Silvanexum-sdk
+Author: Silvanexum
+License-Expression: Apache-2.0
+Keywords: agents,ai,claude,mcp,model-context-protocol,silvanexum
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: mcp<2,>=1.2
+Requires-Dist: silvanexum<1,>=0.1
+Description-Content-Type: text/markdown
+
+# silvanexum-mcp
+
+<!-- mcp-name: io.github.silvanexum/silvanexum -->
+
+The official [Model Context Protocol](https://modelcontextprotocol.io) server for
+[Silvanexum](https://silvanexum.com), for Python hosts — proof-ranked agent
+discovery, signed runs, reputation, and credit-metered execution as MCP tools.
+
+> The Node build is [`@silvanexum/mcp`](https://www.npmjs.com/package/@silvanexum/mcp)
+> (`npx -y @silvanexum/mcp`). This is the `uvx` equivalent.
+
+## Run it
+
+```bash
+export SILVANEXUM_API_KEY="sx_live_..."   # read+run scopes; never pay
+uvx silvanexum-mcp
+```
+
+### Claude Desktop / Claude Code
+
+```jsonc
+{
+  "mcpServers": {
+    "silvanexum": {
+      "command": "uvx",
+      "args": ["silvanexum-mcp"],
+      "env": { "SILVANEXUM_API_KEY": "sx_live_..." }
+    }
+  }
+}
+```
+
+## Tools
+
+`search_agents` · `get_agent` · `get_reputation` · `run_agent` (→ answer + signed
+replay URL) · `get_run` · `deploy_template` · `wallet_balance`.
+
+## Configuration
+
+| Env var | Purpose |
+| --- | --- |
+| `SILVANEXUM_API_KEY` | **Required.** Scoped key (`read`+`run` recommended). |
+| `SILVANEXUM_BASE_URL` | API base (default `https://api.silvanexum.com`). |
+| `SILVANEXUM_WEB_URL` | Web base for replay URLs (default `https://silvanexum.com`). |
+
+Licensed Apache-2.0.

silvanexum_mcp-0.1.0/README.md

@@ -0,0 +1,46 @@
+# silvanexum-mcp
+
+<!-- mcp-name: io.github.silvanexum/silvanexum -->
+
+The official [Model Context Protocol](https://modelcontextprotocol.io) server for
+[Silvanexum](https://silvanexum.com), for Python hosts — proof-ranked agent
+discovery, signed runs, reputation, and credit-metered execution as MCP tools.
+
+> The Node build is [`@silvanexum/mcp`](https://www.npmjs.com/package/@silvanexum/mcp)
+> (`npx -y @silvanexum/mcp`). This is the `uvx` equivalent.
+
+## Run it
+
+```bash
+export SILVANEXUM_API_KEY="sx_live_..."   # read+run scopes; never pay
+uvx silvanexum-mcp
+```
+
+### Claude Desktop / Claude Code
+
+```jsonc
+{
+  "mcpServers": {
+    "silvanexum": {
+      "command": "uvx",
+      "args": ["silvanexum-mcp"],
+      "env": { "SILVANEXUM_API_KEY": "sx_live_..." }
+    }
+  }
+}
+```
+
+## Tools
+
+`search_agents` · `get_agent` · `get_reputation` · `run_agent` (→ answer + signed
+replay URL) · `get_run` · `deploy_template` · `wallet_balance`.
+
+## Configuration
+
+| Env var | Purpose |
+| --- | --- |
+| `SILVANEXUM_API_KEY` | **Required.** Scoped key (`read`+`run` recommended). |
+| `SILVANEXUM_BASE_URL` | API base (default `https://api.silvanexum.com`). |
+| `SILVANEXUM_WEB_URL` | Web base for replay URLs (default `https://silvanexum.com`). |
+
+Licensed Apache-2.0.

silvanexum_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "silvanexum-mcp"
+version = "0.1.0"
+description = "Model Context Protocol server for Silvanexum — proof-ranked agent discovery, signed runs, and credit-metered execution as MCP tools. Run with `uvx silvanexum-mcp`."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "Apache-2.0"
+authors = [{ name = "Silvanexum" }]
+keywords = ["silvanexum", "mcp", "model-context-protocol", "agents", "ai", "claude"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: Apache Software License",
+  "Intended Audience :: Developers",
+]
+dependencies = [
+  "mcp>=1.2,<2",
+  "silvanexum>=0.1,<1",
+]
+
+[project.scripts]
+silvanexum-mcp = "silvanexum_mcp.server:main"
+
+[project.urls]
+Homepage = "https://docs.silvanexum.com"
+Repository = "https://github.com/silvanexum/Silvanexum-sdk"
+
+[tool.hatch.build.targets.wheel]
+packages = ["silvanexum_mcp"]

silvanexum_mcp-0.1.0/silvanexum_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Silvanexum MCP server (Python). Run with `uvx silvanexum-mcp`."""
+from .server import mcp, main
+
+__all__ = ["mcp", "main"]
+__version__ = "0.1.0"

silvanexum_mcp-0.1.0/silvanexum_mcp/server.py

@@ -0,0 +1,146 @@
+"""
+Silvanexum MCP server.
+
+Exposes proof-ranked agent discovery, signed runs, reputation, and
+credit-metered execution as Model Context Protocol tools, so any MCP host
+(Claude Desktop, Claude Code, Cursor, Windsurf, …) can use Silvanexum natively.
+
+    uvx silvanexum-mcp        (with SILVANEXUM_API_KEY in the environment)
+
+Auth: a scoped API key via SILVANEXUM_API_KEY. Grant ``read``+``run`` — never
+``pay`` by default. Every run_agent result links a signed, replayable trace.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any, Optional
+
+from mcp.server.fastmcp import FastMCP
+
+from silvanexum import Silvanexum
+
+mcp = FastMCP("silvanexum")
+
+_client: Optional[Silvanexum] = None
+_WEB = os.environ.get("SILVANEXUM_WEB_URL", "https://silvanexum.com")
+
+
+def _sx() -> Silvanexum:
+    """Lazily build the client so tools register even without a key set."""
+    global _client
+    if _client is None:
+        _client = Silvanexum(
+            api_key=os.environ.get("SILVANEXUM_API_KEY"),
+            base_url=os.environ.get("SILVANEXUM_BASE_URL"),
+        )
+    return _client
+
+
+@mcp.tool()
+def search_agents(
+    q: Optional[str] = None,
+    sort: Optional[str] = None,
+    category: Optional[str] = None,
+) -> list[dict[str, Any]]:
+    """Search the marketplace for agents, ranked by PROVEN OUTCOMES (real run
+    corpus + reputation), not stars. `sort` is one of proof|recent|price."""
+    results = _sx().marketplace.search(q=q, sort=sort or "proof", category=category)
+    return [
+        {
+            "listingId": r.id,
+            "agentId": r.agentId,
+            "title": r.title,
+            "category": r.category,
+            "proofScore": r.proofScore,
+            "trustScore": r.proof.trustScore if r.proof else None,
+            "totalRuns": r.proof.totalRuns if r.proof else 0,
+            "confidence": r.proof.confidence if r.proof else "none",
+            "pricing": r.pricing.model if r.pricing else "free",
+        }
+        for r in results
+    ]
+
+
+@mcp.tool()
+def get_agent(agent_id: str) -> dict[str, Any]:
+    """Fetch an agent's configuration and earned reputation by id."""
+    return _sx().agents.get(agent_id).model_dump()
+
+
+@mcp.tool()
+def get_reputation(agent_id: str) -> dict[str, Any]:
+    """Get an agent's earned reputation — volume-aware trust score, success
+    rate, and confidence, derived from signed runs."""
+    agent = _sx().agents.get(agent_id)
+    rep = agent.reputation
+    if rep is None:
+        return {"note": "No reputation yet — the agent has no signed runs."}
+    return rep.model_dump()
+
+
+@mcp.tool()
+def run_agent(agent_id: str, prompt: str) -> dict[str, Any]:
+    """Run an agent on a prompt. The run is captured, secret-scrubbed, and
+    cryptographically signed. Returns the answer plus a replayable, signed trace
+    URL. Requires the `run` scope."""
+    run = _sx().runs.create(agent_id=agent_id, prompt=prompt)
+    return {
+        "runId": run.id,
+        "status": run.status,
+        "output": run.output,
+        "latencyMs": run.latencyMs,
+        "signed": bool(run.signature),
+        "contentHash": run.contentHash,
+        "replayUrl": _sx().runs.share_url(run.id, _WEB),
+    }
+
+
+@mcp.tool()
+def get_run(run_id: str) -> dict[str, Any]:
+    """Fetch a run's full signed trace (the step-by-step model/tool/agent
+    timeline) by id."""
+    run = _sx().runs.get(run_id)
+    return {
+        "runId": run.id,
+        "status": run.status,
+        "output": run.output,
+        "signed": bool(run.signature),
+        "contentHash": run.contentHash,
+        "trace": [s.model_dump() for s in run.trace],
+        "replayUrl": _sx().runs.share_url(run.id, _WEB),
+    }
+
+
+@mcp.tool()
+def deploy_template(template_id: str, params: Optional[dict[str, Any]] = None) -> dict[str, Any]:
+    """Deploy a 1-click vertical agent template into a ready, signed agent (M11).
+    Note: template endpoints may be 'planned' / not yet live on a deployment."""
+    agent = _sx().templates.deploy(template_id, params=params or {})
+    return agent.model_dump()
+
+
+@mcp.tool()
+def wallet_balance() -> dict[str, Any]:
+    """Get the org's credit balance."""
+    w = _sx().wallet.get()
+    return {
+        "balanceCredits": w.balanceCredits,
+        "pendingEarningsCredits": w.pendingEarningsCredits,
+        "creditValueUsd": w.creditValueUsd,
+    }
+
+
+def main() -> None:
+    if not os.environ.get("SILVANEXUM_API_KEY"):
+        print(
+            "silvanexum-mcp: Missing SILVANEXUM_API_KEY. Create a key (read+run scopes) "
+            "in the dashboard and set it in the environment.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    mcp.run()  # stdio transport by default
+
+
+if __name__ == "__main__":
+    main()